SimsWorld/SimsBasic/simsbasic.h

205 lines
5.1 KiB
C
Raw Normal View History

2025-05-25 04:43:37 +00:00
#pragma once
#include "simsbasic_global.h"
#include <QJsonObject>
#include <memory>
#include <functional>
/// <summary>
/// <20><><EFBFBD><EFBFBD><EFBFBD>л<EFBFBD><D0BB><EFBFBD><EFBFBD><EFBFBD>
/// </summary>
class Serializable {
public:
virtual ~Serializable() = default;
/// <summary>
/// ͨ<><CDA8><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>л<EFBFBD><D0BB><EFBFBD>ȫ<EFBFBD>ָ<EFBFBD><D6B8><EFBFBD><EFBFBD><EFBFBD>
/// </summary>
/// <param name="obj"><3E><><EFBFBD><EFBFBD>Json</param>
virtual void recoveryFrom(const QJsonObject& obj) = 0;
/// <summary>
/// ͨ<><CDA8><EFBFBD><EFBFBD><EFBFBD>л<EFBFBD><D0BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
/// </summary>
/// <param name="obj">Ŀ<><C4BF>Json</param>
virtual void saveTo(QJsonObject& obj) const = 0;
};
/// <summary>
/// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><ECB3A3><EFBFBD><EFBFBD>
/// </summary>
class SIMSBASIC_EXPORT UniException {
private:
QString _error_store;
public:
explicit UniException(const QString& msg);
virtual ~UniException() = default;
virtual QString content() const noexcept;
};
/// <summary>
/// ͨ<><CDA8><EFBFBD><EFBFBD>Ϣ<EFBFBD><CFA2><EFBFBD><EFBFBD>
/// </summary>
class WsMessage : public Serializable {
public:
virtual ~WsMessage() = default;
/// <summary>
/// <20><>ȡ<EFBFBD><C8A1>Ϣ<EFBFBD><CFA2><EFBFBD><EFBFBD><EFBFBD>ַ<EFBFBD><D6B7><EFBFBD>
/// </summary>
/// <returns><3E><>Ϣ<EFBFBD><CFA2><EFBFBD><EFBFBD></returns>
virtual QString topicString() const = 0;
/// <summary>
/// Ŀ<><C4BF>ʵ<EFBFBD><CAB5>ID
/// </summary>
/// <returns>ID</returns>
virtual uint64_t targetEntity() const = 0;
/// <summary>
/// <20><>Դʵ<D4B4><CAB5>ID
/// </summary>
/// <returns>ID</returns>
virtual uint64_t sourceEntity() const = 0;
};
/// <summary>
/// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ϣ<EFBFBD><CFA2><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ԫͨ<D4AA>ýӿ<C3BD>
/// </summary>
2025-05-31 04:18:43 +00:00
using WsRespondEntry = std::function<void(std::shared_ptr<const WsMessage>, std::shared_ptr<WsMessage>&)>;
2025-05-25 04:43:37 +00:00
/// <summary>
/// Respondǩ<64><C7A9><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
/// </summary>
using WsRespondSignatureType = std::pair<QString, QString>;
/// <summary>
/// <20><><EFBFBD>ܲ<EFBFBD><DCB2><EFBFBD><EFBFBD>Ļ<EFBFBD><C4BB><EFBFBD>
/// </summary>
class WsComponent : public Serializable, public std::enable_shared_from_this<WsComponent> {
public:
virtual ~WsComponent() = default;
/// <summary>
/// <20><>¡һ<C2A1><D2BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ͬ<EFBFBD><CDAC><EFBFBD>ݵ<EFBFBD>ʵ<EFBFBD><CAB5>
/// </summary>
/// <returns>ʵ<><CAB5>ָ<EFBFBD><D6B8></returns>
virtual std::shared_ptr<WsComponent> defaultNew() const = 0;
/// <summary>
/// <20><><EFBFBD><EFBFBD>Entity
/// </summary>
/// <param name="entity_id">EntityID</param>
virtual void bindEntity(uint64_t entity_id) = 0;
/// <summary>
/// <20><><EFBFBD><EFBFBD>Ψһ<CEA8><D2BB><EFBFBD><EFBFBD>
/// </summary>
/// <returns><3E><><EFBFBD><EFBFBD><EFBFBD><EFBFBD></returns>
virtual QString name() const = 0;
/// <summary>
/// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ϣ<EFBFBD><CFA2><EFBFBD><EFBFBD>
/// </summary>
/// <returns><3E><>Ϣ<EFBFBD><CFA2><EFBFBD>ͼ<EFBFBD><CDBC><EFBFBD></returns>
virtual QList<QString> inputTypes() const = 0;
/// <summary>
/// ͨ<><CDA8>ָ<EFBFBD><D6B8><EFBFBD><EFBFBD>ǩ<EFBFBD><C7A9><EFBFBD><EFBFBD>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
/// </summary>
/// <param name="t"><3E><><EFBFBD><EFBFBD>ǩ<EFBFBD><C7A9></param>
/// <returns><3E><><EFBFBD><EFBFBD><EFBFBD>ӿ<EFBFBD></returns>
2025-05-31 04:18:43 +00:00
virtual QList<WsRespondEntry> getEntryWithSignature(const WsRespondSignatureType& t) const = 0;
2025-05-25 04:43:37 +00:00
/// <summary>
/// ͨ<><CDA8><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ϣ<EFBFBD><CFA2><EFBFBD>ͻ<EFBFBD>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
/// </summary>
/// <param name="msg_type"><3E><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ϣ<EFBFBD><CFA2><EFBFBD><EFBFBD></param>
/// <returns><3E><><EFBFBD><EFBFBD><EFBFBD>ӿ<EFBFBD><D3BF>б<EFBFBD></returns>
virtual QList<WsRespondEntry> getEntrysWithInType(const QString& msg_type) const = 0;
};
#include <QHash>
/// <summary>
/// <20>ڴ<EFBFBD>ʵ<EFBFBD><CAB5>ʵ<EFBFBD><CAB5><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
/// </summary>
class SIMSBASIC_EXPORT WsEntity : public Serializable, public std::enable_shared_from_this<WsEntity> {
private:
uint64_t _entity_id = 0;
QString _templet_name, _runtime_name;
QHash<QString, std::shared_ptr<WsComponent>> _comps_list;
public:
explicit WsEntity();
virtual ~WsEntity() = default;
/// <summary>
/// <20><><EFBFBD>ñ<EFBFBD>ʵ<EFBFBD><CAB5>ģ<EFBFBD><C4A3><EFBFBD><EFBFBD>
/// </summary>
/// <param name="name">ģ<><C4A3><EFBFBD><EFBFBD><EFBFBD><EFBFBD></param>
virtual void resetTemplet(const QString& name);
/// <summary>
/// <20><>ȡ<EFBFBD><C8A1>ʵ<EFBFBD><CAB5><EFBFBD><EFBFBD>ģ<EFBFBD><C4A3><EFBFBD><EFBFBD>
/// </summary>
/// <returns>ģ<><C4A3><EFBFBD><EFBFBD><EFBFBD><EFBFBD></returns>
virtual QString templetName() const;
/// <summary>
/// <20><><EFBFBD>ñ<EFBFBD>ʵ<EFBFBD><CAB5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ID
/// </summary>
/// <param name="id"></param>
virtual void resetID(uint64_t id);
/// <summary>
/// <20><>ȡ<EFBFBD><C8A1>ʵ<EFBFBD><CAB5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ID
/// </summary>
/// <returns></returns>
virtual uint64_t entityID() const;
/// <summary>
/// <20><><EFBFBD>ñ<EFBFBD>ʵ<EFBFBD><CAB5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
/// </summary>
/// <param name="name"></param>
virtual void resetName(const QString& name);
/// <summary>
/// <20><>ȡ<EFBFBD><C8A1>ʵ<EFBFBD><CAB5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
/// </summary>
/// <returns><3E><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD></returns>
virtual QString name() const;
/// <summary>
/// Ϊ<><CEAA>ʵ<EFBFBD><CAB5><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ָ<EFBFBD><D6B8><EFBFBD><EFBFBD><EFBFBD>͵IJ<CDB5><C4B2><EFBFBD>
/// </summary>
/// <param name="ins"></param>
virtual void append(std::shared_ptr<WsComponent> ins);
/// <summary>
/// <20>Ƴ<EFBFBD>ָ<EFBFBD><D6B8><EFBFBD><EFBFBD><EFBFBD>͵IJ<CDB5><C4B2><EFBFBD>ʵ<EFBFBD><CAB5>
/// </summary>
/// <param name="component_type"></param>
virtual void remove(const QString& component_type);
/// <summary>
/// <20><>ȡ<EFBFBD><C8A1>ʵ<EFBFBD><CAB5><EFBFBD>ڰ<EFBFBD><DAB0><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>в<EFBFBD><D0B2><EFBFBD>ʵ<EFBFBD><CAB5>
/// </summary>
/// <returns></returns>
virtual QList<std::shared_ptr<WsComponent>> components() const;
/// <summary>
/// <20><><EFBFBD>ȿ<EFBFBD>¡<EFBFBD><C2A1>ʵ<EFBFBD><CAB5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>һ<EFBFBD><D2BB>
/// </summary>
/// <returns></returns>
virtual std::shared_ptr<WsEntity> defaultNew() const;
/// <summary>
/// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ϣ<EFBFBD><CFA2><EFBFBD><EFBFBD>
/// </summary>
/// <returns><3E><>Ϣ<EFBFBD><CFA2><EFBFBD>ͼ<EFBFBD><CDBC><EFBFBD></returns>
virtual QList<QString> inputTypes() const;
/// <summary>
/// ͨ<><CDA8>ָ<EFBFBD><D6B8><EFBFBD><EFBFBD>ǩ<EFBFBD><C7A9><EFBFBD><EFBFBD>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
/// </summary>
/// <param name="t">ǩ<><C7A9></param>
/// <returns><3E><><EFBFBD><EFBFBD><EFBFBD>ӿ<EFBFBD></returns>
virtual QList<WsRespondEntry> getEntryWithSignature(const WsRespondSignatureType& t) const;
/// <summary>
/// ͨ<><CDA8><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ϣ<EFBFBD><CFA2><EFBFBD>ͻ<EFBFBD>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
/// </summary>
/// <param name="msg_type"><3E><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ϣ<EFBFBD><CFA2><EFBFBD><EFBFBD></param>
/// <returns><3E><><EFBFBD><EFBFBD><EFBFBD>ӿ<EFBFBD><D3BF>б<EFBFBD></returns>
virtual QList<WsRespondEntry> getEntryWithInType(const QString& msg_type) const;
// ͨ<><CDA8> Serializable <20>̳<EFBFBD>
void recoveryFrom(const QJsonObject& obj) override;
void saveTo(QJsonObject& obj) const override;
};