Thrift入門初探--thrift安裝及java入門例項
公司的一些平臺服務框架底層封裝了thrift提供服務,最近專案不是很緊,於是研究了一下,剛剛入門,理解得不深,寫這篇博文來整理一下思路.
什麼是thrift?
簡單來說,是Facebook公佈的一款開源跨語言的RPC框架.
那麼問題來了.
什麼是RPC框架?
RPC全稱為Remote Procedure Call,意為遠端過程呼叫.
假設有兩臺伺服器A,B.A伺服器上部署著一個應用a,B伺服器上部署著一個應用b,現在a希望能夠呼叫b應用的某個函式(方法),但是二者不在同一個程序內,不能直接呼叫,就需要通過網路傳輸,在AB伺服器之間建一條網路傳輸通道,a把引數傳過去,b接收到引數呼叫自己的方法,得到結果,再通過網路傳回給a,簡單講就是A通過網路來呼叫B的過程.這個過程要涉及的東西很多,比如多執行緒,Socket,序列化反序列化,網路I/O,很複雜,於是牛掰的程式設計師把這些封裝起來做成一套框架,供大家使用,就是RPC框架.
thrift的跨語言特型
thrift通過一箇中間語言IDL(介面定義語言)來定義RPC的資料型別和介面,這些內容寫在以.thrift結尾的檔案中,然後通過特殊的編譯器來生成不同語言的程式碼,以滿足不同需要的開發者,比如java開發者,就可以生成java程式碼,c++開發者可以生成c++程式碼,生成的程式碼中不但包含目標語言的介面定義,方法,資料型別,還包含有RPC協議層和傳輸層的實現程式碼.
thrift的協議棧結構
thrift是一種c/s的架構體系.在最上層是使用者自行實現的業務邏輯程式碼.第二層是由thrift編譯器自動生成的程式碼,主要用於結構化資料的解析,傳送和接收。TServer
MAC OS下thrift的下載與安裝
我的電腦是mac,第一次安裝也碰到了一些問題,所以有必要記錄一下.
首先,在官網下載安裝包http://thrift.apache.org/download 目前官網是0.10.0版本.下載完之後解壓到想要安裝的目錄.
進入根目錄:
step1:cd thrift-0.10.0 step2:./configure step3:make step4:make install
安裝的時候,第二步出現了問題,提示:
Bison version 2.5 or higher must be installed on the system!
原因是Bison版本過低,mac預設安裝的版本是2.3,因此需要安裝最新版的Bison,命令列輸入:brew install bison安裝最新版bison,如果你的命令列反饋:Command not found,很可能是因為你沒裝homebrew,命令列輸入:
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
等待安裝完homebrew就可以安裝bison了,最新版本3.0.4安裝完以後,執行第二步,發現依然提示上面那個警告,原因是因為它讀取的仍然是預設的bison,於是找到系統安裝的bison目錄,我的mac是
/Library/Developer/CommandLineTools/usr/bin/bison,解決方法也比較簡單,可以先將這個目錄下的bison名字改一下,再將最新版的bison複製進來,於是,在bin目錄下,執行命令:
sudo mv bison bison111
sudo cp /usr/local/opt/bison/bin/bison /Library/Developer/CommandLineTools/usr/bin/
現在,再按照上面的步驟進行下去,就可以正確安裝thrift了.
進入thrift大門的第一個java小例項
1,建立一個服務Hello,建立檔案Hello.thrift,程式碼如下:
namespace java service.demo service Hello{ string helloString(1:string para) }
這裡定義了一個名為helloString的方法,入參和返回值都是一個string型別的引數.
2,終端進入Hello.thrift所在目錄,執行命令:
thrift -r -gen java Hello.thrift
發現在當前目錄下多了一個gen-java的目錄,裡面的有一個Hello.java的檔案.這個java檔案包含Hello服務的介面定義Hello.Iface,以及服務呼叫的底層通訊細節,包括客戶端的呼叫邏輯Hello.Client以及服務端的處理邏輯Hello.Processor,
3,建立一個Maven管理的Java專案,pom.xml中新增相關的依賴,並將Hello.java檔案複製到專案中:
<dependency> <groupId>org.apache.thrift</groupId> <artifactId>libthrift</artifactId> <version>0.10.0</version> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> <version>1.7.5</version> </dependency>
4,建立HelloServiceImpl實現Hello.Iface介面:
package service.demo; import org.apache.thrift.TException; /** * @author yogo.wang * @date 2017/02/21-下午2:13. */ public class HelloServiceImpl implements Hello.Iface { public String helloString(String para) throws TException { return "result:"+para; } }
5,建立服務端實現程式碼HelloServiceServer,把HelloServiceImpl作為一個具體的處理器傳遞給Thrift伺服器:
package service.demo; import org.apache.thrift.TProcessor; import org.apache.thrift.protocol.TBinaryProtocol; import org.apache.thrift.server.TServer; import org.apache.thrift.server.TSimpleServer; import org.apache.thrift.transport.TServerSocket; import org.apache.thrift.transport.TTransportException; /** * @author yogo.wang * @date 2017/02/21-下午2:15. */ public class HelloServiceServer { /** * 啟動thrift伺服器 * @param args */ public static void main(String[] args) { try { System.out.println("服務端開啟...."); TProcessor tprocessor = new Hello.Processor<Hello.Iface>(new HelloServiceImpl()); // 簡單的單執行緒服務模型 TServerSocket serverTransport = new TServerSocket(9898); TServer.Args tArgs = new TServer.Args(serverTransport); tArgs.processor(tprocessor); tArgs.protocolFactory(new TBinaryProtocol.Factory()); TServer server = new TSimpleServer(tArgs); server.serve(); }catch (TTransportException e) { e.printStackTrace(); } } }
6,建立客戶端實現程式碼HelloServiceClient,呼叫Hello.client訪問服務端的邏輯實現:
package service.demo; import org.apache.thrift.TException; import org.apache.thrift.protocol.TBinaryProtocol; import org.apache.thrift.protocol.TProtocol; import org.apache.thrift.transport.TSocket; import org.apache.thrift.transport.TTransport; import org.apache.thrift.transport.TTransportException; /** * @author yogo.wang * @date 2017/02/21-下午2:35. */ public class HelloServiceClient { public static void main(String[] args) { System.out.println("客戶端啟動...."); TTransport transport = null; try { transport = new TSocket("localhost", 9898, 30000); // 協議要和服務端一致 TProtocol protocol = new TBinaryProtocol(transport); Hello.Client client = new Hello.Client(protocol); transport.open(); String result = client.helloString("哈哈"); System.out.println(result); } catch (TTransportException e) { e.printStackTrace(); } catch (TException e) { e.printStackTrace(); } finally { if (null != transport) { transport.close(); } } } }
全部工作完成後,下面來測試一下,先執行服務端main方法,在執行客戶端main方法,會在客戶端控制檯打印出:result:哈哈.
參考文章:
Apache Thrift - 可伸縮的跨語言服務開發框架
Thrift RPC框架介紹