nullptr로 막아야 하고, 루트 타입은 부모가 없어야 한다.
→IMPLEMENT_ABSTRACT_CLASS, IMPLEMENT_CLASS_BASE같은 템플릿화된 분기를 간단히 제공한다.<aside> 💡
보일러플레이트(Boilerplate)
일관된 바이너리 계약(ABI)
왜 중요한가?
리플렉션(Reflection)
우리가 만든 RTTI와 매크로를 보면서 어떻게 구성되는지 보자.
#pragma once
#include "Global/CoreTypes.h"
// 전방 선언
class UObject;
class UClass;
/**
* @brief 언리얼엔진의 UClass를 모방한 클래스 메타데이터 시스템
*
* 각 UObject 파생 클래스에 대한 런타임 타입 정보를 저장합니다.
* - 클래스 이름
* - 부모 클래스 정보
* - 클래스 크기
* - 생성자 함수 포인터
*/
class UClass
{
public:
// 생성자 함수 포인터 타입 정의
typedef UObject* (*ClassConstructorType)();
public:
UClass(const FString& InName, UClass* InSuperClass, size_t InClassSize, ClassConstructorType InConstructor);
const FString& GetName() const { return ClassName; }
UClass* GetSuperClass() const { return SuperClass; }
size_t GetClassSize() const { return ClassSize; }
bool IsChildOf(const UClass* OtherClass) const;
UObject* CreateDefaultObject() const;
//static UClass* FindClass(const FString& InClassName);
//static void SignUpClass(UClass* InClass);
//static void PrintAllClasses();
private:
FString ClassName; // 클래스 이름
UClass* SuperClass; // 부모 클래스
size_t ClassSize; // 클래스 크기
ClassConstructorType Constructor; // 생성자 함수 포인터
// 전역 클래스 레지스트리
static TArray<UClass*> AllClasses;
};
/**
* @brief RTTI 매크로 시스템
*
* 언리얼엔진의 UCLASS(), DECLARE_CLASS, IMPLEMENT_CLASS와 유사한 매크로들
*/
// 언리얼 스타일: 클래스 선언 바로 위에서 사용하는 매크로 (여기서는 표시용, 실동작은 GENERATED_BODY에서 처리)
#define UCLASS()
// 클래스 본문 내부에서 사용하는 매크로 (friend 등 내부 선언 처리)
#define GENERATED_BODY() \
public: \
friend class UClass; \
friend class UObject;
// 클래스 선언부에 사용하는 매크로
#define DECLARE_CLASS(ClassName, SuperClassName) \
public: \
typedef ClassName ThisClass; \
typedef SuperClassName Super; \
static UClass* StaticClass(); \
virtual UClass* GetClass() const; \
static UObject* CreateDefaultObject##ClassName();
// 클래스 구현부에 사용하는 매크로
#define IMPLEMENT_CLASS(ClassName, SuperClassName) \
UClass* ClassName::StaticClass() \
{ \
/* 정적 지역 변수를 사용하여 UClass 객체를 자동 관리 */ \
static UClass Instance( \
FString(#ClassName), \
SuperClassName::StaticClass(), \
sizeof(ClassName), \
&ClassName::CreateDefaultObject##ClassName \
); \
return &Instance; \
} \
UClass* ClassName::GetClass() const \
{ \
return ClassName::StaticClass(); \
} \
UObject* ClassName::CreateDefaultObject##ClassName() \
{ \
return new ClassName(); \
}
// 추상 클래스에 사용하는 매크로 (기본 객체를 생성하지 않음)
#define IMPLEMENT_ABSTRACT_CLASS(ClassName, SuperClassName) \
UClass* ClassName::StaticClass() \
{ \
static UClass Instance( \
FString(#ClassName), \
SuperClassName::StaticClass(), \
sizeof(ClassName), \
nullptr \
); \
return &Instance; \
} \
UClass* ClassName::GetClass() const \
{ \
return ClassName::StaticClass(); \
}
// UObject의 기본 매크로 (다른 클래스들의 베이스)
#define IMPLEMENT_CLASS_BASE(ClassName) \
UClass* ClassName::StaticClass() \
{ \
static UClass Instance( \
FString(#ClassName), \
nullptr, \
sizeof(ClassName), \
&ClassName::CreateDefaultObject##ClassName \
); \
return &Instance; \
} \
UClass* ClassName::GetClass() const \
{ \
return ClassName::StaticClass(); \
} \
UObject* ClassName::CreateDefaultObject##ClassName() \
{ \
return new ClassName(); \
}
전체 코드는 위와 같고 하나씩 봐보자
// 선언부에서 쓰는 매크로, 현재 클래스 이름과 슈퍼클래스 이름을 인자로 받음
#define DECLARE_CLASS(ClassName, SuperClassName) \
public: \
typedef ClassName ThisClass; \
typedef SuperClassName Super; \
static UClass* StaticClass(); \
virtual UClass* GetClass() const; \
static UObject* CreateDefaultObject##ClassName();
typedef ClassName ThisClass;
자기 자신 타입 별칭. 템플릿/매크로 코드에서 자기 타입을 간결히 부르려는 관례(UE와 유사).
typedef SuperClassName Super;
슈퍼클래스 별칭. 상위 클래스 멤버 호출 시 Super:: 형태로 사용하기 편하게 함.
static UClass* StaticClass();
“클래스 메타데이터에 접근”하기 위한 정적 함수 선언. 클래스 자체(인스턴스 없이)로부터 UClass를 얻는 관문.
virtual UClass* GetClass() const;
“객체 인스턴스의 런타임 클래스”를 얻는 가상 함수. 다형성 하에서 올바른 클래스 반환 보장.
static UObject* CreateDefaultObject##ClassName();
정적 팩토리 함수 선언. ##는 토큰 붙이기(token pasting) 연산자로, CreateDefaultObject와 ClassName을 이어 붙여 고유한 함수 이름을 만듦(예: CreateDefaultObjectUWidget). 기본 인스턴스 생성용.