1. 코드 생성을 사용해
개발 속도 높이기
김이선 (veblush at neople | gmail)
네오플 던파개발실

2. 버블파이터
BNB 카트라이더 프로토타입 에버플래닛 던전엔파이터
프로그래머 리드 프로그래머 리드 프로그래머 리드 프로그래머 테크니컬 디렉터
게임 프로그래밍 10년차

3. 생산성!

4. 생산성은 왜?

5. 1. enum 으로 보는
코드 생성
2. CodeGen
3. 에버플래닛의
사용 예

6. enum Fruit
{
apple = 1,
banana,
grape
};

8. const WChar* Fruit_strs[] =
{
L"apple",
L"banana",
L"grape"
};
void fillValue(CComboBox* cb)
{
cb->Clear();
for (int i=0; i<_countof(Fruit_str); i++)
cb->AddString(Fruit_strs[i]);
}

9. enum 에게 필요한 것은?

10. enum ↔ 문자열
String toString(Fruit f)
banana(2) <-> L"banana"

11. 멤버 iteration
for (f in Fruit) { print f }
apple, banana, grape

12. Macro | Template 이라면?

13. ENUM_BEGIN(Fruit)
ENUM_V(apple, 1)
ENUM(banana)
ENUM(grape)
ENUM_END(Fruit)

14. #define ENUM_BEGIN(t)
char* t ## _table [] = {
#define ENUM(n) #n,
#define ENUM_END(t) };
…

15. 적은 비용. 외부 의존성 낮음.
때문에 좋은 해결책이기도 하다

16. 기능 추가에 유연하지 않음.
코드 마술이 늘 쉬운 것만은 아님

17. 코드 생성
C++ 헤더 코드
기술 코드
C++ 소스 코드
<Enum name="Fruit"> struct Fruit {
<C n="apple"/> enum T {
<C n="banana"/> apple, banana, grape };
<C n="grape"/> };
</Enum>
String toString(Fruit::T v)
{ … }
void fromString(WChar* str,
Fruit::T* v) { … }

18. 구현 기능에 제한이 없음
코드로 할 수 있다면 뭐든지!

19. 코드 생성 툴에 종속성이 생김
개발 과정에 꼭 필요한 툴 추가

20. 구현 가능성 > 툴 종속성

21. 1. enum 으로 보는
코드 생성
2. CodeGen
3. 에버플래닛의
사용 예

22. CodeGen ?
코드 생성을 수행하는
Visual Studio 플러그인
(C# LOC:3K)

23. 소스 작성 중
CodeGen
코드 작성
CodeGen
플러그인 실행
C++ 코드 생성
소스 작업 계속

24. CodeGen 데모

25. http://www.youtube.com/watch?v=6wfNfeK_t0w

26. 소스 편집 중에 바로 코드 생성

27. 생성된 코드를 바로 확인!
Intellisense!

28. 빌드 자체에는 툴 종속성이 없음

29. 작업 코드 중간에 들어갈 수 있음

30. 코드 생성을 위해 별도 파일 불필요

31. 유저 코드 삽입이 자연스러움

32. 코드 생성으로 얻는 것?

33. 빠르게 원하는 기능 구현
구현 코드는 CodeGen 이 생성!
프로그래머는 내용에 집중!

34. 신뢰성/일관성 있는 코드
기계적으로 생성하는 코드!

35. 사소하지만 필요한 기능

36. 라이브러리 형태 지원
<Enum name="Fruit" dllDecl="LibDecl">
<Const name="apple" value="1"/>
<Const name="banana"/>
<Const name="grape"/>
struct LibDecl Fruit // LibDecl=__declspec(dllexport) …
{
enum T
{
apple = 1,
banana,
grape,

37. doxygen 주석 붙이기
<!--! 과일을 나타냅니다 -->
<Enum name="Fruit">
<Const name="apple" value="1" comment="사과"/>
<Const name="banana" comment="바나나는 맛있어"/>
//! 과일을 나타냅니다
struct Fruit
{
enum T
{
apple = 1, //!< 사과
banana, //!< 바나나는 맛있어

38. 생성된 코드에 유저 코드 삽입
<Enum name="Fruit">
<Const name="apple" value="1"/>
…
<HText><![CDATA[
Bool isMyFavorate(Fruit::T v);
]]></HText>
struct Fruit
{
enum T
…
Bool isMyFavorate(Fruit::T v);
};

39. 주의사항?

40. 문법은 확장 가능하도록!
유연하게! 일반적인 문법!
XML?

41. 생성된 코드가 수정되지 않게!
기계적인 느낌이 나도록 생성?
#pragma region?

42. 모두가 같은 버전의 툴!
예전버전을 사용하면 곤란.
자동 업데이트?

43. 1. enum 으로 보는
코드 생성
2. CodeGen
3. 에버플래닛의
사용 예

44. 적용한 부분은?
기계적이고 반복적인 부분에 적용.
적용 영역이 지속적으로 확대.

45. 사용한 CodeGen 영역
Enum
Packet Data
DbCall DbRowset

46. Enum : 열거형 확장
문자열 변환 기능 추가
멤버 순회 기능 추가

47. Enum : CodeGen
<Enum name="Fruit">
<Const name="apple" value="1"/>
<Const name="banana"/>
<Const name="grape"/>
</Enum>

48. Enum : Generated
struct Fruit {
enum T {
apple=1,
banana,
grape
};
…
};
String toString(…);
fromString(…);

49. Enum : Usage
toString(Fruit::banana); // "banana"
fromString<Fruit::T>(L"grape"); // 3
Fruit::enumCount; // 3
Fruit::enumValue[1]; // Fruit::banana

50. template <class EnumType>
void fillValue(CComboBox* cb)
{
cb->Clear();
for (size_t i=0; i<EnumType::enumCount; i++)
cb->AddString(EnumType::enumStr[i]);
};

51. Packet : 패킷 Serialization
패킷 내용을 구조체로 구성
Byte Serialization 코드 작성

52. 패킷은 지속적인 작업
귀찮은 Serialization 코드 작업

53. Packet : CodeGen
<Packet name="TestPacket">
<Field name="code" type="Int4"/>
<Field name="name" type="String"/>
</Packet>

54. Packet : Generated
struct TestPacket : public Packet
{
TestPacket(Int4 code, String name);
virtual Int4 getStreamSize() const;
virtual void readFrom(Stream& is);
virtual void writeTo(Stream& os);
public:
Int4 code;
String name;
};

55. Packet : Usage
send() {
TestPacketPtr p = new TestPacket;
p->code = 1;
p->name = L"Test";
sendPacket(p);
// or
sendPacket(new TestPacket(1, L"Test"));
}
recv(TestPacket* p) {
p->code;
p->name;
}

56. 코드 생성이라 최적화 전략 가능
패킷 멤버 모두가 단순 타입이면
read/write 를 단순 memcpy로

57. Packet : Optimized
// Read
// Member is >> userId;
Int4 userId; is >> itemId;
Int4 itemId; is >> presetId;
Int4 presetId; is >> pos;
Vector2 pos;
// Read (Optimized)
is.read(this,
sizeof(TestPacket));

58. Data : POD 확장
멤버 변수를
XML | 바이트 스트림으로
Serialization

59. 아이템, 퀘스트 등을
기술하는데 이러한 구조체가 필요
이러한 데이터는
파일에 있기 때문에 I/O 코드 필요

60. Data: CodeGen
<Data name="Item">
<Field name="id" type="Int4"/>
<Field name="name" type="String"/>
<Field name="desc" type="String"/>
<Field name="level" type="Int4" init="0"/>
<Field name="itemClass" type="ItemClass::T"
init="ItemClass::kMisc"/>
</Data>

61. Data : Generated
struct Item
{
Item();
void readFrom(Stream& is);
void writeTo(Stream& os) const;
void readFrom(XmlElement* xel);
void writeTo(XmlElement* xel) const;
Int4 id;
String name;
…
};

62. Data : Usage
<Item
Item item; id="100"
item.readFrom(xml); name="무쇠 갑옷"
item.id; desc="무척강하다"
item.name; itemClass="armor"
/>

63. Data CodeGen 데모
Pet 구조체 만들기
ItemSpawn 은 이미 있음

64. http://www.youtube.com/watch?v=kRrYj3Lx5Pw

65. <Pet 07 0a 00 00 00 06
id="10" 00 00 00 6d 00 6f
name="monkey" 00 6e 00 6b 00 65
food="banana" 00 79 00 02 00 00
> 00 02 00 00 00 00
<Items> 64 00 00 00 01 c8
<ItemSpawn 00 00 00 05 00 00
itemId="100" 00
/>
<ItemSpawn
itemId="200"
count="5"
용량 16%
/>
</Items>
속도 x3
</Pet>

66. 개발 때는 XML 사용
포맷 개방, 공동 작업!
배포 때는 Binary 사용
포맷 고정, 빠른 속도, 보안!

67. DbCall : SQL/SP 호출
호출 전후에
파라미터 변수 바인딩

68. DbCall : CodeGen
<DbCall name="DcLogin" spName="spLogin">
<Param name="id" type="String" maxLen="24"/>
<Param name="ret" type="Int4" io="out"/>
</DbCall>
CREATE PROCEDURE spLogin
@id as nvarchar(24), @ret as int OUTPUT

69. DbCall : Generated
struct DcLogin
{
static HRESULT exec(DbSession* s,
const String& id, Int4* ret);
struct Param : public DbCallParam
{
String id;
Int4 ret;
virtual HRESULT exec(DbSession* s);
};
};

70. DbCall : Usage
hr = DcLogin::exec(s, "userid", &ret);
// or
p = new DcLogin::Param;
p->id = "userid";
p->exec(s);
p->ret;
CREATE PROCEDURE spLogin
@id as nvarchar(24), @ret as int OUTPUT

71. DbRowset : Rowset 읽기
Rowset 을 읽어
컬럼 변수에 바인딩

72. DbRowset : CodeGen
<DbRowset name="DrInven">
<Field name="id" type="Int4"/>
<Field name="count" type="Int4"/>
<Field name="expireTime" type="DateTime4"/>
</DbRowset>
SELECT id, count, expireTime
FROM tblInven WHERE charId=1

73. DbRowset : Generated
struct DrInven : public DbRowset
{
Int4 id;
Int4 count;
DateTime4 expireTime;
protected:
virtual HRESULT onInit(...);
virtual void onNext();
};

74. DbRowset : Usage
DrInvenPtr rs;
hr = DcInvenGet::exec(dbSession, &rs);
while (rs->next()) {
rs->id;
rs->count;
rs->expireTime;
}
SELECT id, count, expireTime
FROM tblInven WHERE charId=1

75. 적용 비중?

76. 사용한 CodeGen 개수
0 200 400 600 800 1000
Enum
Packet
Data
DbCall
DbRowset

77. CodeGen 코드 라인 수
원본코드
10,946
x7
생성코드
69,391

78. 생성코드의 비중
생성코드
69,391
11%
그외코드
559,517

79. Total: 11261 revs
Packet:
1646 revs (14%) x2
Data/Item:
215 revs (2%) x215

80. 결론

81. 코드 생성은
생각보다 많은 영역에 사용 가능
기대보다 많은 코드 작성을 대신

82. 시도해보자!

83. 감사합니다!