RPC框架實踐之：Apache Thrift

一、概述

RPC（Remote Procedure Call）即遠程過程調用，說的這麼抽象，其實簡化理解就是一個節點如何請求另一節點所提供的服務。在文章微服務調用鏈追蹤中心搭建一文中模擬出來的調用鏈：ServiceA ---> ServiceB ---> ServiceC就是一個遠程調用的例子，只不過這篇文章里是通過 這種同步調用方式，利用的是HTTP協議在應用層完成的，這種方法雖然奏效，但有時效率並不高。而RPC可以不依賴於應用層協議，可以直接基於TCP進行遠程調用，在傳輸層中即可完成通信，因此更適於某些對效率要求更高的場景。由於RPC調用方式依賴於客戶端與服務端之間建立Socket連接來實現二進位數據通信，底層會比較複雜，所以一些RPC框架應運而生來封裝這種複雜性，讓開發者將精力聚焦於業務之上。常見的RPC框架包括：Thrift、gRPC、Finagle、Dubbo等等，從本文開始作者將選一些實踐一下，本文主要記錄作者對於Thrift框架的實踐過程。

Thrift是Apache的項目，它結合了功能強大的軟體堆棧和代碼生成引擎，可以在諸多語言之間提供無縫支持。

心動不如行動吧！

二、實驗環境

Mac OS X 10.13.2

SpringBoot 2.0.1

Thrift 0.11.0

IDE：IntelliJ IDEA 2018.01

為了便於讀者理解，我先將下文內容總結一下，包含7點：

Thrift環境搭建

IDEA中Thrift插件配置

創建 Thrift 項目並編譯（目的：定義RPC介面）

開發Thrift API介面

開發RPC服務端

開發RPC客戶端

RPC通信實際實驗

三、Thrift環境搭建

方法一：原生安裝方式，通過官方提供的步驟一步一步來安裝

參考這裡：Mac上Thrift官方安裝教程

方法二：使用 brew 工具（推薦）

四、IDEA中Thrift插件配置

方法一：直接在IDEA界面中配置

打開IDEA的插件中心，搜索Thrift即可安裝

方法二：手動下載Thrift插件安裝

就像文章 《SpringBoot優雅編碼之：Lombok加持》(https://www.jianshu.com/p/c88b0f17f62a) 一文中在IDEA中安裝Lombok插件一樣，有時由於網路原因，方法一不奏效時插件裝不上，此時可以手動下載插件並安裝。

可以去如下地址下載Thrift插件：http://plugins.jetbrains.com/plugin/7331-thrift-support

然後去IDEA中Install plugin from disk...選擇下載的zip包安裝，然後重啟IDE即可

安裝完成的成功標誌是Compiler中出現了Thrift編譯器！如下圖所示：

五、創建 Thrift 項目並編譯（定義RPC介面）

第一步：創建Thrift項目並配置

IDE 很智能地在New Project時提供 Thrift項目創建選項：

項目創建完成以後，在Project Settings中設置好Facets的 Thrift配置，如下圖所示，這裡我們添加一個Java的Generator

在彈出的對話框中配置好Output folder路徑，該路徑用於存放由thrift文件轉化而成的java源文件：

OK，Thrift項目就緒了！

第二步：創建thrift介面文件

這裡創建一個thrift介面文件：

thrift文件的寫法我不贅述，跟gRPC一樣有其自己的語法，namespace是最後生成的介面文件的包名

在該介面文件中，我們定義了一個提供日期的Service，讓客戶端能通過該介面查詢到伺服器當前的時間

第三步：編譯Thrift源文件生成Java介面類

右擊.thrift源文件，點擊Recompile "xxx.thrift"即可完成thrift介面文件 ---> java介面文件的轉換

輸出的Java介面文件生成於上文中配置的output中，其包結構=上文.thrift文件中的namespace，其包結構如下圖所示，該Java介面十分重要，後續會用於實現Client和Server之間的RPC調用。

六、開發Thrift API介面

我們創建一個Maven項目：ThriftAPI，其包含的的就是上文由自定義Thrift介面生成的Java介面： 文件，該文件將用於後面的RPC服務端和RPC客戶端的代碼實現！

pom.xml中添加thrift依賴

添加RPCDateService.java

將上文第五步由RPCDateService.thrift生成的RPCDateService.java原樣拷貝到該Maven項目中即可，代碼結構如下：

再次強調，該ThriftAPI項目會服務於下文即將要創建的RPC服務端和RPC客戶端

七、開發RPC服務端

我們是利用SpringBoot來實現RPC服務端

pom.xml中添加依賴

這裡除了自動添加好的SpringBoot依賴外，需要額外添加的就是上文的ThriftAPI依賴了

創建Controller並實現RPC介面

這裡將伺服器當前時間以字元串形式返回給調用端！

編寫RPCThriftServer：用於啟動RPC伺服器

創建SpringBootApplication

添加配置文件application.properties

我們讓thrift服務起在6666埠！

啟動RPC服務端服務

八、開發RPC客戶端

這裡同樣用SpringBoot來實現RPC客戶端！

pom.xml中添加依賴

此處同RPC服務端依賴，不贅述

編寫RPCThriftClient：用於發出RPC調用

這裡包含兩個文件： 和

如下：

而 是利用config生成bean

編寫Restful的Controller作為調用入口

創建SpringBootApplication

添加配置文件application.properties

啟動RPC客戶端服務

九、RPC通信實驗

我們瀏覽器輸入： 即可查看客戶端從服務端取回的伺服器當前時間，說明RPC通信過程打通！

十、後記

本文實驗代碼已開源：https://gitee.com/hansonwang99/SpringBoot_RPC_Thrift

作者一些其他容器化、微服務化方面的文章：

歡迎關注作者公眾號CodeSheep，分享更多務實、能看懂、可復現的原創文

喜歡這篇文章嗎？立刻分享出去讓更多人知道吧！