介绍
Thrift是一个软件框架,用来进行可扩展且跨语言的服务的开发。它结合了功能强大的软件堆栈和代码生成引擎,以构建在 C++, Java, Python, PHP, Ruby, Erlang, Perl, Haskell, C#, Cocoa, JavaScript, Node.js, Smalltalk, and OCaml 等等编程语言间无缝结合的、高效的服务。
服务模型
thrift是一个支持多语言之间远程函数调用的开源工具,因为其方便的使用和对c++、java、php等多种主流语言的支持而获得广泛地使用。server层属于其接受客户端请求的服务模型层,用于处理接受客户端过来的请求。
现在支持三种模型:
(1)单线程模型,主线程监听socket、获得连接请求、处理请求
(2)多线程模型,主线程监听socket,获得新连接,使用threadFactory创建新线程处理该连接直到连接断开
(3)线程池模型,主线程处理通信请求将获得的新连接fd生成TConnectedClient加入任务队列;多个工作线程(ThreadManager管理)从任务队列取连接、处理请求,直到连接断开,再从队列取新的连接
总结
3种服务模型个有优劣,单线程模型一般只用在调试环境中,同时刻只能处理一个连接;多线程模型同时可以处理多个新连接,但每次处理新的连接都会新建线程,存在不小的开销;线程池模型一开始就创建好线程,减小了创建线程、销毁线程开销,但是多了维护队列、固定数目线程的开销。
结构说明:
如上图所示,
TServerFramework是3个服务模型类的基类,通过serve方法提供了处理所有连接请求的循环逻辑,而TSimpleServer、TThreadedServer和TThreadPoolServer三个类分别对应3中服务模型。
TConnectedClient类存储了连接到服务端的客户端的相关信息,提供了处理一个请求的方法run,此类继承于Runnable。
实现
TServerFramework - 提供统一处理循环
mon_限制并发客户端数量Monitor
clients_并发客户端数量int64_t
hwm_并发最高值int64_t
limit_并发限制值int64_t
serve方法
循环地从TServerTransport接收clients,通过调用newlyConnectedClient方法送去处理。
newlyConnectedClient调用onClientConnected方法处理连接请求,绑定disposeConnectedClient方法处理连接销毁,并控制并发连接数。
每个不同的服务模型类提供不同的onClientConnected来实现不同的服务模型。
TSimpleServer - 单线程服务模型
onClientConnected方法
直接调用TConnectedClient的run方法处理请求
TThreadedServer - 多线程服务模型
serve方法
调用TServerFramework的serve,启动多线程服务模型入口
onClientConnected方法
每到来一个新的连接,都新建一个线程使用TConnectedClient的run进行处理
TThreadPoolServer - 线程池服务模型
threadManager_线程管理ThreadManader
stop_voatile bool
timeout_等待任务数超限时的超时时间volatile int64_t
taskExpiration_任务过期时间volatile int64_t
serve方法
调用TServerFramework的serve,启动多线程服务模型入口
threadManager->join等待threadManager的线程池中线程结束
onClientConnected方法
通过使用ThreadManager的add将新的连接请求放入任务队列
实际处理要等到ThreadManager的Worker线程的run从任务队列取任务,执行TConnectedClient的run方法。
TNonblockingServer 服务模型
使用非阻塞式IO,服务端和客户端需要指定TFramedTransport数据传输的方式。
THsHaServer服务模型
半同步半异步的服务端模型,需要指定为:TFramedTransport数据传输的方式。
TConnectedClient - 连接TServer的客户端
processor_处理类TProcessor
inputProtocol_输入协议TProtocol
outputProtocol_输出协议TProtocol
eventHandler_TServerEventHandler
client_客户端请求TTransport
opaqueContext_从eventHandler_获取的上下文void*
run方法
处理一个连接上的请求,直到连接断开
使用processor的process方法
数据类型
基本类型:
bool:布尔值,true 或 false,对应 Java 的 boolean
byte:8 位有符号整数,对应 Java 的 byte
i16:16 位有符号整数,对应 Java 的 short
i32:32 位有符号整数,对应 Java 的 int
i64:64 位有符号整数,对应 Java 的 long
double:64 位浮点数,对应 Java 的 double
string:utf-8编码的字符串,对应 Java 的 String
结构体类型:
struct:定义公共的对象,类似于 C 语言中的结构体定义,在 Java 中是一个 JavaBean
容器类型:
list:对应 Java 的 ArrayList
set:对应 Java 的 HashSet
map:对应 Java 的 HashMap
异常类型:
exception:对应 Java 的 Exception
服务类型:
service:对应服务的类
服务端编码基本步骤:
实现服务处理接口impl
创建TProcessor
创建TServerTransport
创建TProtocol
创建TServer
启动Server
客户端编码基本步骤:
创建Transport
创建TProtocol
基于TTransport和TProtocol创建 Client
调用Client的相应方法
数据传输协议
TBinaryProtocol : 二进制格式.
TCompactProtocol : 压缩格式
TJSONProtocol : JSON格式
TSimpleJSONProtocol : 提供JSON只写协议, 生成的文件很容易通过脚本语言解析
tips:客户端和服务端的协议要一致