34 lines
1.1 KiB
C++
34 lines
1.1 KiB
C++
#pragma once
|
|
|
|
#include <QString>
|
|
|
|
class QDataStream;
|
|
|
|
namespace core {
|
|
|
|
// 二进制记录的统一持久化基类：魔数/版本、QDataStream 版本、.tmp 原子替换、父目录创建。
|
|
//
|
|
// 领域类型（如 Project::Entity）应保持为可拷贝的值类型，不要继承本类；为每种存储格式写一个
|
|
// 小的适配器类（如 EntityBinaryRecord）继承本类并实现 writeBody/readBody 即可。
|
|
class PersistentBinaryObject {
|
|
public:
|
|
virtual ~PersistentBinaryObject() = default;
|
|
|
|
[[nodiscard]] bool saveToFile(const QString& absolutePath) const;
|
|
[[nodiscard]] bool loadFromFile(const QString& absolutePath);
|
|
|
|
protected:
|
|
virtual quint32 recordMagic() const = 0;
|
|
virtual quint32 recordFormatVersion() const = 0;
|
|
virtual void writeBody(QDataStream& ds) const = 0;
|
|
virtual bool readBody(QDataStream& ds) = 0;
|
|
|
|
/// 读取文件时解析到的版本号（<= recordFormatVersion）。用于向后兼容读取分支。
|
|
[[nodiscard]] quint32 loadedRecordFormatVersion() const { return m_loadedVersion; }
|
|
|
|
private:
|
|
quint32 m_loadedVersion = 0;
|
|
};
|
|
|
|
} // namespace core
|