Thrift框架使用教程

Thrift框架使用教程

注：这个框架的强大之处在于它只需要写一个简单的thrift脚本就能生成不同语言的SourceCode，这些SourceCode包含了几乎所有Client端以及Server端代码，

你只需要简单几句代码的调用就能达到想要的结果，轻松实现C-S交互的跨平台。

1.安装

下载页面：http://thrift.apache.org/download/

              其中，thrift-0.8.0.tar.gz 是Thrift对应不同语言的源码，我们需要它来编译Library。

              Thrift compiler for Windows (thrift-0.8.0.exe)是针对windows平台的编译器，我们需要它在windows上编译thrift脚本。

 

2.编写thrift脚本

编写thrift脚本的基本教程在官方wiki上有：

              http://wiki.apache.org/thrift/Tutorial

 

以下是一个最简单的例子：

 

struct RequestStruct

{

              1: i32 requestId

              2: i32 requestData

}//定义一个请求包结构

 

struct ResponseStruct

{

              1: i32 requestId

              2: string responseData

}//定义一个响应包结构

 

 

//定义一个收发数据服务接口

service SharedService

{

              ResponseStruct SendReceive(1: RequestStruct request)

}

 

我们把它命名为sample.thrift

 

3.编译thrift脚本

解压下载好的windows编译器，执行以下命令行对脚本进行编译：

              thrift_0.8.0_win32.exe -r --gen csharp sample.thrift

其中，上面的csharp是要编译的目标语言，可以替换成你想要的语言。

编译生成的代码在gen-csharp文件夹里。

 

4.编译Library

解压下载好的Thrift源码，在lib文件夹下找到你所需语言的源码工程，使用该工程编译所需的Library。

 

5.使用

(1) 先把从thrift脚本编译得到的代码和编译好的Library添加到你的项目里。

 

(2) Client端使用例子：

              //创建传输协议，这里用的是Socket，你也可以用Http等其它Thrift支持的协议

              TTransport transport =newTSocket("localhost", 9090);

       //创建数据交互协议，这里用的是Binary，你也可以用Jason等Thrift支持的协议

       TProtocol protocol =newTBinaryProtocol(transport);

       //创建client，这个Client是由thrift脚本自动生成的

       SharedService.Client client = newSharedService.Client(protocol);

       //与服务器交互开始

       transport.Open();

       //发送一个请求并等待服务器返回结果

       //请求包是由脚本的SendReceive接口的参数指定，下面的request就是请求包

              //响应包是由脚本的SendReceive接口的返回值指定，下面的result就是接收包

       RequestStruct request = newRequestStruct

       {

              RequestId= 0,

              RequestData= 1

       };

       ResponseStruct result = client.SendReceive(request);

       //停止交互

       transport.Close();

 

(3）Server端使用例子：

       //Server端首先要实现Iface接口，在这里对client端的请求进行处理，返回结果数据

       classServerHandler :SharedService.Iface

       {

              publicServerHandler(){}

 

              publicResponseStruct SendReceive(RequestStruct request)

              {

                     ResponseStruct result = newResponseStruct()

                     {

                            RequestId = request.RequestId,

                            RequestData ="This is a return value from server"

                     };

                     return result;

              }

       }

 

       //根据我们上面实现的请求处理类，创建一个请求处理器

       ServerHandler handler = newServerHandler();

       SharedService.Processor processor = newSharedService.Processor(handler);

       //创建Server端传输协议并监听端口，这里的传输协议要与client端一致

       TServerTransport serverTransport =newTServerSocket(9090);

       //创建一个server，你也可以用多线程等Thrift支持的Server

       TServer server =newTSimpleServer(processor, serverTransport);

       //启动server并开始监听

       server.Serve();

 

 

好了，欢呼吧，就这样完成了，你是不是很惊讶使用thrift完成一个基本的C-S交互居然如此简单！！！！