RPGSaveSession.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include "common/Result.h"
 
#include <map>
#include <set>
#include <string>
#include <string_view>
 
namespace eve::inventory {
class Bag;
class EquipmentSet;
}
 
namespace eve::rpg {
 
class GameState;
class Tracker;
class RPGActor;
class Party;
 
enum class RPGSaveIdDomain {
    Item,           
    Quest,          
    QuestObjective, 
    Skill,          
    Class,          
    Trait,          
    TraitSource,    
    EquipmentSlot,  
};
 
class EVENGINE_API_PLATFORM RPGSaveSession {
public:
    RPGSaveSession() = default;
 
    void bind(GameState &gameState, Tracker &tracker, RPGActor &actor, inventory::Bag &bag,
              inventory::EquipmentSet &equipment) noexcept;
 
    void bindParty(GameState &gameState, Tracker &tracker, Party &party, inventory::Bag &bag,
                   inventory::EquipmentSet &equipment) noexcept;
 
    [[nodiscard]] eve::Result<void> setContentVersion(std::string_view contentVersion);
 
    std::string getContentVersion() const { return contentVersion_; }
 
    [[nodiscard]] eve::Result<void> allowCompatibleContentVersion(std::string_view contentVersion);
 
    [[nodiscard]] eve::Result<void> addIdRenameMigration(std::string_view fromContentVersion,
                                                         RPGSaveIdDomain domain, std::string_view oldId,
                                                         std::string_view newId);
 
    [[nodiscard]] eve::Result<void> addQuestAdditionMigration(std::string_view fromContentVersion,
                                                               std::string_view questId);
 
    [[nodiscard]] eve::Result<void> allowSingleActorPartyMigration(
        std::string_view fromContentVersion);
 
    [[nodiscard]] eve::Result<std::string> snapshotJson() const;
 
    [[nodiscard]] eve::Result<void> validateSnapshotJson(std::string_view json);
 
    [[nodiscard]] eve::Result<void> restoreSnapshotJson(std::string_view json);
 
private:
    struct MigrationKey {
        std::string fromContentVersion;
        RPGSaveIdDomain domain = RPGSaveIdDomain::Item;
        std::string oldId;
 
        friend bool operator<(const MigrationKey &left, const MigrationKey &right) noexcept {
            if (left.fromContentVersion != right.fromContentVersion)
                return left.fromContentVersion < right.fromContentVersion;
            if (left.domain != right.domain) return left.domain < right.domain;
            return left.oldId < right.oldId;
        }
    };
 
    [[nodiscard]] eve::Result<void> restoreSnapshotJsonImpl(std::string_view json, bool publish);
 
    GameState *gameState_ = nullptr;
    Tracker *tracker_ = nullptr;
    RPGActor *actor_ = nullptr;
    Party *party_ = nullptr;
    inventory::Bag *bag_ = nullptr;
    inventory::EquipmentSet *equipment_ = nullptr;
    std::string contentVersion_;
    std::set<std::string> compatibleContentVersions_;
    std::map<MigrationKey, std::string> idRenameMigrations_;
    std::map<std::string, std::set<std::string>> questAdditionMigrations_;
    std::set<std::string> singleActorPartyMigrations_;
};
 
}  // namespace eve::rpg