Thrift在Windows及Linux平台下的安装和使用示例

本文章也同时发表在我的博客Thrift在Windows及Linux平台下的安装和使用示例上。html

thrift介绍

Apache Thrift 是 Facebook 实现的一种高效的、支持多种编程语言的RPC(远程服务调用)框架。linux

本文主要目的是分别介绍在Windows及Linux平台下的Thrift安装步骤,以及实现一个简单的demo演示Thrift的使用方法。更多Thrift原理留在之后再行介绍。git

thrift安装

源码下载:thrift官网,或者thrift-github地址,我下载的是thrift-0.9.3.tar.gzgithub

安装依赖库

  1. boost
    boost的编译就再也不这里介绍了,我分别使用了boost1.55或boost1.49编译经过;
  2. libevent
    按需编译,若是不须要异步server就能够不编译libevent,不然能够点此下载libevent-2.0.21-stable;
  3. openssl
    下载针对你系统版本的openssl库,windows下有编译好的二进制文件,能够直接下载,32位/62位系统openssl; Linux发行版通常都自带ssl库;

thrift在Windows下的安装

我是在Windows7 64bit, VS2010编译的。 Windows下编译倒也不麻烦,简单介绍以下:apache

  1. 解压缩源代码,进入到lib\cpp目录下,打开Thrift.sln,里面有libthrift和libthriftnb两个工程,其中libthrift工程是常规的阻塞型server端(单线程server,一个链接一个线程server,线程池server),libthriftnb工程是非阻塞(non-blocking)模式的服务server端,也只有编译libthriftnb时才须要依赖libevent库,不然能够不编译libevent库;
  2. 设置依赖库头文件和库文件,这就再也不介绍了;
  3. 编译,顺利的话就OK了,会在lib\cpp\Debug目录下生成libthrift.lib和libthriftnb.lib(若是编译的话);

说明: thrift-0.9.3这一版的release其实在windows下是编译不过的,由于vs工程中要编译的Thrift.cpp已经不存在了,从工程中移除就能够顺利编译了,参考thrift-pull-739编程

另外还能够自行编译thrift文件的生成工具,固然也能够直接从官网下载,这里给出编译步骤:windows

  1. 将compiler\cpp\src\windows\version.h.in文件拷贝到compiler\cpp\src\目录下,并重命名为version.h;
  2. 到compiler\cpp目录下,打开compiler.sln,编译便可

thrift在linux(Centos)下的安装

我是在Centos6.4 64bit,g++ 4.4.7编译的,编译很简单,分别可使用cmake或者make工具进行编译,这里再也不多作介绍,固然,编译过程当中缺乏了某些库什么的,就先按照便可,更详细的步骤请看本文的参考文章连接。centos

开发步骤

  1. 写一个.thrift文件,也就是IDL(Interface Description File,接口描述文件);
  2. 用Thrift的IDL生成工具(windows下就是上面提供下载连接的thrift-0.9.1.exe, Linux下就是/usr/local/bin/thrift程序) ,而后根据须要生成目标语言代码;
  3. server端程序引入第2步生成的代码,实现RPC业务代码;
  4. client端程序引入第2步生成的代码,实现RPC调用逻辑;
  5. 用第4步生成的程序就能够调用第3步实现的远程服务了;

入门示例

下面就演示一个简单的server端和client端程序。框架

设计thrift文件(IDL)

假设实现这么一个简单服务,client经过hello接口发送本身的名字,且须要server端回复,好比 hello.thrift:异步

service HelloService
{
    void hello(1: string name);
}

经过IDL工具生成源代码

执行thirift命令生成源文件:

thrift --gen cpp hello.thrift                 # centos下
thrift-0.9.3.exe --gen cpp hello.thrift   # Windows下

以上命令表示生成C++语言的源代码,而后会生成一个gen-cpp目录,里面包含自动生成的几个源代码文件:

hello_constants.cpp
hello_constants.h
HelloService.cpp
HelloService.h
HelloService_server.skeleton.cpp
hello_types.cpp
hello_types.h

实现server端程序

HelloService_server.skeleton.cpp就是默认的server端程序入口,能够直接修改该文件,或者拷贝一份再作修改(我是拷贝并重命名为server.cpp),以便增长本身的逻辑处理:

class HelloServiceHandler : virtual public HelloServiceIf {
 public:
  HelloServiceHandler() {
    // Your initialization goes here
  }

  void hello(const std::string& name) {
    // Your implementation goes here
    // 这里只简单打印出client传入的名称
    printf("hello, I got your name %s\n", name.c_str());
  } 
};

若是是在linux平台下,直接经过g++编译:

g++ -o server hello_constants.cpp  HelloService.cpp hello_types.cpp  server.cpp -I/usr/local/include/thrift -L/usr/local/lib -lthrift

若是是在Windows平台下,经过vs2010新建win32控制台工程,将gen-cpp目录下的全部文件复制到新工程下,设置头文件包含和lib库目录。 好比设置libthrift.lib的头文件目录为thrift-0.9.3\lib\cpp\src\thrift,lib库目录为thrift-0.9.3\lib\cpp\Debug。

实现client端程序

由于没有默认的client实现,因此须要新建一个client.cpp文件,本身增长实现:

#include <stdio.h>
#include <string>
#include "transport/TSocket.h"
#include "protocol/TBinaryProtocol.h"
#include "server/TSimpleServer.h"
#include "transport/TServerSocket.h"
#include "transport/TBufferTransports.h"
#include "hello_types.h"
#include "HelloService.h"
using namespace ::apache::thrift;
using namespace ::apache::thrift::protocol;
using namespace ::apache::thrift::transport;
using namespace ::apache::thrift::server;
using boost::shared_ptr;

int main(int argc, char** argv)
{
    shared_ptr<TTransport> socket(new TSocket("localhost", 9090));
    shared_ptr<TTransport> transport(new TBufferedTransport(socket));
    shared_ptr<TProtocol> protocol(new TBinaryProtocol(transport));
    HelloServiceClient client(protocol);
    try
    {
        transport->open();
        client.hello("cpper.info");
        transport->close();
    }
    catch(TException& tx)
    {
        printf("ERROR:%s\n",tx.what());
    }
}

若是是在linux平台下,直接经过g++编译:

g++ -o client client.cpp hello_constants.cpp  HelloService.cpp hello_types.cpp -I/usr/local/include/thrift -L/usr/local/lib -lthrift

若是是在Windows平台下,经过vs2010新建win32控制台工程,将gen-cpp目录下的全部文件(除HelloService_server.skeleton.cpp以外)复制到新工程下,并增长上面手动实现的client.cpp。

经过以上步骤,就实现一个简单的RPC server和client程序了,能够分别运行进行测试看看效果怎么样。

Reference

Thrift官方安装手册(译)