libcmo21/LibCmo/CK2/MgrImpls/CKBaseManager.hpp

107 lines
3.3 KiB
C++
Raw Normal View History

2023-02-26 21:48:03 +08:00
#pragma once
2023-08-25 17:35:45 +08:00
#include "../../VTAll.hpp"
2023-02-26 21:48:03 +08:00
namespace LibCmo::CK2::MgrImpls {
2023-02-26 21:48:03 +08:00
2023-08-25 17:35:45 +08:00
/**
@brief Base Class for managers.
@remark
+ This class provides virtual methods that can be override by any managers. Any manager that inherits from CKBaseManager can override function to do some processing.
+ The instances of managers may be retrieved through the global function CKContext::GetManagerByGuid()
+ Some default managers implemented in Virtools can be accessed directly: See Managers Access
*/
2023-02-26 21:48:03 +08:00
class CKBaseManager {
public:
2023-08-25 17:35:45 +08:00
CKBaseManager(CKContext* ctx, CKGUID guid, CKSTRING name) :
m_ManagerGuid(guid),
m_ManagerName(name),
m_Context(ctx)
{}
virtual ~CKBaseManager() {}
LIBCMO_DISABLE_COPY_MOVE(CKBaseManager);
2023-02-26 21:48:03 +08:00
2023-08-25 17:35:45 +08:00
/**
@brief Acces to Manager GUID
@return CKGUID of this manager.
@remark
+ Each Manager is given an unique GUID. When creating a new manager it should
assign itself a GUID and name before registering itsef.
```
CKAttributeManager::CKAttributeManager(CKContext *Context) : CKBaseManager(Context, ATTRIBUTE_MANAGER_GUID, "Attribute Manager")
{
// ....
// ....
Context->RegisterNewManager(this);
}
```
@see CKContext::RegisterNewManager, GetName
*/
CKGUID GetGuid() {
return m_ManagerGuid;
}
/**
@brief Acces to Manager name
@return Name of this manager.
@remark
+ Each Manager is given an unique GUID. When creating a new manager it should
assign itself a GUID and name before registering itsef.
```
CKAttributeManager::CKAttributeManager(CKContext *Context) : CKBaseManager(Context, ATTRIBUTE_MANAGER_GUID, "Attribute Manager")
{
// ....
// ....
Context->RegisterNewManager(this);
}
```
*/
CKSTRING GetName() {
return m_ManagerName.c_str();
}
2023-02-27 22:23:05 +08:00
2023-08-25 17:35:45 +08:00
/**
@brief Called to save manager data.
@param SavedFile A pointer to the CKFile being saved.
@return This function should return a valid CKStateChunk that contain data to save or NULL if there is nothing to save.
@remark
+ During a save operation, each manager is given the opportunity to save its data in the file.
+ The file being saved is given for information only and must not be modified. It can be used to decide whether it is worth saving
data for your manager.
@see CKStateChunk, LoadData
*/
2023-08-25 21:57:22 +08:00
virtual CKStateChunk* SaveData(CKFileVisitor* SavedFile) {
2023-08-25 17:35:45 +08:00
return nullptr;
}
/**
@brief Called to load manager data.
@param chunk A pointer to a CKStateChunk that was saved in the file.
@param LoadedFile A pointer to the CKFile being loaded.
@return CK_OK if successful or an error code otherwise.
@remark
+ During a load operation, each manager is automatically called if there was a chunk saved in the file with SaveData.
@see CKStateChunk, SaveData
*/
2023-08-25 21:57:22 +08:00
virtual CKERROR LoadData(CKStateChunk* chunk, CKFileVisitor* LoadedFile) {
2023-08-25 17:35:45 +08:00
return CKERROR::CKERR_OK;
}
protected:
CKGUID m_ManagerGuid; ///> Manager GUID
TypeHelper::MKString m_ManagerName; ///> Manager Name
CKContext* m_Context; ///> A pointer to the CKContext on which this manager is valid.
2023-02-26 21:48:03 +08:00
};
2023-08-25 17:35:45 +08:00
//class CKAttributeManager : public CKBaseManager {
//public:
// CKAttributeManager(CKContext* ctx, CK_ID ckid);
// CKAttributeManager(const CKAttributeManager&) = delete;
// CKAttributeManager& operator=(const CKAttributeManager&) = delete;
// virtual ~CKAttributeManager();
2023-02-26 21:48:03 +08:00
2023-08-25 17:35:45 +08:00
//private:
2023-02-26 21:48:03 +08:00
2023-08-25 17:35:45 +08:00
//};
2023-02-26 21:48:03 +08:00
}