C++ of the Day #44 - SQLite3 C++ wrapper #2

지난 번에 이어 구현중인 SQLite3 C++ wrapper에 대해 살펴보겠습니다. 먼저 이 wrapper의 이름을 sqlite3++로 결정했습니다. 물론 코드안에서와 같이 특수 문자를 사용할 수 없는 경우에는 sqlite3pp라는 이름을 사용합니다.

지난번 글의 내용에서 변경된 사항들에 대해 먼저 알아보죠.

먼저 몇몇 클래스와 함수들의 이름을 알기 쉽게 바꾸었습니다. 다음이 바뀐 이름들의 목록입니다.

1. connection --> database


2. connection::open --> database::connect


3. connection::close --> database::disconnect


4. command::step --> command::execute


5. command::finalize --> command::finish

클래스 상속 관계도 수정이 되었으나 사용자들에게 보이는 변경 사항은 없습니다.

그리고 command::step() 함수의 성공시에 SQLITE_DONE(101)이 출력되던 것을 다른 함수들과의 일관성을 위해 command::execute() 함수는 SQLITE_OK(0)를 리턴하도록 수정하였습니다. 이제 sqlite3++에서 함수의 성공 여부는 리턴값이 0인지를 확인하면 됩니다.

다음으로 SQLite3에서 지원하는 busy_handler, commit_hook, rollback_hook, update_hook, authorizer_handler와 같은 callback 함수들을 등록하는 인터페이스를 database 클래스에 추가하였습니다. 사용하는 방법은 다음과 같이 몇가지가 있습니다. ((boost::function을 사용하여 다양한 타입으로 등록할 수 있도록 구현하였습니다.))

먼저 일반 함수 포인터를 사용하는 방법입니다.

int handle_authorize(int evcode, char const* p1, char const* p2, char const* dbname, char const* tvname) {
  cout << "handle_authorize(" << evcode << ")" << endl;
  return 0;
}
// ...
db.set_authorize_handler(&handle_authorize);

이런 callback 함수에 user data가 필요한 경우에는 이를 클래스로 만들어 멤버 함수 포인터를 등록할 수도 있습니다. 아래 코드에서는 boost::bind를 사용하여 멤버 함수 포인터를 전달하고 있습니다.

struct handler
{
  handler() : cnt_(0) {}

  void handle_update(int opcode, char const* dbname, char const* tablename, int64_t rowid) {
    cout << "handle_update(" << opcode << ", " << dbname << ", " << tablename << ", " << rowid << ") - " << cnt_ << endl;
    ++cnt_;
  }
  int cnt_;
};
// ...
handler h;
db.set_update_handler(bind(&handler::handle_update, &h, _1, _2, _3, _4));

물론 일반 functor를 만들어 사용할 수도 있습니다.

struct rollback_handler
{
  void operator()() {
    cout << "handle_rollback - " << cnt << endl;
    ++cnt;
  }
  int cnt;
};
// ...
db.set_rollback_handler(rollback_handler());

게다가 위의 경우처럼 함수의 내용이 간단한 경우 boost::lambda를 사용할 수도 있죠. :-)

db.set_rollback_handler(cout << constant("handle_rollback\n"));

위의 rollback_handler는 리턴값이 void라 위와 같이 쉽게 사용이 가능하지만 commit_handler와 같이 리턴값이 있는 경우에는 다음과 같이 boost::lambda의 , (comma) operator를 사용하여 리턴값을 지정해 주어야 합니다. 이때는 함수 인자로 인식하지 않도록 괄호를 추가로 사용해야 합니다.

db.set_commit_handler((cout << constant("handle_commit\n"), 0));

이 기능외에도 하나의 database 세션에서 다른 db 파일을 연결해서 쓸 수 있는 attach/detach 기능이나 enable_shared_cache() 기능을 위한 인터페이스도 추가되었습니다.



현재까지 작성된 코드들을 Google Code에 등록해 두었습니다. 다음 링크를 통해 현재 구현중인 코드를 확인할 수 있습니다.

http://sqlite3pp.googlecode.com/svn/trunk/

다음 글에서는 sqlite3++의 마지막 시간으로 SQLite3에서 제공하는 extension에 대한 C++ wrapping에 대해 작성해 보도록 하겠습니다. :-)