如何使用thrift 服務引擎元件

fanly11發表於2020-05-05
元件

在本文中將介紹如何通過thrift 元件整合到surging 微服務引擎中，然後可以選擇dotnetty 或thrift作為服務遠端呼叫RPC,也可以通過其它語言的thrift 呼叫surging 服務，下面將簡單介紹如何使用thrift

準備工作

 首先需要到官網下載Thrift compiler for Windows程式碼生成工具，thrift-0.13.0.exe，然後編寫指令碼檔案，程式碼如下：

 1 namespace netstd ThriftCore
 2 
 3 service Calculator{
 4   
 5   i32 Add(1:i32 num1, 2:i32 num2)
 6   string SayHello();
 7 }
 8 
 9 
10 service ThirdCalculator{
11   
12   i32 Add(1:i32 num1, 2:i32 num2)
13   string SayHello();
14 }

在命令列中執行“thrift-0.13.0.exe --gen netstd tutorial.thrift”，會在目錄下生成“gen-netstd\ThriftCore\Calculator.cs”，“gen-netstd\ThriftCore\ThirdCalculator.cs”兩個檔案。這部分使用與以前一致，只是語言部分需要指定netstd。完成後，將gen-netstd目錄加入到專案中，並且通過nuget引用安裝ApacheThrift 元件包,然後開始編寫基於thrift 的微服務。

建立業務介面

首先要針對於生成的Calculator，ThirdCalculator編寫業務介面，業務介面需要繼承IAsync，介面程式碼如下：

IAsyncService：
1    [ServiceBundle("api/{Service}/{Method}")]
2     public interface IAsyncService: ThriftCore.Calculator.IAsync,  IServiceKey
3     {
4        [Command(ExecutionTimeoutInMilliseconds=10000)]
5         Task<int> @AddAsync(int num1, int num2, CancellationToken cancellationToken = default(CancellationToken));
6 
7         Task<string> SayHelloAsync(CancellationToken cancellationToken = default(CancellationToken));
8     }

IThirdAsyncService：

1     [ServiceBundle("api/{Service}/{Method}")]
2     public interface IThirdAsyncService : ThriftCore.ThirdCalculator.IAsync, IServiceKey
3     {
4         Task<int> @AddAsync(int num1, int num2, CancellationToken cancellationToken = default(CancellationToken));
5 
6         Task<string> SayHelloAsync(CancellationToken cancellationToken = default(CancellationToken));
7     }

建立業務領域服務

服務需要繼承IAsyncService、IThirdAsyncService業務介面，並且新增特性BindProcessor繫結Processor，程式碼如下：

AsyncService：

 1 [BindProcessor(typeof(AsyncProcessor))]
 2     public class AsyncService : ProxyServiceBase, IAsyncService
 3     {
 4         public Task<int> AddAsync(int num1, int num2, CancellationToken cancellationToken = default)
 5         {
 6             return Task.FromResult(num1 + num2);
 7         }
 8 
 9         public Task<string> SayHelloAsync(CancellationToken cancellationToken = default)
10         {
11             return Task.FromResult("hello world");
12         }
13     }

ThirdAsyncService：

 1  [BindProcessor(typeof(AsyncProcessor))]
 2     public class ThirdAsyncService : ProxyServiceBase, IThirdAsyncService
 3     {
 4         public Task<int> AddAsync(int num1, int num2, CancellationToken cancellationToken = default)
 5         {
 6             return Task.FromResult(num1 + num2);
 7         }
 8 
 9         public Task<string> SayHelloAsync(CancellationToken cancellationToken = default)
10         {
11             return Task.FromResult("hello world,third");
12         }
13     }

更改選擇Rpc元件配置

如果選擇了多種同型別的元件，就需要安裝以下配置程式碼配置surging.config,  配置如下：

啟用ThriftModule 元件：

 

1     "Packages": [
2       {
3         "TypeName": "EnginePartModule",
4         "Using": "${UseEngineParts}|ServiceProxyModule;ThriftModule;SerilogModule;NLogModule;MessagePackModule;ConsulModule;WSProtocolModule;MqttProtocolModule;EventBusRabbitMQModule;CachingModule;KestrelHttpModule;DnsProtocolModule;SwaggerModule;ApiGeteWayModule;SkywalkingModule;KestrelNLogModule;KestrelNLogModule;ServiceHostModule;GrpcModule;ApolloModule;"
5       }
6     ]

 

啟用DotNettyModule 元件：

 

    "Packages": [
      {
        "TypeName": "EnginePartModule",
        "Using": "${UseEngineParts}|ServiceProxyModule;DotNettyModule;SerilogModule;NLogModule;MessagePackModule;ConsulModule;WSProtocolModule;MqttProtocolModule;EventBusRabbitMQModule;CachingModule;KestrelHttpModule;DnsProtocolModule;SwaggerModule;ApiGeteWayModule;SkywalkingModule;KestrelNLogModule;KestrelNLogModule;ServiceHostModule;GrpcModule;ApolloModule;"
      }
    ]

服務之間RPC遠端呼叫

程式碼如下：

       var proxy = serviceProxyFactory.CreateProxy<IAsyncService>();
             var result = await proxy.SayHelloAsync();

 

第三方客戶端如何呼叫：

程式碼如下：

 1     class Program
 2     {
 3         static void Main(string[] args)
 4         {
 5             var transport = new TSocketTransport("127.0.0.1", 981);
 6             var tran = new TFramedTransport(transport);
 7             var protocol = new TBinaryProtocol(tran);
 8             var mp = new TMultiplexedProtocol(protocol, "AsyncService");
 9             var client = new Client(mp);
10             var result=  client.AddAsync(1,2).Result;
11             var result1 = client.SayHelloAsync().Result;
12             Console.WriteLine("輸出結果：{0},{1}", result, result1);
13             Console.ReadLine();
14         }
15     }

結果：

 

如何選擇dotnetty 和 thrift

引擎中實現了dotnetty 和 thrift 兩個RPC元件，需要如何選擇使用呢？

第一，通過執行10000次呼叫，我們使用和未使用Diagnostic兩個維度來對比兩個元件的效能，以下測試選擇的是messagepack 序列化元件

元件 未使用Diagnostic 已使用Diagnostic
Dotnetty 1280毫秒左右 1680毫秒左右
Thrift 860毫秒左右 1240毫秒左右

2.通過使用thrift 記憶體少了40mb。

3.使用thrift 需要建立指令碼檔案，並且通過工具生成thrift程式碼，而dotnetty不需要。

通過以上幾點對比，總結下，如果追求效能就用thrift,如果選擇高效，不繁瑣就用dotnetty.

結尾總結

通過幾年的發展，surging 已經發展成優秀的微服務引擎，為了surging 能良好的發展，而推出了商業化企業服務，已經和多家企業達成了企業支援服務，並且考慮到後期發展需要，3.0+以上版本更改成非商用協議版本，3.0版本將會更加強大，可以支援多語言混合服務，如果大家想免費可以使用surging 2.0 ，可以隨意更改定製，也希望大家能支援我的商業化行為，有錢賺才有動力去創造出優秀的產品框架。

相關文章