Thrift使用總結篇

工程目錄如下：

project 

    idl/

gen.bat

thrift.exe

main.thrift

    res/

a.jpg

    lib/

a.py

其中idl裏面存放的是thrift相關的配置文件內容。gen.bat的內容如下:

點擊(此處)摺疊或打開

@ECHO OFF
set THRIFT_CODEDEFINE=main.thrift
if "%1"=="" goto genDefault

:genDefault
call thrift-0.7.0.exe --gen
py main.thrift
goto end

:genByArg
call thrift-0.7.0.exe --gen
java:hashcode %1
call thrift-0.7.0.exe --gen
php %1
call thrift-0.7.0.exe --gen
py %1
goto end

:exit
exit /b 1

:end
exit /b 0

可以給它傳遞一個thrift配置文件然後編譯輸出相應的代碼.

ps:如果是py的話中文是個問題的.需要手工置#coding:utf-8

main.thrift的內容如下

點擊(此處)摺疊或打開

namespace py thriftlib.adspub.thrift

exception ThrfitException {
1: i32 errCode,
2: string msg
}

struct ResultInfo{
1: i32 err,
2: string value,
3: string msg
}

struct A {
1: string type,
2: i32 age
}

struct B {
1: i32 id,
2: list a
}
service InfoService {
ResultInfo deployTemplateCreate(1:B deployObject,2:string username);
list deployPlanList(1:string planName);
}

簡單介紹一下如何編寫thrift配置文件

數據類型：

bool,byte,i16,i32,i64,double,string,binary[二進制類型，在做文件服務器的時候使用]

structs:定義了一個類對象。其實就是一個OOP裏面的類

容器類：list,set:集合,map: 字典。包括了三種容器對象

異常：這個跟傳統的異常沒有太大的差異

服務：類似於定義了一個接口或純抽象類。程序員要做的就是去實現這些接口然後就可以暴露給客戶端調用了。

定義完了thrift文件之後就可以寫代碼了

點擊(此處)摺疊或打開

handler = DeployInfoHandler()
  # 這個就是實現了接口方法的實現類
processor = DeployInfoService.Processor(handler)
transport = TSocket.TServerSocket("0.0.0.0", 10001)
tfactory = TTransport.TBufferedTransportFactory()
pfactory = TBinaryProtocol.TBinaryProtocolFactory()
server = TServer.TThreadedServer(processor, transport, tfactory, pfactory)
server.serve()

對以上代碼的簡單分析：

（1）.支持的傳輸格式

TBinaryProtocol   二進制格式

TCompactProtocol  壓縮格式

TJSONProtocol     JSON格式

TSimpleJSONProtocol 提供JSON只寫協議，生成的文件很容易通過腳本語言解析

TDebugProtocol     使用易懂的可讀的文本格式以便於debug

（2）. 支持的數據傳輸方式

TSocket     阻塞式socket

THttpTransport 採用HTTP傳輸協議進行數據傳輸

TFramedTransport 以frame爲單位傳輸，非阻塞式服務中使用

TFileTransport 以文件形式進行傳輸

TMemoryTransport 將內存用於I/0，

TZlibTransport 使用zlib進行壓縮。

TBufferedTransport 對某個transport對象操作的數據進行buffer,即從buffer中讀取數據進行傳輸，或將數據直接寫入到buffer

(3). 支持的服務模型[主要是服務端類型]

TSimpleServer 簡單的單線程服務模型，常用於測試

TThreadedServer 多線程服務模型使用標準的阻塞式IO,每個請求創建一個線程

TThreadPoolServer 多線程服務模型使用標準的阻塞式IO，預先創建一組線程處理請求

TNonblockingServer 多線程服務模型使用非阻塞IO（需要用TFramedTransport數據傳輸方式 ）

ps:什麼叫阻塞與非阻塞？

阻塞IO：socket的阻塞意味着必須要做完IO包括錯誤纔會返回

非阻塞IO：無論操作是否完成都會立刻返回，需要通過其他方式來判斷具體操作是否成功

在網絡阻塞嚴重的時候，網絡層沒有足夠的內存來進行寫操作，這時候就會出現寫不成功的情況，阻塞情況下會儘可能(有可能被中斷)等待到數據全部發送完畢， 對於非阻塞的情況就是一次寫多少算多少,沒有中斷的情況下也還是會出現write 到一部分的情況.

相關客戶端代碼：

tskt = TSocket.TSocket(ip,port)

tskt.setTimeout(self.timeout)

self.transport = TTransport.TBufferedTransport(tskt)

 protocol = TBinaryProtocol.TBinaryProtocol(self.transport)

client = service_class.Client(protocol)

注意：這裏面的服務類名就是生成的thrift的接口類

實際工作中要注意的事項：

1、

2、