nmWTAI-Platform/Include/nmNum/nmData/nmPebiResultSnapshotSerializer.h

#ifndef NMPEBIRESULTSNAPSHOTSERIALIZER_H
#define NMPEBIRESULTSNAPSHOTSERIALIZER_H

#include "nmData_global.h"
#include "nmNumericalResultPersistence.h"

#include <QSharedPointer>
#include <QString>

class nmPebiResultSnapshot;

/**
 * @brief 负责 v4 快照三文件载荷及 Snapshot.json 的流式保存和加载。
 *
 * 序列化器是快照的受限友元，只在保存时读取内部 VTK 对象；加载仍通过
 * nmPebiResultSnapshotBuilder 构造和封闭候选。
 */
class NM_DATA_EXPORT nmPebiResultSnapshotSerializer
{
public:
    /** @brief 将完整快照写入窗口目录下的 Snapshot 子目录。 */
    static bool save(
            const QSharedPointer<const nmPebiResultSnapshot>& pSnapshot,
            const QString& sWindowDirectory,
            nmNumericalFileReference& oSnapshotJsonReference,
            QString* pError = NULL);

    /** @brief 校验 Snapshot.json 及其三条引用，不创建快照对象。 */
    static bool validate(
            const QString& sWindowDirectory,
            const nmNumericalFileReference& oSnapshotJsonReference,
            QString* pError = NULL);

    /** @brief 完整读取并通过 Builder 返回尚未发布的可写候选。 */
    static bool load(
            const QString& sWindowDirectory,
            const nmNumericalFileReference& oSnapshotJsonReference,
            QSharedPointer<nmPebiResultSnapshot>& pCandidate,
            QString* pError = NULL);

private:
    /** @brief 从快照内部数组流式写出全部压力帧。 */
    static bool writePressureFrames(const nmPebiResultSnapshot& oSnapshot,
                                    const QString& sFilePath,
                                    QString* pError);
    /** @brief 从快照内部井目录流式写出六组冻结曲线。 */
    static bool writeWellCurves(const nmPebiResultSnapshot& oSnapshot,
                                const QString& sFilePath,
                                QString* pError);
    /** @brief 禁止实例化纯静态序列化器。 */
    nmPebiResultSnapshotSerializer();
};

#endif // NMPEBIRESULTSNAPSHOTSERIALIZER_H