SimsWorld/SimsBasic/simsbasic.h

223 lines
5.7 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>
/// Respondǩ<64><C7A9><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
/// </summary>
using WsRespondSignatureType = std::pair<QString, QString>;
2025-06-07 15:58:50 +00:00
/// <summary>
/// ʵ<><CAB5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ִ<EFBFBD><D6B4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
/// </summary>
2025-06-10 04:41:33 +00:00
class Immediate {
2025-06-07 15:58:50 +00:00
public:
2025-06-10 04:41:33 +00:00
virtual ~Immediate() = default;
2025-06-07 15:58:50 +00:00
/// <summary>
/// <20><>ȡʵ<C8A1><CAB5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>id
/// </summary>
/// <returns></returns>
virtual uint64_t entityManagerID() const = 0;
/// <summary>
2025-06-12 00:04:17 +00:00
/// <20><>ȡ<EFBFBD><C8A1>Դ<EFBFBD><D4B4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>id
/// </summary>
/// <returns></returns>
virtual uint64_t resourceManagerID() const = 0;
/// <summary>
2025-06-07 15:58:50 +00:00
/// ʵ<><CAB5><EFBFBD><EFBFBD>ָ<EFBFBD><D6B8><EFBFBD><EFBFBD><EFBFBD>͵ĵ<CDB5><C4B5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ִ<EFBFBD><D6B4>
/// </summary>
/// <param name="in"></param>
/// <returns></returns>
virtual QList<std::shared_ptr<WsMessage>> execute(const WsRespondSignatureType& resp_signature, std::shared_ptr<const WsMessage> in) = 0;
2025-06-21 07:56:59 +00:00
template<typename TypeIn, typename TypeOut>
QList<std::shared_ptr<TypeOut>> execute(std::shared_ptr<const WsMessage> in) {
auto sign = std::make_pair<QString, QString>(TypeIn().topicString(), TypeOut().topicString());
auto rest_list = this->execute(sign, in);
QList<std::shared_ptr<TypeOut>> typed_list;
for (auto it : rest_list) {
typed_list << std::static_pointer_cast<TypeOut>(it);
}
return typed_list;
}
2025-06-07 15:58:50 +00:00
/// <summary>
/// ʵ<><CAB5><EFBFBD>ڼ<EFBFBD><DABC>ݵ<EFBFBD><DDB5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ִ<EFBFBD><D6B4>
/// </summary>
/// <param name="in"></param>
/// <returns></returns>
virtual QList<std::shared_ptr<WsMessage>> execute(std::shared_ptr<const WsMessage> in) = 0;
};
/// <summary>
/// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ϣ<EFBFBD><CFA2><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ԫͨ<D4AA>ýӿ<C3BD>
/// </summary>
2025-06-10 04:41:33 +00:00
using WsRespondEntry = std::function<void(std::shared_ptr<Immediate> map, std::shared_ptr<const WsMessage>, QList<std::shared_ptr<WsMessage>>&)>;
2025-06-07 15:58:50 +00:00
2025-06-10 04:41:33 +00:00
/// <summary>
/// ʵ<><CAB5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ӿ<EFBFBD>
/// </summary>
2025-06-08 12:17:02 +00:00
class WsEntity : public Serializable {
public:
virtual ~WsEntity() = default;
/// <summary>
/// <20><>ȡ<EFBFBD><C8A1>ʵ<EFBFBD><CAB5><EFBFBD><EFBFBD>ģ<EFBFBD><C4A3><EFBFBD><EFBFBD>
/// </summary>
/// <returns>ģ<><C4A3><EFBFBD><EFBFBD><EFBFBD><EFBFBD></returns>
virtual QString templetName() const = 0;
/// <summary>
/// <20><>ȡ<EFBFBD><C8A1>ʵ<EFBFBD><CAB5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ID
/// </summary>
/// <returns></returns>
virtual uint64_t entityID() const = 0;
/// <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 = 0;
/// <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 = 0;
/// <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 = 0;
/// <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 = 0;
};
2025-05-25 04:43:37 +00:00
/// <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>
2025-06-08 12:17:02 +00:00
/// <param name="entity_id">ʵ<><CAB5>ʵ<EFBFBD><CAB5></param>
virtual void bindEntity(std::weak_ptr<WsEntity> host) = 0;
2025-05-25 04:43:37 +00:00
/// <summary>
/// <20><><EFBFBD><EFBFBD>Ψһ<CEA8><D2BB><EFBFBD><EFBFBD>
/// </summary>
/// <returns><3E><><EFBFBD><EFBFBD><EFBFBD><EFBFBD></returns>
virtual QString name() const = 0;
/// <summary>
2025-06-10 06:12:53 +00:00
/// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ϣǩ<CFA2><C7A9><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
2025-05-25 04:43:37 +00:00
/// </summary>
2025-06-10 06:12:53 +00:00
/// <returns><3E><>Ϣǩ<CFA2><C7A9><EFBFBD><EFBFBD><EFBFBD>ͼ<EFBFBD><CDBC><EFBFBD></returns>
virtual QList<WsRespondSignatureType> signatureTypes() const = 0;
2025-05-25 04:43:37 +00:00
/// <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;
};
2025-06-10 04:41:33 +00:00
/// <summary>
/// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ӿ<EFBFBD>
/// </summary>
2025-06-08 12:17:02 +00:00
class ComponentSet {
2025-06-07 15:58:50 +00:00
public:
/// <summary>
2025-06-08 12:17:02 +00:00
/// Ϊ<><CEAA>ʵ<EFBFBD><CAB5><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ָ<EFBFBD><D6B8><EFBFBD><EFBFBD><EFBFBD>͵IJ<CDB5><C4B2><EFBFBD>
2025-06-07 15:58:50 +00:00
/// </summary>
2025-06-08 12:17:02 +00:00
/// <param name="ins"></param>
virtual void append(std::shared_ptr<WsComponent> ins) = 0;
2025-06-07 15:58:50 +00:00
/// <summary>
2025-06-08 12:17:02 +00:00
/// <20>Ƴ<EFBFBD>ָ<EFBFBD><D6B8><EFBFBD><EFBFBD><EFBFBD>͵IJ<CDB5><C4B2><EFBFBD>ʵ<EFBFBD><CAB5>
2025-06-07 15:58:50 +00:00
/// </summary>
2025-06-08 12:17:02 +00:00
/// <param name="component_type"></param>
virtual void remove(const QString& component_type) = 0;
2025-06-07 15:58:50 +00:00
/// <summary>
2025-06-08 12:17:02 +00:00
/// <20><>ȡ<EFBFBD><C8A1>ʵ<EFBFBD><CAB5><EFBFBD>ڰ<EFBFBD><DAB0><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>в<EFBFBD><D0B2><EFBFBD>ʵ<EFBFBD><CAB5>
2025-06-07 15:58:50 +00:00
/// </summary>
/// <returns></returns>
2025-06-08 12:17:02 +00:00
virtual QList<std::shared_ptr<WsComponent>> components() const = 0;
2025-06-07 15:58:50 +00:00
};