C#怎么使用Thrift作為RPC框架

這篇文章主要講解了“C#怎么使用Thrift作為RPC框架”，文中的講解內(nèi)容簡單清晰，易于學習與理解，下面請大家跟著小編的思路慢慢深入，一起來研究和學習“C#怎么使用Thrift作為RPC框架”吧！

完善開發(fā)工具

通過nuget在vs2019中安裝thrift

在項目中引用右鍵點擊管理Nuget程序包，在打開的界面輸入thrift，如下圖：

我們選擇ApacheThrift這一項進行安裝，安裝后，在我們項目里有Thrift45.dll的引用，如下圖：

下載thrift代碼生成工具

thrift是支持異構(gòu)語言、異構(gòu)平臺的通信開發(fā)RPC框架，它通過中間語言IDL進行描述你要定義的結(jié)構(gòu)、類、服務等，并通過代碼生成工具生成各個語言上對應的代碼。

接下來，我們進入Apache網(wǎng)站Thrift項目下載Thrift代碼生成工具，如下圖：

我們把下載的這個exe文件放到我們項目的根目錄下，以備后用，如下圖：

至此，關(guān)于thrift的開發(fā)工具，我們已經(jīng)準備完畢，接下來來編寫thrift接口描述文件

thrift描述文件

thrift提供的接口描述文件是以thrift結(jié)尾的格式文件，我們來解釋一下這種IDL的語法，

• 它提供了基礎(chǔ)類型的定義，包括bool、i16、i32、i64、double、string

• enum

• Struct 對一些基礎(chǔ)類型的封裝，對應C#中Class字段

• 還有一些集合的定義，包含 set<> 對應C#中的HashSet，是一種唯一元素的集合（Thrift框架自己定義了THashSet類型與之相對應）；list<>對應C#中的List<>;map<K,V>對應C#的Dictionary<K,V>

• service 這個是thrift的重點，它是一些方法集合，thrift會根據(jù)這個定義生成客戶端代碼和服務端代碼

• exception 對應C#中的Exception類型

• thrift關(guān)于類型的定義以及示例代碼請打開這個網(wǎng)址：IDL描述

在IDL描述文件中，Thrift除了對類型的定義外，我們還需要記住一下知識點：

• namespace 在描述文件的頭部定義。 以當前文件為根目錄，生成多級目錄；在生成的代碼上添加namespace命名空間。代碼如下:

namespace csharp WpfApp1.ceshi

include 在描述文件的頭部定義。 用該命令包含其他thrift描述文件，當編譯生成代碼時也會編譯include指定的thrift文件。代碼如下：

include "pe1.thrift"

使用方法,pe1.thrift文件定義如下：

struct pe1
{
 1: i32 id;
}

在其他文件中，引入上述文件，定義如下：

include "pe1.thrift"

service GuidGenService
{
   string getGuid(1:pe1.pe1 pe1);
}

typedef 類型定義命令，將thrift支持的類型定義一個別名。代碼如下：

typedef i32 int
struct People
{
1: int ID;
2: string Name;
3: i16 Age;
4: list<i32> onelist;
5: set<string> oneSet;
6: map<i32,string> oneset;
}

當定義完描述文件后，我們通過如下cmd命令生成代碼文件：

thrift-0.12.0.exe -r -gen csharp People.thrift

我們先要通過cd 將當前路徑跳轉(zhuǎn)到thrift-0.12.0.exe所在的路徑

示例

我定義了了一個描述文件，如下：

namespace csharp WpfApp1.ceshi
include "pe1.thrift"

typedef i32 int

struct People
{
1: int ID;
2: string Name;
3: i16 Age;
4: list<i32> onelist;
5: set<string> oneSet;
6: map<i32,string> oneset;
}

service HelloService
{
 void SetPeople(1: People people1);
}

service GuidGenService
{
  string getGuid(1:pe1.pe1 pe1);
}

我們通過上述命令執(zhí)行后，生成的代碼結(jié)構(gòu)如下圖：

我們打開people.cs可以看到struct people生成了如下代碼：

namespace WpfApp1.ceshi
{
  #if !SILVERLIGHT
  [Serializable]
  #endif
  public partial class People : TBase
  {
    private int _ID;
    private string _Name;
    private short _Age;
    private List<int> _onelist;
    private THashSet<string> _oneSet;
    private Dictionary<int, string> _oneset;
    .....

這里需要注意一下people類的命名空間，這和我們上文講的時一致的。
我們定義的service GuidGenService生成了如下代碼：

該類是我們使用該框架的重點，它給我們生成了客戶端和服務器端代碼，從圖中我們可以看該文件下生成了兩個接口ISync和Iface，前者是同步方法，后者生成的是異步調(diào)用方法，接下來是一個供我們客戶端調(diào)用的類，它繼承了iface接口，而iface又繼承了ISync接口；再往下看是一個Processor，是服務端使用的類。

感謝各位的閱讀，以上就是“C#怎么使用Thrift作為RPC框架”的內(nèi)容了，經(jīng)過本文的學習后，相信大家對C#怎么使用Thrift作為RPC框架這一問題有了更深刻的體會，具體使用情況還需要大家實踐驗證。這里是億速云，小編將為大家推送更多相關(guān)知識點的文章，歡迎關(guān)注！