thrift

介绍

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:客户端和服务端的协议要一致

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容