Thrift學習筆記—IDL基本類型


 thrift 采用IDL(Interface Definition Language)來定義通用的服務接口,並通過生成不同的語言代理實現來達到跨語言、平台的功能。在thrift的IDL中可以定義以下一些類型:基本數據類型,結構體,容器,異常、服務

1基本類型

  • bool: 布爾值 (true or false), one byte
  • byte: 有符號字節
  • i16: 16位有符號整型
  • i32: 32位有符號整型
  • i64: 64位有符號整型
  • double: 64位浮點型
  • string: Encoding agnostic text or binary string

基本類型中基本都是有符號數,因為有些語言沒有無符號數,所以Thrift不支持無符號整型。

2特殊類型

binary: Blob (byte array) a sequence of unencoded bytes

這是string類型的一種變形,主要是為Java使用,目前我主要使用C++的語言,所以java的這個類型沒有用過

3struct

thrift中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
}

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

4容器(Containers)

  Thrift容器與目前流行編程語言的容器類型相對應,有3種可用容器類型:

  • list<t>: 元素類型為t的有序表,容許元素重復。對應c++的vector,java的ArrayList或者其他語言的數組(官方文檔說是ordered list不知道如何理解?排序的?c++的vector不排序)
  • set<t>:元素類型為t的無序表,不容許元素重復。對應c++中的set,java中的HashSet,python中的set,php中沒有set,則轉換為list類型了
  • map<t,t>: 鍵類型為t,值類型為t的kv對,鍵不容許重復。對用c++中的map, Java的HashMap, PHP 對應 array, Python/Ruby 的dictionary。

  容器中元素類型可以是除了service外的任何合法Thrift類型(包括結構體和異常)。為了最大的兼容性,map的key最好是thrift的基本類型,有些語言不支持復雜類型的key,JSON協議只支持那些基本類型的key。

容器都是同構容器,不失異構容器。

例子

struct Test {1: map<Numberz, UserId> user_map,2: set<Numberz> num_sets,

 

3: list<Stusers> users

}

5枚舉(enmu)

很多語言都有枚舉,意義都一樣。比如,當定義一個消息類型時,它只能是預定義的值列表中的一個,可以用枚舉實現。說明:

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

  注意,不同於protocal buffer,thrift不支持枚舉類嵌套,枚舉常量必須是32位的正整數

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”

}

枚舉類型和struct編譯后的c++代碼

struct EnOpType { enum type { CMD_OK = 0,

 

CMD_NOT_EXIT = 2000,

CMD_EXIT = 2001,

CMD_ADD = 2002

};

};

class StUser {

public:

。。。。。。

枚舉類型編譯后被struct封裝了,struct編譯后成了class,當然其中方法了多了很多。

6常量定義和類型定義

  Thrift允許定義跨語言使用的常量,復雜的類型和結構體可使用JSON形式表示。

const i32 INT_CONST = 1234; const EnOpType myEnOpType = EnOpType.CMD_EXIT; //2001

 說明:分號可有可無。支持16進制。  

Thrift支持C/C++類型定義。

typedef i32 MyInteger // a
typedef StUser ReU // b
typedef i64 UserId

 說明:a.末尾沒有逗號。b. Struct也可以使用typedef。

7異常(Exceptions)

  Thrift結構體在概念上類似於(similar to)C語言結構體類型—將相關屬性封裝在一起的簡便方式。Thrift結構體將會被轉換成面向對象語言的類。

  異常在語法和功能上類似於結構體,差別是異常使用關鍵字exception,而且異常是繼承每種語言的基礎異常類。

exception Extest {

 

1: i32 errorCode,

2: string message,

3: StUser userinfo

}

8服務(Services)

  服務的定義方法在語義(semantically)上等同於面向對象語言中的接口。Thrift編譯器會產生執行這些接口的client和server stub。具體參見下一節。

  在流行的序列化/反序列化框架(如protocal buffer)中,Thrift是少有的提供多語言間RPC服務的框架。這是Thrift的一大特色。

  Thrift編譯器會根據選擇的目標語言為server產生服務接口代碼,為client產生stubs。

service SeTest {      void ping(),      bool postTweet(1: StUser user);

 

     StUser searchTweets(1:string name);

     oneway void zip()

}

編譯后的c++代碼

class SeTestIf {public:      virtual ~SeTestIf() {}

 

     virtual bool AddUser(const StUser& user) = 0;

     virtual void SearchUser(StUser& _return, const std::string& name) = 0;

     virtual void NopNop() = 0;

};

 

  • 首先所有的方法都是純虛汗數,也就是繼承類必須實現這些方法
  • 返回值不是基本類型的都把返回值放到了函數參數中第一個參數,命名_return
  • 所有的參數(除返回值)都是const類型,意味這函數一般參數無法作為返回值攜帶者。只會有一個返回參數,如果返回值有多個,那只能封裝復雜類型作為返回值參數。
  • oneway的返回值一定是void
  • 當然服務是支持繼承。
  • 服務不支持重載

9名字空間(Namespace)

Thrift中的命名空間類似於C++中的namespace和java中的package,它們提供了一種組織(隔離)代碼的簡便方式。名字空間也可以用於解決類型定義中的名字沖突。

由於每種語言均有自己的命名空間定義方式(如Python中有module), thrift允許開發者針對特定語言定義namespace:

namespace cpp com.example.test
namespace java com.example.test 
namespace php com.example.test  
c++轉化成
namespace com { namespace example { namespace test {
在C++的版本中如果不加namespace,那么生成的代碼中*server.skeleton.cpp代碼中的namespace是空的,會產生編譯錯誤。

10注釋(Comment)

  Thrift支持C多行風格和Java/C++單行風格。

/*
 * This is a multi-line comment.
 * Just like in C.
 */
// C++/Java style single-line comments work just as well.

11Includes

  便於管理、重用和提高模塊性/組織性,我們常常分割Thrift定義在不同的文件中。包含文件搜索方式與c++一樣。Thrift允許文件包含其它thrift文件,用戶需要使用thrift文件名作為前綴訪問被包含的對象,如:

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

thrift文件名要用雙引號包含,末尾沒有逗號或者分號

 
 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM