本文主要是介绍Thrift在Java中的简单实例（四），希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！
Thrift的基本语法
1.1 类型
Thrift类型系统包括预定义基本类型，用户自定义结构体，容器类型，异常和服务定义。
1.1.1 基本类型
-
bool: 布尔值 (true or false), one byte
-
byte: 有符号字节
-
i16: 16位有符号整型
-
i32: 32位有符号整型
-
i64: 64位有符号整型
-
double: 64位浮点型
-
string: Encoding agnostic text or binary string
Note that： Thrift不支持无符号整型，因为Thrift目标语言没有无符号整型，无法转换。
1.1.2 容器（Containers）
Thrift容器与流行编程语言的容器类型相对应，采用Java泛型风格。它有3种可用容器类型：
-
list<t1>: 元素类型为t1的有序表，容许元素重复。（有序表ordered list不知道如何理解？排序的？c++的vector不排序）
-
set<t1>:元素类型为t1的无序表，不容许元素重复。
-
map<t1,t2>: 键类型为t1，值类型为t2的kv对，键不容许重复。
容器中元素类型可以是除了service外的任何合法Thrift类型（包括结构体和异常）。
1.3 枚举（Enums）
很多语言都有枚举，意义都一样。比如，当定义一个消息类型时，它只能是预定义的值列表中的一个，可以用枚举实现。
enum TweetType {TWEET, // (1)
说明：
(1).
(2).
(3).
(4).
(5).
注意，不同于protocal buffer，thrift不支持枚举类嵌套，枚举常量必须是32位的正整数
1.4 注释（Comment）
Thrift支持shell风格, C多行风格和Java/C++单行风格。
# This is a valid comment.// C++/Java style single-line comments work just as well.
1.5 名字空间（Namespace）
Thrift中的命名空间类似于C++中的namespace和java中的package，它们提供了一种组织（隔离）代码的简便方式。名字空间也可以用于解决类型定义中的名字冲突。
由于每种语言均有自己的命名空间定义方式（如python中有module）, thrift允许开发者针对特定语言定义namespace：
namespace cpp com.example.project // (1)namespace java com.example.project // (2)namespace php com.example.project
(1)． 转化成namespace com { namespace example { namespace project {
(2)．
1.6 Includes
便于管理、重用和提高模块性/组织性，我们常常分割Thrift定义在不同的文件中。包含文件搜索方式与c++一样。Thrift允许文件包含其它thrift文件，用户需要使用thrift文件名作为前缀访问被包含的对象，如：
include "tweet.thrift" // （1）...struct TweetSearchResult {1: tweet.Tweet tweet; // （2）}
说明：
（1）．
（2）．
1.7 常量（Constant)
Thrift允许定义跨语言使用的常量，复杂的类型和结构体可使用JSON形式表示。
const i32 INT_CONST = 1234; // （1）
说明：
（1） 分号可有可无。支持16进制。
1.8 结构体定义（Defining Struct）
struct是Thrift IDL中的基本组成块，由域组成，每个域有唯一整数标识符，类型，名字和可选的缺省参数组成。如定义一个类似于Twitter服务：
struct Tweet {1: required i32 userId; // (1)2: required string userName; // (2)3: required string text;4: optional Location loc; // (3)16: optional string language = "english" // (4)}struct Location { // (5)1: required double latitude;2: required double longitude;}
如上所见，消息定义中的每个域都有一个唯一数字标签，这些数字标签在传输时用来确定域，一旦使用消息类型，标签不可改变。（随着项目的进展，可以要变更Thrift文件，最好不要改变原有的数字标签）
规范的struct定义中的每个域均会使用required或者optional关键字进行标识。如果required标识的域没有赋值，Thrift将给予提示；如果optional标识的域没有赋值，该域将不会被序列化传输；如果某个optional标识域有缺省值而用户没有重新赋值，则该域的值一直为缺省值；如果某个optional标识域有缺省值或者用户已经重新赋值，而不设置它的__isset为true，也不会被序列化传输。（不被序列化传输的后果是什么？为空为零？还是默认值，下次试试）
与services不同，结构体不支持继承。
1.9 服务定义（Defining Services）
在流行的序列化/反序列化框架（如protocal buffer）中，Thrift是少有的提供多语言间RPC服务的框架。这是Thrift的一大特色。
Thrift编译器会根据选择的目标语言为server产生服务接口代码，为client产生stubs。
service Twitter {// A method definition looks like C code. It has a return type, arguments,// and optionally a list of exceptions that it may throw. Note that argument// lists and exception list are specified using the exact same syntax as// field lists in structs.void ping(), // (1)bool postTweet(1:Tweet tweet); // (2)TweetSearchResult searchTweets(1:string query); // (3)// The 'oneway' modifier indicates that the client only makes a request and// does not wait for any response at all. Oneway methods MUST be void.oneway void zip() // (4)}
(1) 有点乱，接口支持以逗号和分号结束；
(2) 参数可以是基本类型和结构体；（参数是cosnt的，转换为c++语言是const&）
(3) 返回值同参数一样；
(4) 返回值是void，注意oneway；
Note that:参数列表的定义与结构体一样。服务支持继承。
源地址：http://www.cnblogs.com/tianhuilove/archive/2011/09/05/2167669.html
这篇关于Thrift在Java中的简单实例（四）的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！
