每个thrift文档都博涵多条header和多条definition
header
header部分可以引入其他thrift文件(使用include)或定义生成代码的名字空间(使用namespace)
include "shared.thrift"
namespace java tutorial
definition
definition部分就是定义数据类型和rpc接口的部分
const 定义常量
typedef 为类型创建别名
enum/struct/exception 详见数据类型,struct/exception内部包含多个field
service 定义rpc的接口,其中包含多个function
field
由id,required,类型,名称,默认值组成
1: optional string name='abc',
上面这个例子中1:是id,之后跟的是字段是否required,随后是数据类型,名称和默认值.
其中第二个字段有三种情况optional/required/不填
optional的字段只有在设置值的情况下会被序列化,反序列化时不校验。
required的字段任何情况都会被序列化,在反序列化时如果不是基础元素未设置会报异常TProtocolException: Required field 'XXX' was not present!
默认的情况下序列化时会采用required形式,反序列化时也不会报错
所以当字段没有设值时,optional字段的默认值不会通过网络传输,required和不填的情况会传输,对于struct类型字段,optional和不填不会报错,而required会报错。
service
service定义了服务的接口
//service可以extends来继承
service Calculator extends shared.SharedService {
//void返回的方法
void ping(),
//返回int且带异常的方法
i32 calculate(1:i32 logid, 2:Work w) throws (1:InvalidOperation ouch),
//当客户端发送请求后不等待返回结果的异步方法
oneway void zip()
}
之后的文章会介绍以上三种调用