thrift学习小结

Thrift－java学习小结

Thrift是什么？什么情况下使用thrift

Thrift源于大名鼎鼎的facebook之手，在2007年facebook提交Apache基金会将Thrift作为一个开源项目，对于当时的facebook来说创造thrift是为了解决facebook系统中各系统间大数据量的传输通信以及系统之间语言环境不同需要跨平台的特性。所以thrift可以支持多种程序语言，例如: C++, C#, Cocoa, Erlang, Haskell, Java, Ocami, Perl, PHP, Python, Ruby, Smalltalk. 在多种不同的语言之间通信thrift可以作为二进制的高性能的通讯中间件，支持数据(对象)序列化和多种类型的RPC服务。Thrift是IDL(interface definition language)描述性语言的一个具体实现，Thrift适用于程序对程序静态的数据交换，需要先确定好他的数据结构，他是完全静态化的，当数据结构发生变化时，必须重新编辑IDL文件，代码生成，再编译载入的流程，跟其他IDL工具相比较可以视为是Thrift的弱项，Thrift适用于搭建大型数据交换及存储的通用工具，对于大型系统中的子系统间数据传输相对于JSON和xml无论在性能、传输大小上有明显的优势。

Thrift 基础架构

Thrift是一个服务端和客户端的架构体系，就是socket传输，Thrift 具有自己内部定义的传输协议规范(TProtocol)和传输数据标准(TTransports)，通过IDL脚本对传输数据的数据结构(struct) 和传输数据的业务逻辑(service)根据不同的运行环境快速的构建相应的代码，并且通过自己内部的序列化机制对传输的数据进行简化和压缩提高高并发、大型系统中数据交互的成本，下图描绘了Thrift的整体架构，分为6个部分：1.你的业务逻辑实现(You Code) 2.客户端和服务端对应的Service 3.执行读写操作的计算结果4.TProtocol 5.TTransports 6.底层I/O通信

Thrift脚本的数据类型

* Base Types：基本类型

bool Boolean, one byte

byte Signed byte

i16 Signed 16-bit integer

i32 Signed 32-bit integer

i64 Signed 64-bit integer

double 64-bit floating point value

string String

binary Blob (byte array)

* Struct：结构体类型

* Container：容器类型，即List、Set、Map

map Map from one type to another

list Ordered list of one type

set Set of unique elements of one type

* Exception：异常类型

* Service：定义对象的接口，和一系列方法

协议

Thrift可以让你选择客户端与服务端之间传输通信协议的类别，在传输协议上总体上划分为文本(text)和二进制(binary)传输协议, 为节约带宽，提供传输效率，一般情况下使用二进制类型的传输协议为多数，但有时会还是会使用基于文本类型的协议，这需要根据项目/产品中的实际需求：

* TBinaryProtocol –二进制编码格式进行数据传输。

* TCompactProtocol –这种协议非常有效的，使用Variable-Length Quantity (VLQ) 编码对数据进行压缩。

* TJSONProtocol –使用JSON的数据编码协议进行数据传输。

* TSimpleJSONProtocol –这种节约只提供JSON只写的协议，适用于通过脚本语言解析

* TDebugProtocol –在开发的过程中帮助开发人员调试用的，以文本的形式展现方便阅读。

传输层

* TSocket- 使用堵塞式I/O进行传输，也是最常见的模式。

* TFramedTransport- 使用非阻塞方式，按块的大小，进行传输，类似于Java中的NIO。

* TFileTransport- 顾名思义按照文件的方式进程传输，虽然这种方式不提供Java的实现，但是实现起来非常简单。

* TMemoryTransport- 使用内存I/O，就好比Java中的ByteArrayOutputStream实现。

* TZlibTransport- 使用执行zlib压缩，不提供Java的实现。

服务端类型

* TSimpleServer - 单线程服务器端使用标准的堵塞式I/O。

* TThreadPoolServer - 多线程服务器端使用标准的堵塞式I/O。

* TNonblockingServer –多线程服务器端使用非堵塞式I/O，并且实现了Java中的NIO通道。

Thrift运用实例

1、业务逻辑描述：一个系统通过用户身份证号获取另一个系统里有关这个用户的积分。

2、首先编写脚本文件test.thrift：

命名空间：

namespace java com.test

namespace是关键字表示命名空间，也就是java的包，java表示脚本转换成java类

请求：identitycard是身份证号

struct UserRequest

{

1:string identitycard

}

返回：code是成功标识0表示成功；integral是用户拥有的积分

Params是返回的参数集合这里只用一个字段积分（integral）做例子；

struct UserResponse

{

1:string code

2:map params

}

服务：

service ThriftCase

{

UserResponse integralService(1: UserRequest request)

}

3、到thrift官网下载

https://www.360docs.net/doc/7f17552122.html,/

下载：thrift-0.6.1.tar.gz和Thrift compiler for Windows (thrift-0.6.1.exe)

4、用eclips里面的ant工具把thrift-0.6.1编译出jar包

解压：thrift-0.6.1.tar.gz

把解压后的文件夹放到eclipse的某个工程下如图：

如上图thrift-0.6.1文件夹放在名字是thrift的java工程的src下，有红叉不必管他，然后进入到thrift-0.6.1/lib/java中，右键点击build.xml

如图点击Ant Build。在build.xml同路径下会产生一个build文件夹里面有生成的thrift-0.6.1.jar包。把这个包放到所做的工程的lib里就行了。

5、把thrift脚本编译成java类

把thrift-0.6.1.exe和test.thrift文件放在同一个目录下并把路径写进环境变量Path中，如：E:/soft/ccc/路径下放入上述两个文件并把路径写进环境变量Path中。

在运行中键入cmd打开dos界面，进到E:/soft/ccc/路径下，执行thrift-0.6.1.exe文件，命令如下：

E:\soft\ccc\>Thrift-0.6.1 –gen java text.thrift

在这个目录下会产生一个gen－java文件夹，文件夹中会产生相应的java类,

ThriftCase.java

UserRequest.java

UserResponse.java

将三个文件拷贝到thrift工程的src/com/test/ 路径下。

6、编写服务端代码

服务端代码包含两个类：一个是业务逻辑类，一个是socket服务类。

业务逻辑类要实现ThriftCase.Iface服务接口

package com.test;

import java.util.HashMap;

import java.util.Map;

public class ThriftCaseImpl implements ThriftCase.Iface{

public UserResponse integralService(UserRequest request) {

try{

UserResponse urp=new UserResponse();

if(request.identitycard.equals("320106************")){

urp.setCode("0");

Map params=new HashMap();

params.put("integral", "10");

urp.setParams(params);

}

System.out.print("接收参数是：identitycard="+request.identitycard);

return urp;

}catch(Exception e){

e.printStackTrace();

}

return null;

}

}

Socket服务类

package com.test;

import org.apache.thrift.protocol.TBinaryProtocol;

import org.apache.thrift.protocol.TBinaryProtocol.Factory;

import org.apache.thrift.server.TServer;

import org.apache.thrift.server.TThreadPoolServer;

import org.apache.thrift.server.TThreadPoolServer.Args;

import org.apache.thrift.transport.TServerSocket;

import org.apache.thrift.transport.TTransportException;

public class TestService {

private void start(){

try {

TServerSocket serverTransport = new TServerSocket(8899);

ThriftCase.Processor processor = new ThriftCase.Processor(new ThriftCaseImpl());

// TBinaryProtocol –二进制编码格式进行数据传输。

Factory protFactory = new TBinaryProtocol.Factory(true,true);

//TCompactProtocol 这种协议非常有效的，使用Variable-Length Quantity (VLQ) 编码对数据进行压缩

//Factory protFactory = new TCompactProtocol.Factory();

Args args = new Args(serverTransport);

args.processor(processor);

args.protocolFactory(protFactory);

TServer server = new TThreadPoolServer(args);

System.out.println("Starting server on port 8899 ...");

server.serve();

} catch (TTransportException e) {

e.printStackTrace();

} catch (Exception e) {

e.printStackTrace();

}

}

public static void main(String[] args) {

// TODO Auto-generated method stub

TestService srv = new TestService();

srv.start();

}

}

7、客户端代码

package com.test;

import org.apache.thrift.TException;

import org.apache.thrift.protocol.TBinaryProtocol;

import org.apache.thrift.protocol.TProtocol;

import org.apache.thrift.transport.TSocket;

import org.apache.thrift.transport.TTransport;

import org.apache.thrift.transport.TTransportException;

import com.test.ThriftCase.Client;

public class TestClient {

private void start() {

TTransport transport;

try {

transport = new TSocket("localhost", 8899);

TProtocol protocol = new TBinaryProtocol(transport);

Client client = new Client(protocol);

UserRequest request=new UserRequest();

request.setIdentitycard("320106************");

transport.open();

https://www.360docs.net/doc/7f17552122.html,erResponse urp=client.integralService(request);

if(urp.code!=null&&!urp.code.equals("")){

System.out.println("返回代码："+urp.code+"; 参数是：

"+urp.params.get("integral"));

}

transport.close();

} catch (TTransportException e) {

e.printStackTrace();

} catch (TException e) {

e.printStackTrace();

}

}

public static void main(String[] args) {

TestClient c = new TestClient();

c.start();

}

}

8、先开启服务

public static void main(String[] args) {

// TODO Auto-generated method stub

TestService srv = new TestService();

srv.start();

}

控制台显示：

Starting server on port 8899 ...

9、再运行客户端

public static void main(String[] args) { TestClient c = new TestClient();

c.start();

}

控制台显示：

返回代码：0; 参数是：10

10、所需第三方包

log4j-1.2.15,

slf4j-api-1.6.1.jar

slf4j-log4j12-1.5.8.jar