Thrift とは

このドキュメントの内容は、以下の通りです。

• thrift コンパイラ
• データ型
• thrift ファイルから生成する
• 例
• Thrift 定義ファイル
• Python クライアント
• C++ サーバ
• 合わせて読む

• thrift コンパイラをインストールする
• thrift インタフェース .thrift ファイルを作成する
• thrift を用いて、スケルトンを生成する
• スケルトンを利用して、サーバ、クライアントを実装する

thrift コンパイラ

データ型

• 基本データ型
• 構造体
• コンテナ
• list
• set
• map
• 例外

• bool: ブール値 (true or false)
• byte: 8-bit 符号付き整数
• i16: 16-bit 符号付き整数
• i32: 32-bit 符号付き整数
• i64: 64-bit 符号付き整数
• double: 64-bit 浮動小数点
• string: UTF-8 エンコーディングのテキスト文字列

• binary: 非エンコードバイト列

thrift ファイルから生成する

thrift --gen <language> <Thrift filename>

例

Thrift 定義ファイル

struct UserProfile {
	1: i32 uid,
	   2: string name,
	   3: string blurb
}
service UserStorage {
	void store(1: UserProfile user),
	     UserProfile retrieve(1: i32 uid)
}

Python クライアント

# Make an object
up = UserProfile(uid=1,
		name="Test User",
		blurb="Thrift is great")

transport = TSocket.TSocket("localhost", 9090)
transport.open()

# Use the service we already defined
service.store(up)

# Retrieve something as well
up2 = service.retrieve(2)

C++ サーバ

class UserStorageHandler : virtual public UserStorageIf {
public:
	UserStorageHandler() {
		// 初期化
	}

	void store(const UserProfile& user) {
		printf("store\n");
	}
	void retrieve(UserProfile& _return, const int32_t uid) {
		printf("retrieve\n");
	}
};

int main(int argc, char **argv) {
	int port = 9090;
	shared_ptr handler(new UserStorageHandler());
	shared_ptr processor(new UserStorageProcessor(handler));
	shared_ptr transportFactory(
			new TBufferedTransportFactory());
	TSimpleServer server(processor,
			serverTransport,
			transportFactory,
			protocolFactory);
	return 0;
}

合わせて読む

• [2012-03-31-1] FreeBSD thrift をインストールする
• [2012-04-01-1] FreeBSD php5-thrift をインストールする