ShitEngine 1.4.2
基于 C++20 与 SDL3 的轻量级 2D 游戏引擎
载入中...
搜索中...
未找到
TypeRegistry.h
浏览该文件的文档.
1#pragma once
2
3#include "ShitEngine/Reflection/TypeInfo.h"
4#include "ShitEngine/Core/Core.h"
5
6#include <string_view>
7#include <functional>
8#include <deque>
9#include <unordered_map>
10#include <string>
11
12// ── P1-3: 类型名 demangle 依赖 ──────────────────────
13#if defined(__GNUC__) || defined(__clang__)
14#if __has_include(<cxxabi.h>)
15#include <cxxabi.h>
16#define SHIT_HAS_CXXABI 1
17#endif
18#endif
19
20namespace Shit {
21
22class TypeInfoBuilder;
23
24class SHIT_API TypeRegistry {
25public:
26 void registerType(TypeInfo info);
27 void initBuiltinTypes();
28 void resolveBases();
29 bool unregisterType(std::string_view name);
31 void setRegistrationSource(std::string_view source);
33 size_t unregisterTypesBySource(std::string_view source);
34
35 [[nodiscard]] const TypeInfo* getType(std::string_view name) const;
36
38 [[nodiscard]] const TypeInfo* getType(std::type_index ti) const;
39
40 template<typename T>
41 [[nodiscard]] const TypeInfo* getType() const {
42 auto it = m_typeIndexMap.find(std::type_index(typeid(T)));
43 return it != m_typeIndexMap.end() ? it->second : nullptr;
44 }
45
46 void forEach(std::function<void(const TypeInfo&)> callback) const;
47 [[nodiscard]] size_t count() const { return m_typeStorage.size(); }
48
49 // ── 静态门面 ──
50
51 static TypeRegistry& GetInstance();
52
53 static void Register(TypeInfo info) { GetInstance().registerType(std::move(info)); }
54 static void InitBuiltinTypes() { GetInstance().initBuiltinTypes(); }
55 static void ResolveBases() { GetInstance().resolveBases(); }
56 static bool UnregisterType(std::string_view name) { return GetInstance().unregisterType(name); }
57 static void SetRegistrationSource(std::string_view source) { GetInstance().setRegistrationSource(source); }
58 static size_t UnregisterTypesBySource(std::string_view source) { return GetInstance().unregisterTypesBySource(source); }
59 static const TypeInfo* Get(std::string_view name) { return GetInstance().getType(name); }
60 static const TypeInfo* Get(std::type_index ti) { return GetInstance().getType(ti); }
61
62 template<typename T>
63 static const TypeInfo* Get() { return GetInstance().getType<T>(); }
64
65 static void ForEach(std::function<void(const TypeInfo&)> callback) { GetInstance().forEach(std::move(callback)); }
66 static size_t Count() { return GetInstance().count(); }
67
68 TypeRegistry(const TypeRegistry&) = delete;
69 TypeRegistry& operator=(const TypeRegistry&) = delete;
70 TypeRegistry(TypeRegistry&&) = delete;
71 TypeRegistry& operator=(TypeRegistry&&) = delete;
72
73private:
74 friend class EngineContext;
75 TypeRegistry() = default;
76 ~TypeRegistry() = default;
77
78 friend class TypeInfoBuilder;
79
80 // deque 保证元素地址稳定（push_back/emplace_back 不失效指向元素的指针）
81 std::deque<TypeInfo> m_typeStorage;
82 std::unordered_map<std::string, TypeInfo*> m_nameMap;
83 std::unordered_map<std::type_index, const TypeInfo*> m_typeIndexMap;
84 std::string m_currentSource;
85};
86
87// ── P1-3: 类型名 demangle ────────────────────────────
88// GCC/MinGW: abi::__cxa_demangle, MSVC: typeid 直接可读
89inline std::string DemangleTypeName(const char* mangled) {
90#if defined(SHIT_HAS_CXXABI)
91 int status = 0;
92 char* demangled = abi::__cxa_demangle(mangled, nullptr, nullptr, &status);
93 if (status == 0 && demangled) {
94 std::string result(demangled);
95 ::free(demangled);
96 return result;
97 }
98#endif
99 // MSVC 或 demangle 失败：直接返回原名
100 return std::string(mangled);
101}
102
106template<typename T, typename M>
107inline size_t memberOffset(M T::*member) {
108 return reinterpret_cast<size_t>(&(static_cast<T*>(nullptr)->*member));
109}
110
111class SHIT_API TypeInfoBuilder {
112public:
113 TypeInfoBuilder& Base(const TypeInfo* baseType) {
114 m_info.baseType = baseType;
115 return *this;
116 }
117
120 TypeInfoBuilder& Base(const char* name) {
121 m_info.baseTypeName = name ? name : "";
122 return *this;
123 }
124
125 template<typename T>
126 TypeInfoBuilder& Base() {
127 m_info.baseType = TypeRegistry::Get<T>();
128 return *this;
129 }
130
131 // 原始 Field 注册（offset + size）
132 TypeInfoBuilder& Field(const char* name, size_t offset, size_t size, const char* typeName) {
133 m_info.fields.push_back({name, offset, size, typeName});
134 return *this;
135 }
136
137 // ── P1-3: 成员指针重载（自动推导 offset + size + typeName）──
138 template<typename T, typename M>
139 TypeInfoBuilder& Field(const char* name, M T::*member) {
140 m_info.fields.push_back({
141 name,
142 memberOffset(member),
143 sizeof(M),
144 DemangleTypeName(typeid(M).name())
145 });
146 return *this;
147 }
148
149 template<typename T, typename M>
150 TypeInfoBuilder& Field(const char* name, M T::*member, const char* typeName) {
151 m_info.fields.push_back({
152 name,
153 memberOffset(member),
154 sizeof(M),
155 typeName
156 });
157 return *this;
158 }
159
160 // ── P2: 字段元数据（编辑器属性显示用）───────────
161 TypeInfoBuilder& Meta(const FieldMeta& meta) {
162 if (!m_info.fields.empty()) {
163 m_info.fields.back().meta.push_back(meta);
164 }
165 return *this;
166 }
167
168 // ── P20: 组件引用字段标记（ComponentRef<T>，编辑器拖拽引用 + UUID 序列化）──
169 // 由扫描器为 ComponentRef<...> 字段自动生成；普通字段不调用。
170 TypeInfoBuilder& Ref(const char* refType) {
171 if (!m_info.fields.empty() && refType) {
172 m_info.fields.back().refType = refType;
173 }
174 return *this;
175 }
176
177 // ── P3: 枚举常量 ──────────────────────────────────
178 TypeInfoBuilder& Value(const char* name, int64_t val) {
179 m_info.enumValues.push_back({name, val});
180 return *this;
181 }
182
183 // ── 方法注册 ──────────────────────────────────────
184 TypeInfoBuilder& Method(const char* name, const char* returnType,
185 std::function<void*(void*, const void**)> invoker,
186 std::vector<std::string> paramTypes = {}) {
187 MethodInfo mi;
188 mi.name = name;
189 mi.returnType = returnType ? returnType : "void";
190 mi.paramTypes = std::move(paramTypes);
191 mi.invoker = std::move(invoker);
192 m_info.methods.push_back(std::move(mi));
193 return *this;
194 }
195
196 TypeInfoBuilder& MethodMeta(const FieldMeta& meta) {
197 if (!m_info.methods.empty()) {
198 m_info.methods.back().meta.push_back(meta);
199 }
200 return *this;
201 }
202
203 // ── 属性注册（getter/setter 对）──────────────────
204 TypeInfoBuilder& Property(const char* name, const char* typeName,
205 std::function<void*(void*)> getter,
206 std::function<void(void*, const void*)> setter) {
207 PropertyInfo pi;
208 pi.name = name;
209 pi.typeName = typeName ? typeName : "";
210 pi.getter = std::move(getter);
211 pi.setter = std::move(setter);
212 m_info.properties.push_back(std::move(pi));
213 return *this;
214 }
215
216 TypeInfoBuilder& PropertyMeta(const FieldMeta& meta) {
217 if (!m_info.properties.empty()) {
218 m_info.properties.back().meta.push_back(meta);
219 }
220 return *this;
221 }
222
223 // ── P1-2: 工厂注册 ─────────────────────────────────
224 template<typename T>
225 TypeInfoBuilder& Factory() {
226 m_info.factory = makeFactory<T>(std::is_abstract<T>{});
227 return *this;
228 }
229
230 template<typename T>
231 void Register() {
232 m_info.typeIndex = std::type_index(typeid(T));
233
234 // 尝试立即解析 baseTypeName（若已注册则直接链接，未注册时留待 ResolveBases 处理）
235 if (!m_info.baseType && !m_info.baseTypeName.empty()) {
236 auto* resolved = TypeRegistry::Get(m_info.baseTypeName.c_str());
237 if (resolved) {
238 m_info.baseType = resolved;
239 }
240 }
241
242 TypeRegistry::Register(std::move(m_info));
243 }
244
245private:
246 friend TypeInfoBuilder ReflectType(const char* name, size_t size);
247
248 explicit TypeInfoBuilder(const char* name, size_t size)
249 : m_info{name, size, nullptr, {}, {}, {}, {}, {}, typeid(nullptr)} {}
250
251 // ── Factory SFINAE 辅助：抽象类型跳过 factory ──
252 template<typename T>
253 static std::function<void*(void*)> makeFactory(std::false_type /* not abstract */) {
254 return [](void* mem) -> void* {
255 if (mem) return ::new(mem) T();
256 return new T();
257 };
258 }
259
260 template<typename T>
261 static std::function<void*(void*)> makeFactory(std::true_type /* abstract */) {
262 return nullptr;
263 }
264
265 TypeInfo m_info;
266};
267
268inline TypeInfoBuilder ReflectType(const char* name, size_t size) {
269 return TypeInfoBuilder(name, size);
270}
271
272} // namespace Shit
SHIT_API
#define SHIT_API
定义 Core.h:14
Shit::TypeInfoBuilder
定义 TypeRegistry.h:111
Shit::TypeInfoBuilder::Field
TypeInfoBuilder & Field(const char *name, size_t offset, size_t size, const char *typeName)
定义 TypeRegistry.h:132
Shit::TypeInfoBuilder::ReflectType
friend TypeInfoBuilder ReflectType(const char *name, size_t size)
定义 TypeRegistry.h:268
Shit::TypeInfoBuilder::Base
TypeInfoBuilder & Base(const char *name)
按名称指定基类（延迟解析，消除 SIOF） Register() 时尝试解析，ResolveBases() 时再次尝试
定义 TypeRegistry.h:120
Shit::TypeInfoBuilder::Factory
TypeInfoBuilder & Factory()
定义 TypeRegistry.h:225
Shit::TypeInfoBuilder::Base
TypeInfoBuilder & Base()
定义 TypeRegistry.h:126
Shit::TypeInfoBuilder::Field
TypeInfoBuilder & Field(const char *name, M T::*member)
定义 TypeRegistry.h:139
Shit::TypeInfoBuilder::Register
void Register()
定义 TypeRegistry.h:231
Shit::TypeInfoBuilder::Property
TypeInfoBuilder & Property(const char *name, const char *typeName, std::function< void *(void *)> getter, std::function< void(void *, const void *)> setter)
定义 TypeRegistry.h:204
Shit::TypeInfoBuilder::Base
TypeInfoBuilder & Base(const TypeInfo *baseType)
定义 TypeRegistry.h:113
Shit::TypeInfoBuilder::MethodMeta
TypeInfoBuilder & MethodMeta(const FieldMeta &meta)
定义 TypeRegistry.h:196
Shit::TypeInfoBuilder::Meta
TypeInfoBuilder & Meta(const FieldMeta &meta)
定义 TypeRegistry.h:161
Shit::TypeInfoBuilder::Field
TypeInfoBuilder & Field(const char *name, M T::*member, const char *typeName)
定义 TypeRegistry.h:150
Shit::TypeInfoBuilder::PropertyMeta
TypeInfoBuilder & PropertyMeta(const FieldMeta &meta)
定义 TypeRegistry.h:216
Shit::TypeInfoBuilder::Value
TypeInfoBuilder & Value(const char *name, int64_t val)
定义 TypeRegistry.h:178
Shit::TypeInfoBuilder::Method
TypeInfoBuilder & Method(const char *name, const char *returnType, std::function< void *(void *, const void **)> invoker, std::vector< std::string > paramTypes={})
定义 TypeRegistry.h:184
Shit::TypeInfoBuilder::Ref
TypeInfoBuilder & Ref(const char *refType)
定义 TypeRegistry.h:170
Shit::TypeRegistry::resolveBases
void resolveBases()
解析所有未解析的基类引用（消除 SIOF）
Shit::TypeRegistry::Count
static size_t Count()
定义 TypeRegistry.h:66
Shit::TypeRegistry::Get
static const TypeInfo * Get(std::string_view name)
定义 TypeRegistry.h:59
Shit::TypeRegistry::TypeInfoBuilder
friend class TypeInfoBuilder
定义 TypeRegistry.h:78
Shit::TypeRegistry::operator=
TypeRegistry & operator=(const TypeRegistry &)=delete
Shit::TypeRegistry::SetRegistrationSource
static void SetRegistrationSource(std::string_view source)
定义 TypeRegistry.h:57
Shit::TypeRegistry::Register
static void Register(TypeInfo info)
定义 TypeRegistry.h:53
Shit::TypeRegistry::getType
const TypeInfo * getType(std::string_view name) const
Shit::TypeRegistry::Get
static const TypeInfo * Get(std::type_index ti)
定义 TypeRegistry.h:60
Shit::TypeRegistry::operator=
TypeRegistry & operator=(TypeRegistry &&)=delete
Shit::TypeRegistry::count
size_t count() const
定义 TypeRegistry.h:47
Shit::TypeRegistry::unregisterType
bool unregisterType(std::string_view name)
按名称卸载类型
Shit::TypeRegistry::UnregisterType
static bool UnregisterType(std::string_view name)
定义 TypeRegistry.h:56
Shit::TypeRegistry::TypeRegistry
TypeRegistry(const TypeRegistry &)=delete
Shit::TypeRegistry::setRegistrationSource
void setRegistrationSource(std::string_view source)
设置后续注册类型的来源标记（空 = 引擎内置，插件注册前设为插件名）
Shit::TypeRegistry::ForEach
static void ForEach(std::function< void(const TypeInfo &)> callback)
定义 TypeRegistry.h:65
Shit::TypeRegistry::Get
static const TypeInfo * Get()
定义 TypeRegistry.h:63
Shit::TypeRegistry::InitBuiltinTypes
static void InitBuiltinTypes()
定义 TypeRegistry.h:54
Shit::TypeRegistry::registerType
void registerType(TypeInfo info)
Shit::TypeRegistry::TypeRegistry
TypeRegistry(TypeRegistry &&)=delete
Shit::TypeRegistry::ResolveBases
static void ResolveBases()
定义 TypeRegistry.h:55
Shit::TypeRegistry::forEach
void forEach(std::function< void(const TypeInfo &)> callback) const
Shit::TypeRegistry::UnregisterTypesBySource
static size_t UnregisterTypesBySource(std::string_view source)
定义 TypeRegistry.h:58
Shit::TypeRegistry::GetInstance
static TypeRegistry & GetInstance()
Shit::TypeRegistry::EngineContext
friend class EngineContext
定义 TypeRegistry.h:74
Shit::TypeRegistry::getType
const TypeInfo * getType() const
定义 TypeRegistry.h:41
Shit::TypeRegistry::getType
const TypeInfo * getType(std::type_index ti) const
按 type_index 查询（Prefab 动态克隆等场景用）
Shit::TypeRegistry::unregisterTypesBySource
size_t unregisterTypesBySource(std::string_view source)
卸载指定来源注册的全部类型（插件卸载前调用，防止 factory 悬垂）
Shit
定义 AnimationClip.h:12
Shit::ReflectType
TypeInfoBuilder ReflectType(const char *name, size_t size)
定义 TypeRegistry.h:268
Shit::KeyCode::M
@ M
定义 KeyCode.h:30
Shit::KeyCode::T
@ T
定义 KeyCode.h:37
Shit::memberOffset
size_t memberOffset(M T::*member)
计算成员指针相对于类基址的偏移量（供反射注册代码使用） 用法: memberOffset(&MyClass::myField) 需要通过 friend 声明获取 private/protected 成员...
定义 TypeRegistry.h:107
Shit::DemangleTypeName
std::string DemangleTypeName(const char *mangled)
定义 TypeRegistry.h:89
Shit::FieldMeta
定义 TypeInfo.h:17
Shit::MethodInfo
方法信息（由 SHIT_METHOD 生成）
定义 TypeInfo.h:73
Shit::MethodInfo::name
std::string name
方法名
定义 TypeInfo.h:74
Shit::MethodInfo::returnType
std::string returnType
返回类型名
定义 TypeInfo.h:75
Shit::MethodInfo::paramTypes
std::vector< std::string > paramTypes
参数类型名列表
定义 TypeInfo.h:76
Shit::MethodInfo::invoker
std::function< void *(void *, const void **)> invoker
调用器：(obj, args) -> returnValue obj = 对象指针，args = 参数指针数组，返回值通过 void* 返回
定义 TypeInfo.h:79
Shit::PropertyInfo
属性信息（由 SHIT_PROPERTY 生成，getter/setter 对）
定义 TypeInfo.h:84
Shit::PropertyInfo::typeName
std::string typeName
属性类型名
定义 TypeInfo.h:86
Shit::PropertyInfo::name
std::string name
属性名
定义 TypeInfo.h:85
Shit::PropertyInfo::setter
std::function< void(void *, const void *)> setter
setter 调用器：(obj, value) 写入值
定义 TypeInfo.h:92
Shit::PropertyInfo::getter
std::function< void *(void *)> getter
getter 调用器：(obj) -> 指向值的指针（静态/线程局部存储）
定义 TypeInfo.h:90
Shit::TypeInfo
定义 TypeInfo.h:96