持续创作，加速成长！这是我参与「掘金日新计划 · 10 月更文挑战」的第28天，点击查看活动详情

Thrift 是一个轻量级、跨语言的 RPC 框架，由 facebook 开发，2007年正式开源，2008 纳入 Apache 软件基金会开源项目。
Thrift 支持多种编程语言，包括 C++, Java, Python, PHP, Ruby, Erlang, Perl, Go, C#, JavaScript, Node.js 等。

安装

安装 thrift 编译器，它用来生成所需语言的代码文件，例如生成 go 语言代码：

thrift -r --gen go tutorial.thrift

建议直接使用brew安装：

brew install thrift

也可以下载源码安装，参考：thrift.apache.org/docs/instal…

CentOS

需下载源码安装，参考：thrift.apache.org/docs/instal…

Debian/Ubuntu

需下载源码安装，先安装依赖：thrift.apache.org/docs/instal…

windows

本文以 windows 环境为例，从官方下载 exe 文件，下载地址：archive.apache.org/dist/thrift…:

将下载的 exe 文件改名为 thrift.exe，然后可以放到任意PATH路径下面，例如放在$GOROOT/bin下：

打开 cmd，验证是否成功：

看到如上版本号，就说明thrift安装成功了。

Thrift 类型

Thrift 中的类型包括基础类型、结构、容器、异常、服务等几个部分。（官网介绍：https://thrift.apache.org/docs/types）

基本类型

bool :布尔型，1个字节
byte :有符号整数，1个字节
i16 :有符号16位整型
i32 :有符号32位整型
i64 :有符号64位整型
double :64位浮点数值
string :字符串类型，使用UTF-8编码

特殊类型

binary :二进制数据类型（字节数组）

结构

Thrift 结构定义了一个公共对象，它们本质上等同于OOP语言中的类，但没有继承。结构有一组强类型字段，每个字段都具有唯一的名称标识符。字段可能有各种注释(数字字段ID、可选默认值等)。thrift IDL（Interface Definition Language）规范详见官网介绍：thrift.apache.org/docs/idl

示例：

struct SharedStruct {
  1: i32 key = 0,
  2: string value,
}

结构体中每一个域都有一个正整数标识符，这个标识符并不要求连续，但一旦定义，不建议再进行修改。

每个域前都会有required或optional：

required：必填域，如果设置了 required，在实际构造结构体时就必须给这个域赋值，否则 thrift 会认为这是一个异常。

optional：可选域，如果设置了 optional，在实际构造结构体时没有给这个域赋值，则在使用这个结构体时，就会忽略掉这个 optional 域。

域是可以设置默认值的，如上key = 0。

容器

有三种容器类型：

list<t1> :单类型有序列表，允许有重复元素，会被转换成C++中的vector，Java中的 ArrayLis等
set<t1> :单类型无需集合，不允许有重复元素，会转换成C++中的set，Java中的HashSet、Python中的Set等
map<t1,t2> :Map型（key:value），会被转换成C++中的map，Java中的HashMap，PHP中的关联数组等

容器元素可以是任何有效的Thrift 类型，注意：map 的key类型需要是基础类型，很多开发语言并不支持 map 的 key 类型为复杂数据类型。

异常

异常在语法上和结构的用法是完全一致的，不过 exception 是在远程调用发生异常时用来抛出异常用的。

服务

服务是由 Thrift 类型定义的。服务的定义在语义上等同于面向对象中定义接口(或纯虚拟抽象类)。Thrift 编译工具会根据定义的服务来生成对应的方法和函数。

thrift 文件解析

注释

thrift 文件注释有三种形式：

#
/**/
//

示例解析

/**
 * .thrift文件可以引用其他.thrift文件，这样可以方便地把一些公共结构和服务引入进来。
 * 在引用其他.thrift文件时，既可以直接引用当前文件夹下的文件，也可以引用其他路径下的文件，但后者需要在thrift编译工具编译时加上 -I 选项来设定路径。
 * 如果希望访问被包含的.thrift文件中的内容，则需要使用.thrift文件的文件名作为前缀，比如 shared.SharedObject。
 * 本例中引用了文件 shared.thrift
*/
include "shared.thrift"

/**
 * thrift支持针对不同的语言设置不同的 namespace，thrift会在生成不同语言代码时，进行相应的设置。
*/
namespace java tutorial
namespace go tutorial

// 使用 typedef 定义别名
typedef i32 MyInteger

/**
 * 定义常量. 复杂的类型和结构体使用JSON表示法. 
 */
const i32 INT32CONSTANT = 9853
const map<string,string> MAPCONSTANT = {'hello':'world', 'goodnight':'moon'}

/**
 * 枚举是32位整型数字, 如果没有显式指定值,默认从1开始编号并递增.
 */
enum Operation {
  ADD = 1,
  SUBTRACT = 2,
  MULTIPLY = 3,
  DIVIDE = 4
}

/**
 * 结构体由一组成员来组成, 一个成员包括数字标识符, 类型, 符号名, 及一个可选的默认值.
 * 每个域都可以设置为optional或required来表示是否为必填域，
 * 以便thrift决定是否在数据传输时要包含这个域。
 * 不指定时，默认为required。
 */
struct Work {
  1: i32 num1 = 0,
  2: i32 num2,
  3: Operation op,
  4: optional string comment,
}

// 结构体也可以作为异常，在语法上，异常的定义方式和结构体是完全一样的
exception InvalidOperation {
  1: i32 whatOp,
  2: string why
}

/**
 * 定义服务需要一个服务名, 加上一个可选的继承, 使用extends关键字 
 */
service Calculator extends shared.SharedService {
 
  /**
   * 服务中方法的定义非常类似于C语言的语法。包括一个返回值，
   * 一个参数列表以及一个可以抛出的异常列表（可选）
   * 定义参数列表的方法、定义异常列表的方法，和定义结构体的方法
   * 都是相似的，可以从下面的例子中看出。
   * 注意，除了最后一个方法，其他的方法最后都要有一个逗号。
   */
 
   void ping(),
 
   i32 add(1:i32 num1, 2:i32 num2),
   
   /**
 　　* 在异常列表前，需要加throws关键字。
　　 */
   i32 calculate(1:i32 logid, 2:Work w) throws (1:InvalidOperation ouch),
 
   /**
 　　* 这个方法有 oneway 修饰符, 表示客户段发送一个请求后会立即返回，
 　　* 不会等待回应（oneway在英语里就是“单向”的意思）。
 　　* oneway 方法的返回值必须是 void
　　 */
   oneway void zip()
 
}

Go语言 thrift 入门指南--thrift IDL介绍

安装

Thrift 类型

thrift 文件解析

注释

示例解析