HelloWorld by Thrift

Thrift 是什么

The Apache Thrift software framework, for scalable cross-language services development, combines a software stack with a code generation engine to build services that work efficiently and seamlessly between C++, Java, Python, PHP, Ruby, Erlang, Perl, Haskell, C#, Cocoa, JavaScript, Node.js, Smalltalk, OCaml and Delphi and other languages.

from : http://thrift.apache.org/
翻译：
Apache Thrift 是一个可扩展的用来实现跨语言服务的开发框架。
它组合一个代码生成引擎和一个软件栈来创建下面各种语言 （C++, Java, Python, PHP, Ruby, Erlang, Perl, Haskell, C#, Cocoa, JavaScript, Node.js, Smalltalk, OCaml and Delphi 。。。 ）之间的高效无缝的服务。

---

Thrift 的安装

环境 : OpenSUSE , 64bit
参见：

http://thrift.apache.org/docs/BuildingFromSource

1. 下载源码zip并解压。
2. 于Thrift根目录执行 ./configure
3. 于Thrift根目录执行 ./make

期间遇到提示某库（比如 libevent） 没有装好， 就使用zypper（类似Ubuntu 的apt-get) 默认安装 .
在编译test的时候遇到Makefile的问题， gen-cpp 内头文件无法include， 就是用thrift 命令手动生成之（ 或者先删除对应Makefile命令 ， 木有关系） 。

Thrift 的基本概念

参见

http://thrift.apache.org/docs/concepts

软件栈概念图：

  +-------------------------------------------+  | Server                                    |  | (single-threaded, event-driven etc)       |  +-------------------------------------------+  | Processor                                 |  | (compiler generated)                      |  +-------------------------------------------+  | Protocol                                  |  | (JSON, compact etc)                       |  +-------------------------------------------+  | Transport                                 |  | (raw TCP, HTTP etc)                       |  +-------------------------------------------+

实际是Thrift 是采用RPC（远程调用） 的概念实现跨语言的， Transport层负责使用指定协议（TCP / HTTP / FILE / PIPE … ) 交换数据， Protocol 层负责用指定的协议（ JSON ,Binary ， XML … ) 编解码数据， Processor 层是我们自己code的层， 负责 接口的具体实现（ server端 ） / 对接口的调用使用 （ client 端） 。 Server 层实际是是对下面3层的整合， 当 client 连接到server调用某个接口的时候， Processor 按照接口规定准备数据， Protocol 按照配置编码数据， 通过Transport 层按照指定的协议发送数据， server 通过Transport收到数据后， Protocol 解码数据， Processor 层使用数据真正的调用接口，完成逻辑， 如果有返回值的话， 再按照相反的流程传回client 。 见下图 ：

---

使用Thrift 写HelloWorld

Thrift 除了 Processor 的实现和server的配置之外， 其他的代码都会给自动生。
首先， 我们要定义接口 ， 使用 Thrift 定义的自己的IDL （ interface description language ） ，

hello.thrift

service Hello {  string getString()}

---

我的服务器端使用C++ ， 所以先生成对应的C++代码 ：

thrift --gen cpp hello.thrift

自动生成gen-cpp 文件夹， 打开里面的hello.h 头文件， 找到下面的接口 ：

class HelloIf { public:  virtual ~HelloIf() {}  virtual void getString(std::string& _return) = 0;};

为服务器接口添加实现代码 helloServer.cpp ( 由生成的 Hello_server.skeleton.cpp 修改成）：

#include <thrift/concurrency/ThreadManager.h>#include <thrift/concurrency/PosixThreadFactory.h>#include <thrift/protocol/TBinaryProtocol.h>#include <thrift/server/TSimpleServer.h>#include <thrift/server/TThreadPoolServer.h>#include <thrift/server/TThreadedServer.h>#include <thrift/transport/TServerSocket.h>#include <thrift/transport/TTransportUtils.h>#include <thrift/TToString.h>#include <iostream>#include <stdexcept>#include <sstream>#include "gen-cpp/Hello.h"using namespace std;using namespace apache::thrift;using namespace apache::thrift::concurrency;using namespace apache::thrift::protocol;using namespace apache::thrift::transport;using namespace apache::thrift::server;class HelloHandler : public HelloIf{    public:        virtual void getString(string& _return) {            _return = "Hello World\n";    }};int main(int argc, char **argv) {  boost::shared_ptr<TProtocolFactory> protocolFactory(new TBinaryProtocolFactory());  boost::shared_ptr<HelloHandler> handler(new HelloHandler());  boost::shared_ptr<TProcessor> processor(new HelloProcessor(handler));  boost::shared_ptr<TServerTransport> serverTransport(new TServerSocket(9090));  boost::shared_ptr<TTransportFactory> transportFactory(new TBufferedTransportFactory());  TSimpleServer server(processor,                       serverTransport,                       transportFactory,                       protocolFactory);  cout << "Starting the server..." << endl;  server.serve();  cout << "Done." << endl;  return 0;}

---

客户端也C++语言 （ 好吧我最熟悉这个）

#include <iostream>#include <thrift/protocol/TBinaryProtocol.h>#include <thrift/transport/TSocket.h>#include <thrift/transport/TTransportUtils.h>#include "gen-cpp/Hello.h"using namespace std;using namespace apache::thrift;using namespace apache::thrift::protocol;using namespace apache::thrift::transport;int main(int argc, char** argv) {  boost::shared_ptr<TTransport> socket(new TSocket("localhost", 9090));  boost::shared_ptr<TTransport> transport(new TBufferedTransport(socket));  boost::shared_ptr<TProtocol> protocol(new TBinaryProtocol(transport));  HelloClient client(protocol);  transport->open();  string hello;  client.getString(hello);  cout<<hello;  transport->close();}

---

Cmake 维护工程 ：

cmake_minimum_required(VERSION 3.0)PROJECT (helloWord)INCLUDE_DIRECTORIES(./gen-cpp)SET( SERVER_FILES helloServer.cpp)SET( LIB_SOURCE  ./gen-cpp/Hello.cpp ./gen-cpp/hello_constants.cpp ./gen-cpp/hello_types.cpp )ADD_EXECUTABLE(server  ${SERVER_FILES} ${LIB_SOURCE} ) TARGET_LINK_LIBRARIES(server -lthrift)  

编译 ：

mkdir build
cd build
cmake ,,
make

---

先启动server ， 然后启动client 输出 ：

Hello World

---