1. API Design for C++
Ch.5 API 개발 방법
아꿈사에서 박민규

2. Styles
•
Flat C
•
Object Orient
•
Template Based
•
Data Driven
ex) FMOD => Flat C, OO, DD http://www.fmod.org/download

3. Flat C
•
표준 C Lib(stdio.h, stdlib.h, string.h, etc…), Win32 API,
Linux Kernel API, GNOME GLib, NetScape PR, libtiff,
libpng, libz, libungif, etc…
•
ANSI C 추천
•
char, const, continue, default, do, double else, enum,
extern, float, for, goto, if, int, long, register, short, signed,
sizeof, static, struct, switch, typedef, union, unsigned, void,
volatile, while
•
C로 작성하고 C++ 컴파일러로 돌려보세요, 오류를 더 많이 알려준
다

4. Flat C Style
struct Stack
{
int *mStack;
int mCurSize;
};
!
typedef struct Stack *StackPtr;
!
void StackPush(StackPtr stack, int val);
!
int StackPop(StackPtr stack);
!
bool StackIsEmpty(const StackPtr stack);

5. Flat C Style 호출할때
StackPtr stack = StackCreate();
if (stack)
{
StackPush(stack, 10);
StackPush(stack, 3);
while (!StackIsEmpty(stack))
{
StackPop(stack);
}
StackDestroy(stack);
}

6. Flat C Style 장점
•
통합해야할 기존 시스템이 C로 되어 있을때
•
•
예) 리눅스 커널 API를 사용해야 한다면
이진 호환성을 유지해야 할때

7. Flat C, C++ 같이 쓰기
•
class 같은 키워드 금지
•
extern “c”로 감싸기
#ifdef __cplusplus
extern “C” {
#endif
!
…
!
#ifdef _cplusplus
}
#endif

8. OO Style
class Stack
{
public:
void Push(int val);
int Pop();
bool IsEmpty() const;
private:
int *mStack;
int mCurSize;
};

9. OO Style 호출할때
Stack *stack = new Stack();
if (stack)
{
stack->Push(10);
stack->Push(3);
while (!stack->IsEmpty())
{
stack->Pop();
}
delete stack;
}

10. OO Style 장점
•
절차적 코드 대신 연결된 모델
•
조금 더 논리적으로 접근
•
클래스를 이용한 데이터와 메서드의 캡슐화
•
예) namespace, public, protected, private

11. OO Style 단점
•
상속의 복잡성, 애매모호함
•
오남용
•
이진 호환 유지의 어려움

12. Template Based Style
#include <vector>
!
template <typename T>
class Stack
{
public:
void Push(T val);
T Pop();
bool IsEmpty() const;
!
private:
std::vector<T> mStack;
};

13. Template Based Style 호출할때
typedef Stack<int> IntStack;
!
IntStack *stack = new IntStack();
if (stack)
{
stack->Push(10);
stack->Push(3);
while (!stack->IsEmpty())
{
stack->Pop();
}
delete stack;
}

14. Template Based Style 장점
•
중복제거
•
컴파일 타임의 정적 다형성
•
가상메서드를 피할 수 있어 성능 향상

15. Template Based Style 단점
•
개발시 클래스 템플릿을 헤더에 정의, 명시적 인스턴스화
로 .cpp로 구현 숨기기
•
컴파일 시간 증가
•
바이너리 증가
•
골치아픈 오류 메세지

16. Data Driven API Style
// flat c-style
func(obj, a, b, c);
!
// object-orient style
obj.func(a, b, c);
!
// data-driven function with parameters
send(“func”, a, b, c);
!
//data-driven function with a dictionary
send(“func”, dict(arg1 = a, arg2 = b, arg3 = c));

17. Data Driven API Style
class Stack
{
public:
Stack();
Result Command(const std::string &command, const
ArgList *args);
};

18. Data Driven API Style 호출할때
s = new Stack();
if (s)
{
s->Command(“Push”, ArgList().Add(“value”, 10));
s->Command(“Push”, ArgList().Add(“value”, 3));
Stack::Result r = s->Command(“IsEmpty”);
while (!r.convertToBool())
{
s->Command(“Pop”);
r = s->Command(“IsEmpty”);
}
delete s;
}
Tip: QT의 QVariant, Boost의 any, Union, void*, 상속 등을 이용해
가변 파라미터를 이용 할 수 있다

19. Data Driven API Style의 실행 데
이터 파일
# Input file for data driven Stack API
Push value:10
Push value:3
Pop
Pop

20. Data Driven Style 장점
•
비즈니스 로직을 외부로 분리하기 용이, 재컴파일 없이
비즈니스 로직 수정
•
API 하위 버전 호환성 유리
•
•
필요없는 실행 커맨드는 처리 안하면 그만
테스트 자동화 유리

21. Data Driven Style 단점
•
런타임 성능
•
헤더 파일로 인터페이스 의미를 전달 하기 어려워 문서화
필수
•
타입체크, 유효성 체크 어려움

22. Flat C, OO, Template
Based, Data-Driven

23. 끝