Thrift 框架分析1

最新推荐文章于 2024-03-05 10:34:36 发布

kohaku

最新推荐文章于 2024-03-05 10:34:36 发布

阅读量4.9k

点赞数

文章标签：框架 socket service 语言服务器 exception

本文链接：https://blog.csdn.net/kohaku/article/details/5701774

版权

本文先整体性地介绍Thrift框架，然后分析Thrift源码中自带的toturial例子，作为Thrift的入门吧。

一．Thrift介绍

Thrfit是一种开源的跨语言的服务部署框架，这里的服务是指RPC，即远程过程调用了。它最初是由Facebook开发的，后来Facebook将其开源了。

因此你可以很方便地下载到它的源代码，下载地址为：http://incubator.apache.org/thrift/download/

Thrift的体系架构如下：

实际上Thrift提供了一个支持多语言的Lib库，包括C++、Java、PHP、Python、Ruby等。同时它自定义了一种中间语言(Thrift IDL)，

用于编写统一格式的thrift配置文件，定义数据类型。然后根据此配置文件调用lib库中的生成器来生成指定语言的服务，这正体现其跨语言的特性。

Thrift支持五种数据类型：
Base Types：基本类型
Struct：结构体类型
Container：容器类型，即List、Set、Map
Exception：异常类型
Service：类似于面向对象的接口定义，里面包含一系列的方法

下面是Thrift中所支持的类型(前三种类型)

Thrift通过两种抽象机制来完成底层客户端和服务器端的通信，分别是:

1) Transport：抽象了底层网络通信部分的接口
TTransport对Java I/O层进行封装，抽象了底层网络通信部分的接口。主要是对以下6种接口进行了抽象：open, close, isopen, read, write, flush。

2) Protocol：抽象了对象在网络中传输部分的接口，它规定了thrift的RPC可以调用的接口。这些接口是为了传输不同类型的数据而设计的。

Transport在传输数据时是不区分所传的数据类型的，一律以流的形式传输。所以Protocol类在Transport类之上实现了按数据类型来传输数据。

Transport的类结构实现：

socket的封装

TTransport是一个抽象的基类，对socket进行了封装，提供了对流的一系列操作接口。thrift提供了两种常用类型的Socket，一种是阻塞式的，两外一种是非阻塞式的。

这两种socket的区别实际上就是传统IO和NIO的区别，这里就不累述了。通过close()和open()来建立和关闭连接；通过read()和write()来对流进行读写。

ServerSocket的封装

TServerSocket同样是一个抽象的基类，对ServerSocket进行了封装。它是以非阻塞的IO方式进行通讯的。通过listen()来监听连接请求，通过accept()来获取。

Protocol的类结构实现：

TProtocol提供了一系列按类型进行读写的接口。并持有一个TTransport对象的引用，所以TProtocol类是依赖于TTransport类的。

其中定义了一系列的write和read方法，应该说每种类型对应一套write和read方法。在write和read方法中会分别调用TTransport

中的write和read方法进行实际的读写操作。

RPC的具体实现：

1. TProcessor

它是thrift中最简单的一个接口了，仅包含一个方法：
bool process(TProtocol in, TProtocol out)throws TException

此方法有两个参数in和out，分别用于从socket中读取数据和向scoket中写数据。每个service对象中都会包含一个实现了此接口的类对象(Process),

这个类就是处理RPC请求的核心。

2. TServer

TServer相当于一个容器，拥有生产TProcessor、TTransport、TProtocol的工厂对象。它的工作流如下：

1) 使用TServerTransport来获取一个TTransport(客户端的连接)

2) 使用TTransportFactory来将获取到的原始的transport转化为特定的transport

3) 使用TProtocolFactory来为获取TTransport的输入输出，即TProtocol

4) 唤醒TProcessor的process方法，处理请求并返回结果

二. tutorial 分析

现在结合一个例子来研究如何应用Thrift。例子就是thrift源代码中自带的tutorial，测试语言方面则选择java。

在此之前，必须安装好Thrift，安装过程就不累述了，可以参考thrift中的readme文件。

1.我们可以使用Ant工具将thrift的java lib打包成jar文件，这样可以直接导入Eclipse使用。

进入到tutorial根目录，里面有两个文件.thrift，这就是上面讲到的配置文件了，里面定义了我们要提供的服务。下面是其中的一个文件的内容：

include "shared.thrift" 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() }

2.输入如下命令生成代码：thrift -r --gen java tutorial.thrift

完成后，会发现多了一个gen-java的文件夹，这就是生成的代码。我们看下代码结构：

两个service类(ShareService和Calculator)均包含两个内部类：Client和Processor，前者用于客户端，后者用于服务器端。

这两个类均包含一套service方法的实现(ping、add、calculate、zip)，RPC就是基于这套共用方法实现的。

3.经过上面的两步，我们得到了两个jar文件，libthrift.jar和tutorial.jar，至此环境已经部署完成。分别运行JavaServer和JavaClient，开启服务器端

和客户端，观察运行结果。

JavaServer.java

public class JavaServer { public static class CalculatorHandler implements Calculator.Iface {//实现了Iface接口 private HashMap<Integer,SharedStruct> log; public CalculatorHandler() { log = new HashMap<Integer, SharedStruct>(); } public void ping() {//具体实现ping方法 System.out.println("ping()"); } //add()、caculator().... } public static void main(String [] args) { try { CalculatorHandler handler = new CalculatorHandler();//具体实现了service中的方法 Calculator.Processor processor = new Calculator.Processor(handler);//初始化Processor类 TServerTransport serverTransport = new TServerSocket(9090);//实例化一个ServerSocket TServer server = new TSimpleServer(processor, serverTransport);//实例化一个TServer System.out.println("Starting the server..."); server.serve();//开始服务，监听请求并获取，激活Processor中的processor方法 } catch (Exception x) { x.printStackTrace(); } System.out.println("done."); } }

JavaClient.java

public class JavaClient { public static void main(String [] args) { try { TTransport transport = new TSocket("localhost", 9090);//打开连接 TProtocol protocol = new TBinaryProtocol(transport);//使用二进制协议 Calculator.Client client = new Calculator.Client(protocol);//实例化一个服务客户端 transport.open();//打开socket，获取输入输出流，准备输入输出数据 client.ping();//调用ping System.out.println("ping()"); int sum = client.add(1,1); System.out.println("1+1=" + sum); Work work = new Work(); work.op = Operation.DIVIDE; work.num1 = 1; work.num2 = 0; try { int quotient = client.calculate(1, work); System.out.println("Whoa we can divide by 0"); } catch (InvalidOperation io) { System.out.println("Invalid operation: " + io.why); } //.... transport.close(); } catch (TException x) { x.printStackTrace(); } } }

ping()的序列图：