原文地址: https://www.jianshu.com/p/a1dbc6acd40c
最近因为项目的需要使用到了,thrift。一句话说明话体会:简单、好用、易上手。
Apache Thrift软件框架,用于可扩展的跨语言服务开发,将软件堆栈与代码生成引擎相结合,构建可在C ++,Java,Python,PHP,Ruby,Erlang,Perl,Haskell,C#之间高效无缝地工作的服务, Cocoa,JavaScript,Node.js,Smalltalk,OCaml和Delphi等语言。
这次的下项目使用的是 python 搭建一个 server。java 建立客户端调用 python server。
首先需要安装 thrift, 本地电脑上需要安装好。
说明 (***) 表示在项目中用到的方式
Thrift 安装
- 官网地址:http://thrift.apache.org/
安装方式可以参考:
安装好之后进行测试:
https://thrift.apache.org/test/
这个是 thrift 的测试,可以根据上面的指导进行操作。非常方便。
原理
如果你把上面的测试已经弄好了,那么接下来开始来理解 thrift 的原理。
Thrift架构
![](https://img.haomeiwen.com/i7081894/d91574d56e0d26d0.jpg)
TProtocol(协议层),定义数据传输格式,例如:
TBinaryProtocol:二进制格式(***);
TCompactProtocol:压缩格式;
TJSONProtocol:JSON格式;
TSimpleJSONProtocol:提供JSON只写协议, 生成的文件很容易通过脚本语言解析;
TDebugProtocol:使用易懂的可读的文本格式,以便于debugTTransport(传输层),定义数据传输方式,可以为TCP/IP传输,内存共享或者文件共享等)被用作运行时库。
TSocket:阻塞式socker;
TFramedTransport:以frame为单位进行传输,非阻塞式服务中使用;TFileTransport:以文件形式进行传输;
TMemoryTransport:将内存用于I/O,java实现时内部实际使用了简单的ByteArrayOutputStream;
TZlibTransport:使用zlib进行压缩, 与其他传输方式联合使用,当前无java实现;
Thrift支持的服务模型:
TSimpleServer:简单的单线程服务模型,常用于测试;
TThreadPoolServer:多线程服务模型,使用标准的阻塞式IO;(***)
TNonblockingServer:多线程服务模型,使用非阻塞式IO(需使用TFramedTransport数据传输方式);
Thrift实际上是实现了C/S模式,通过代码生成工具将thrift文生成服务器端和客户端代码(可以为不同语言),从而实现服务端和客户端跨语言的支持。
用户在Thirft文件中声明自己的服务,这些服务经过编译后会生成相应语言的代码文件,然后客户端调用服务,服务器端提服务便可以了。
文件解析
一般将服务放到一个.thrift文件中,服务的编写语法与C语言语法基本一致,在.thrift文件中有主要有以下几个内容:变量声明(variable)、数据声明(struct)和服务接口声明(service, 可以继承其他接口)。下面分析Thrift的tutorial中带的例子tutorial.thrift:
Thrift语法:
Thrift文件支持shell命令,因此thrift是可执行的。
Thrfit支持shell注释风格(#),也支持C/C++语言中单行(//)或者多行(/* */)注释风格
数据类型
- 基本类型
- bool,布尔型,1个字节;
- byte,有符号单字节;
- i16,有符号16位整型;
- i32,有符号32位整型;
- i64,有符号64位整型;
- double,64位浮点数;
- string,字符串;
- binary,字节数组;
注意:thrift不支持无符号整型。
- 容器
- map<t1,t2>,字典;
- list<t1>,列表;
- set<t1>,集合;
注意:容器中的元素类型可以是除了service 以外的任何合法thrift类型(包括结构体和异常)。
map<string,string> registe(1:string ip 2:string uuid 3:string time 4:binary imgurl 5:i32 winL 6:i32 winM 7:i32 winR) (***)
解释一哈:
map是返回值 使用字典类型的数据,其实就可以作为json来使用
registe 是server定义的方法名,这个名字需要指定好,
()里面的是形参。格式是 index: 数据类型 形参
数据类型见 基本类型
例子:
![](https://img.haomeiwen.com/i10953351/36938eaae0d8db73.png)
网友评论