thrift

基本類型

bool ：布爾類型( true or value)，佔一個字節

byte：有符號字節

i16:16位有符號整型

i32:32位有符號整型

i64:64位有符號整型

double ：64位浮點數

string：未知編碼或者二進制的字符串

注意，thrift不支持無符號整型，由於不少目標語言不存在無符號整型（如java）。

支持的傳輸協議

    * TBinaryProtocol : 二進制編碼格式進行數據傳輸。
    * TCompactProtocol : 這種協議很是有效的，使用Variable-Length Quantity (VLQ) 編碼對數據進行壓縮。
    * TJSONProtocol : 使用JSON的數據編碼協議進行數據傳輸。
    * TSimpleJSONProtocol : 這種節約只提供JSON只寫的協議，適用於經過腳本語言解析
    * TDebugProtocol  :  在開發的過程當中幫助開發人員調試用的，以文本的形式展示方便閱讀。

傳輸層

    * TSocket : 使用堵塞式I/O進行傳輸，也是最多見的模式。
    * TFramedTransport : 使用非阻塞方式，按塊的大小，進行傳輸，相似於Java中的NIO。
    * TFileTransport : 顧名思義按照文件的方式進程傳輸，雖然這種方式不提供Java的實現，可是實現起來很是簡單。
    * TMemoryTransport :  使用內存I/O，就比如Java中的ByteArrayOutputStream實現。
    * TZlibTransport : 使用執行zlib壓縮，不提供Java的實現。

服務端類型

    * TSimpleServer : 單線程服務器端使用標準的堵塞式I/O。
    * TThreadPoolServer : 多線程服務器端使用標準的堵塞式I/O。
    * TNonblockingServer : 多線程服務器端使用非堵塞式I/O，而且實現了Java中的NIO通道。

 Transport : Transport層提供了一個簡單的網絡讀寫抽象層。這使得thrift底層的transport從系統其它部分（如：序列化/反序列化）解耦。

 

        規範的struct定義中的每一個域均會使用required或者optional關鍵字進行標識。若是required標識的域沒有賦值，Thrift將給予提示；若是optional標識的域沒有賦值，該域將不會被序列化傳輸；若是某個optional標識域有缺省值而用戶沒有從新賦值，則該域的值一直爲缺省值；若是某個optional標識域有缺省值或者用戶已經從新賦值，而不設置它的__isset爲true，也不會被序列化傳輸。

 

Enum

不一樣於protocal buffer，thrift不支持枚舉類嵌套，枚舉常量必須是32位的正整數

• 編譯器默認從0開始賦值
• 能夠賦予某個常量某個整數
• 容許常量是十六進制整數
• 末尾沒有分號
• 給常量賦缺省值時，使用常量的全稱

  enum EnOpType {
  CMD_OK = 0, // (0) 　　
  CMD_NOT_EXIT = 2000, // (2000)
  CMD_EXIT = 2001, // (2001)  　　
  CMD_ADD = 2002 // (2002)
  }
  
  struct StUser {
  1: required i32 userId;
  2: required string userName;
  3: optional EnOpType cmd_code = EnOpType.CMD_OK; // (0)
  4: optional string language = 「english」
  }

   

Includes

便於管理、重用和提升模塊性/組織性，經常分割Thrift定義在不一樣的文件中。包含文件搜索方式與c++同樣。Thrift容許文件包含其它thrift文件，用戶須要使用thrift文件名做爲前綴訪問被包含的對象

include "test.thrift"   
...
struct StSearchResult {
    1: in32 uid; 
    ...
}

Namespace

Thrift中的命名空間相似於C++中的namespace和java中的package，它們提供了一種組織（隔離）代碼的簡便方式。名字空間也能夠用於解決類型定義中的名字衝突。

namespace cpp com.example.test
namespace java com.example.test 
namespace php com.example.test

Services

服務的定義方法在語義(semantically)上等同於面嚮對象語言中的接口。Thrift編譯器會產生執行這些接口的client和server stub。具體參見下一節。在流行的序列化/反序列化框架（如protocal buffer）中，Thrift是少有的提供多語言間RPC服務的框架。這是Thrift的一大特點。

service SeTest {
      void ping(),
      bool postTweet(1: StUser user);
      StUser searchTweets(1:string name);
     oneway void zip()

}

Exception

Thrift結構體將會被轉換成面嚮對象語言的類。異常在語法和功能上相似於結構體，差異是異常使用關鍵字exception，並且異常是繼承每種語言的基礎異常類。

exception Extest {
1: i32 errorCode,
2: string message,
3: StUser userinfo
}

struct

struct是定義爲一種對象，和麪向對象語言的class差很少.,可是struct有如下一些約束：

• struct不能繼承，可是能夠嵌套，不能嵌套本身。
• 其成員都是有明確類型
• 成員是被正整數編號過的，其中的編號使不能重複的，這個是爲了在傳輸過程當中編碼使用。
• 成員分割符能夠是逗號（,）或是分號（;），並且能夠混用，可是爲了清晰期間，建議在定義中只使用一種，好比C++學習者能夠就使用分號（;）。
• 字段會有optional和required之分和protobuf同樣，可是若是不指定則爲無類型—能夠不填充該值，可是在序列化傳輸的時候也會序列化進去，optional是不填充則部序列化，required是必須填充也必須序列化。
• 每一個字段能夠設置默認值
• 同一文件能夠定義多個struct，也能夠定義在不一樣的文件，進行include引入

struct Report
{
  1: required string msg, //改字段必須填寫
  2: optional i32 type = 0; //默認值
  3: i32 time //默認字段類型爲optional
}