[转]thrift 轻松实现多语言跨服务器通信

作者：ys250

来源：http://www.ys250.com/2010/07/03/thrift_py_php/

thrift是由facebook开发的轻量级跨语言的服务框架，现在已经移交到apache基金会下。和他类似的是google出的protocol buffer和ice。 thrift的一大优势就是支持的语言很丰富，它使用自己的IDL语言来描述服务接口和数据交换的格式。

官方网站：http://incubator.apache.org/thrift/

一、安装：

yum -y install gcc-c++ autoconf automake sysconftool boost \
    boost-devel libtool perl-ExtUtils-MakeMaker gettext-base \
    gettext gettext-devel liblocale-gettext-perl zlib-devel \
    byacc bison flex pkgconfig python-devel 

wget http://apache.freelamp.com/incubator/thrift/0.2.0-incubating/thrift-0.2.0-incubating.tar.gz

./bootstrap.sh 
./configure --prefix=/usr/local/thrift --with-ruby=no --with-erlang=no --with-java=no --with-csharp=no --enable-gen-java=no --enable-gen-csharp=no --enable-gen-rb=no --enable-gen-erl=no
make
make install

二、IDL描述：

# 1.支持的变量类型
 
类型			描述  
bool			#true, false  
byte			#8位的有符号整数  
i16				#16位的有符号整数  
i32				#32位的有符号整数  
i64				#64位的有符号整数  
double			#64位的浮点数  
string			#UTF-8编码的字符串  
binary			#字符数组  
struct			#结构体  
list<type>		#有序的元素列表，类似于STL的vector  
set<type>		#无序的不重复元素集，类似于STL的set  
map<type1,type2>	#key-value型的映射，类似于STL的map  
exception		#是一个继承于本地语言的exception基类  
service			#服务包含多个函数接口(纯虚函数)  
 
# 2.摘一段例子上来，让瞧瞧这是啥东东。（本例子文件名为：tutorial.thrift，是本身带的教程。）
include "shared.thrift"
 
 
namespace cpp tutorial
namespace java tutorial
namespace php tutorial
namespace perl tutorial
namespace smalltalk.category Thrift.Tutorial
 
typedef i32 MyInteger
 
const i32 INT32CONSTANT = 9853
const map<string,string> MAPCONSTANT = {'hello':'world', 'goodnight':'moon'}
 
enum Operation {
  ADD = 1,
  SUBTRACT = 2,
  MULTIPLY = 3,
  DIVIDE = 4
}
 
struct Work {
  1: i32 num1 = 0,
  2: i32 num2,
  3: Operation op,
  4: optional string comment,
}
 
exception InvalidOperation {
  1: i32 what,
  2: string why
}
 
service Calculator extends shared.SharedService {
 
   void ping(),
 
   i32 add(1:i32 num1, 2:i32 num2),
 
   i32 calculate(1:i32 logid, 2:Work w) throws (1:InvalidOperation ouch),
 
   oneway void zip()
 
}
 
# 3. 我们来写个 helloworld.thrift
 
service HelloWorld{
 string ping(1: string name),
 string getpng(),
}

三、编译 helloworld：

/usr/local/thrift/bin/thrift -r --gen py helloworld.thrift
/usr/local/thrift/bin/thrift -r --gen php helloworld.thrift
#会在当前目录下生成 gen-* 目录。

四、编写服务器端：

import sys
sys.path.append('./gen-py')
 
from helloworld import HelloWorld
from helloworld.ttypes import *
 
from thrift.transport import TSocket
from thrift.transport import TTransport
from thrift.protocol import TBinaryProtocol
from thrift.server import TServer
 
class HellowordHandler:
	def __init__ (self):
		pass
 
	def ping (self, name):
		print name + ' from server.'
		return "%s from server." % name
	def getpng (self):
		f = open("./logo.png", "rb")
		c = f.read()
		f.close()
		return c
handler = HellowordHandler()
processor = HelloWorld.Processor(handler)
transport = TSocket.TServerSocket(9090)
tfactory = TTransport.TBufferedTransportFactory()
pfactory = TBinaryProtocol.TBinaryProtocolFactory()
 
server = TServer.TSimpleServer(processor, transport, tfactory, pfactory)
 
# You could do one of these for a multithreaded server
#server = TServer.TThreadedServer(processor, transport, tfactory, pfactory)
#server = TServer.TThreadPoolServer(processor, transport, tfactory, pfactory)
 
print 'Starting the server...'
server.serve()
print 'done.'

五、编写客户端：

<?php
try{
 
	$GLOBALS['THRIFT_ROOT'] = './php/src'; 
	require_once $GLOBALS['THRIFT_ROOT'].'/Thrift.php';
	require_once $GLOBALS['THRIFT_ROOT'].'/protocol/TBinaryProtocol.php';
	require_once $GLOBALS['THRIFT_ROOT'].'/transport/TSocket.php';
	require_once $GLOBALS['THRIFT_ROOT'].'/transport/THttpClient.php';
	require_once $GLOBALS['THRIFT_ROOT'].'/transport/TBufferedTransport.php';
	error_reporting(E_NONE);
	$GEN_DIR = './gen-php';
	require_once $GEN_DIR.'/helloworld/HelloWorld.php';
	error_reporting(E_ALL);
 
	$socket = new TSocket('*.*.*.*', 9090);
	$transport = new TBufferedTransport($socket, 1024, 1024);
	$protocol = new TBinaryProtocol($transport);
	$client = new HelloWorldClient($protocol);
 
	$transport->open();
 
	$a = $client->ping('xyq ');
	echo $a;
 
	$transport->close();
 
	} catch (TException $tx) {
		print 'TException: '.$tx->getMessage()."\n";
	}
 
?>

按上面的流程就可以写自己的thrift了，我使用py做服务端，用php做客户端，当然也可以使用c++来做服务端。

相关文章：

thrift 安装 http://wiki.apache.org/thrift/ThriftInstallation
redis + thrift + mongodb 数据测试 http://www.ys250.com/2010/09/02/redis-thrift-mongodb-test/
Thrift基本使用 http://hi.baidu.com/infant/blog/item/01fa53436adc79189313c69e.html