RTTIAPI.hpp

浏览该文件的文档.

 
 
#pragma once
 
#include "AstGlobal.h"
#include "AstUtil/SharedPtr.hpp"
#include "AstUtil/Object.hpp"
#include "AstUtil/StringView.hpp"
#include <map>
 
AST_NAMESPACE_BEGIN
 
// -----------
// 类型元信息
// -----------
 
 
AST_UTIL_CAPI void aGetAllClassNames(std::vector<std::string>& names);
 
AST_UTIL_API const std::unordered_map<std::string, Class*>& aGetAllClasses();
 
AST_UTIL_CAPI Class* aGetClass(StringView name);
 
AST_UTIL_CAPI bool aIsVirtualClass(StringView name);
 
AST_UTIL_CAPI void aRegisterClass(Class* cls, StringView name=StringView());
 
AST_UTIL_API Object* aGetClassDefaultObject(StringView name);
 
AST_UTIL_API Object* aGetClassDefaultObject(Class* cls);
 
AST_UTIL_CAPI Object* aNewObject(StringView typeName, Object* parentScope=nullptr);
 
 
template<typename T>
T* aNewObject(Object* parentScope=nullptr)
{
    T* obj = new T();
    aSetParentScope(obj, parentScope);
    return obj;
}
 
AST_UTIL_CAPI void aDeleteObject(Object* obj);
 
AST_UTIL_API SharedPtr<Object> aMakeObject(StringView name, Object* parentScope=nullptr);
 
 
 
AST_UTIL_API Object* aResolveObject(StringView value, Class* cls = nullptr);
 
 
template<typename T>
T aResolveObject(StringView value)
{
    using ObjectType = typename std::decay<typename std::remove_pointer<T>::type>::type;
    static_assert(has_own_getType<ObjectType>::value, "aResolveObject requires the type to has a AST_OBJECT macro");
    return static_cast<T>(aResolveObject(value, ObjectType::StaticType()));
}
 
// -----------
// 对象管理
// -----------
 
AST_UTIL_CAPI Object* aGetObject(uint32_t id);
 
// AST_UTIL_CAPI uint32_t aGetObjectID(Object* obj);
 
AST_UTIL_CAPI uint32_t aAddObject(Object* object);
 
 
AST_UTIL_CAPI errc_t aRemoveObject(Object* object);
 
AST_UTIL_CAPI void aRemoveAllObjects();
 
AST_UTIL_CAPI int aGetObjectCount();
 
 
AST_UTIL_API std::vector<Object*> aFindObjects(Class* cls, StringView name=StringView());
 
 
AST_UTIL_API Object* aFindObject(Class* cls, StringView name=StringView());
 
template<typename T>
T aFindObject(StringView name=StringView())
{
    // @todo: 这里逻辑和aobject_cast<T>的重复了，考虑怎么重构
    using ObjectType = typename std::decay<typename std::remove_pointer<T>::type>::type;
    static_assert(has_own_getType<ObjectType>::value, "aFindObject requires the type to has a AST_OBJECT macro");
    return static_cast<T>(aFindObject(ObjectType::StaticType(), name));
}
 
AST_UTIL_CAPI errc_t aSetParentScope(Object* obj, Object* parentScope);
 
 
AST_UTIL_CAPI Object* aGetParentScope(Object* obj);
 
 
AST_UTIL_CAPI Object* aGetAncestorScope(Object* obj, Class* cls);
 
template<typename T>
T aGetAncestorScope(Object* obj)
{
    // @todo: 这里逻辑和aobject_cast<T>的重复了，考虑怎么重构
    using ObjectType = typename std::decay<typename std::remove_pointer<T>::type>::type;
    static_assert(has_own_getType<ObjectType>::value, "aGetAncestorScope requires the type to has a AST_OBJECT macro");
    return static_cast<T>(aGetAncestorScope(obj, ObjectType::StaticType()));
}
 
AST_UTIL_API std::vector<Object*> aGetAllObjects();
 
 
AST_UTIL_API void aPrintAllObjects();
 
 
AST_UTIL_API Object* aFindChild(Object* parentScope, Class* cls=nullptr, StringView name=StringView());
 
 
template<typename T>
T aFindChild(Object* parentScope, StringView name=StringView())
{
    // @todo: 这里逻辑和aobject_cast<T>的重复了，考虑怎么重构
    using ObjectType = typename std::decay<typename std::remove_pointer<T>::type>::type;
    static_assert(has_own_getType<ObjectType>::value, "aFindChild requires the type to has a AST_OBJECT macro");
    return static_cast<T>(aFindChild(parentScope, ObjectType::StaticType(), name));
}
 
AST_UTIL_API errc_t aFindChildren(Object* parentScope, Class* cls, StringView name, std::vector<Object*>& children);
 
 
AST_UTIL_API std::vector<Object*> aFindChildren(Object* parentScope, Class* cls=nullptr, StringView name=StringView());
 
struct ObjectPrintConfig {
    bool printRefCount = false;  
    bool printWeakRefCount = false;  
};
 
 
AST_UTIL_API void aPrintObject(Object* obj, int indent=0, const ObjectPrintConfig& config = ObjectPrintConfig());
 
 
AST_UTIL_API void aPrintObjectTree(Object* root, int indent=0);
AST_UTIL_API void aPrintObjectTree(Object* root, int indent, const ObjectPrintConfig& config);
 
AST_NAMESPACE_END