Snapshot.hpp

浏览该文件的文档.

#pragma once
 
#include "common/Export.h"
#include "common/StateValue.h"
 
#include <string>
#include <unordered_set>
#include <vector>
 
struct SQVM;
typedef struct SQVM* HSQUIRRELVM;
 
namespace eve::dev {
 
class EVENGINE_API_FOUNDATION Snapshot {
public:
    static Snapshot& instance();
 
    Snapshot(const Snapshot&)            = delete;
    Snapshot& operator=(const Snapshot&) = delete;
 
    void markRoot(std::string name);
    void unmarkRoot(const std::string& name);
    void markTransientRoot(std::string name);
    void unmarkTransientRoot(const std::string& name);
    void clearRoots();
    std::vector<std::string> roots() const;
    std::vector<std::string> transientRoots() const;
 
    void setRootPolicies(std::vector<std::string> persistent, std::vector<std::string> transient);
 
    std::string capture(HSQUIRRELVM vm, std::string* error = nullptr) const;
    bool        restore(HSQUIRRELVM vm, const std::string& json, std::string* error = nullptr) const;
 
    bool saveFile(HSQUIRRELVM vm, const std::string& path, std::string* error = nullptr) const;
    bool loadFile(HSQUIRRELVM vm, const std::string& path, std::string* error = nullptr) const;
 
    std::vector<std::string> rootsFor(HSQUIRRELVM vm) const { return resolveRoots(vm); }
 
    bool captureState(HSQUIRRELVM vm, StateValue& out, std::string* error = nullptr) const;
 
    bool restoreState(HSQUIRRELVM vm, const StateValue& state, std::string* error = nullptr) const;
 
    static bool isEngineBinding(const std::string& name);
 
private:
    Snapshot() = default;
 
    std::vector<std::string> resolveRoots(HSQUIRRELVM vm) const;
 
    mutable std::vector<std::string> marked_;
    mutable std::vector<std::string> transient_;
};
 
}  // namespace eve::dev