1. 程式人生 > >Thrift入門初探--thrift安裝及java入門例項

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

主要任務是高效的接受客戶端請求,並將請求轉發給Processor處理。Processor負責對客戶端的請求做出響應,包括RPC請求轉發,呼叫引數解析和使用者邏輯呼叫,返回值寫回等處理。從TProtocol以下部分是thirft的傳輸協議和底層I/O通訊。TProtocol是用於資料型別解析的,將結構化資料轉化為位元組流給TTransport進行傳輸。TTransport是與底層資料傳輸密切相關的傳輸層,負責以位元組流方式接收和傳送訊息體,不關注是什麼資料型別。底層IO負責實際的資料傳輸,包括socket、檔案和壓縮資料流等。

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框架介紹