域名預(yù)訂/競(jìng)價(jià),好“米”不錯(cuò)過
這篇文章主要介紹了.Net Core中使用Grpc的方法,本文給大家介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下
一、Grpc概述
gRPC 基于如下思想:定義一個(gè)服務(wù), 指定其可以被遠(yuǎn)程調(diào)用的方法及其參數(shù)和返回類型。gRPC 默認(rèn)使用protocol buffers作為接口定義語言,來描述服務(wù)接口和有效載荷消息結(jié)構(gòu)。如果有需要的話,可以使用其他替代方案。
定義的服務(wù)分為4中類型:
單項(xiàng) RPC,即客戶端發(fā)送一個(gè)請(qǐng)求給服務(wù)端,從服務(wù)端獲取一個(gè)應(yīng)答,就像一次普通的函數(shù)調(diào)用。這種最常用。
服務(wù)端流式 RPC,即客戶端發(fā)送一個(gè)請(qǐng)求給服務(wù)端,可獲取一個(gè)數(shù)據(jù)流用來讀取一系列消息??蛻舳藦姆祷氐臄?shù)據(jù)流里一直讀取直到?jīng)]有更多消息為止。
客戶端流式 RPC,即客戶端用提供的一個(gè)數(shù)據(jù)流寫入并發(fā)送一系列消息給服務(wù)端。一旦客戶端完成消息寫入,就等待服務(wù)端讀取這些消息并返回應(yīng)答。
雙向流式 RPC,即兩邊都可以分別通過一個(gè)讀寫數(shù)據(jù)流來發(fā)送一系列消息。這兩個(gè)數(shù)據(jù)流操作是相互獨(dú)立的,所以客戶端和服務(wù)端能按其希望的任意順序讀寫,例如:服務(wù)端可以在寫應(yīng)答前等待所有的客戶端消息,或者它可以先讀一個(gè)消息再寫一個(gè)消息,或者是讀寫相結(jié)合的其他方式。每個(gè)數(shù)據(jù)流里消息的順序會(huì)被保持。
二、.Net Core中使用Grpc
使用Grpc 就三步:定義Grpc服務(wù)、實(shí)現(xiàn)Grpc服務(wù)、調(diào)用Grpc服務(wù)。
2.1 定義Grpc服務(wù)
1、在VS中選擇.Net Core創(chuàng)建類庫(kù)
2、引入Google.Protobuf、Grpc.Core包
3、創(chuàng)建proto文件,定義一個(gè)SsmServer服務(wù),服務(wù)中提供兩個(gè)方法,一個(gè)最簡(jiǎn)單的單項(xiàng)RPC方法,一個(gè)雙向流式RPC。后面這個(gè)文件會(huì)生成一個(gè)同名的C#類文件。
syntax = "proto3"; //語法指定proto3
package ShenDa.SSM.Grpc; //后面生成C#文件的命名空間
import "Protos/Common.proto";
import "Protos/Health.proto";
import "Protos/User.proto";//指定定義服務(wù)中使用的參數(shù)的位置
service SsmService{
//健康檢查 單項(xiàng) RPC
rpc Health(EmptyRequest) returns (HealthResponse){}
//雙向流
rpc User_Add(stream UserAddRequest) returns(stream UserAddResponse){}
}
定義的Health.proto文件
syntax = "proto3";
package ShenDa.SSM.Grpc;
message HealthResponse{ //返回參數(shù)
bool Success=1; //每個(gè)字段必須要指定序號(hào)
string Message=2;
}
以上服務(wù)就定義完成了?,F(xiàn)在需要將這個(gè)proto文件生成C#文件,可以使用命令,也可以使用工具。在這里我使用工具生成。
5、引用Grpc.Tools ,然后在工程文件中指定要生成的proto文件。
<ItemGroup>
<Protobuf Include="Protos\User.proto" />
<Protobuf Include="Protos\Health.proto" />
<Protobuf Include="Protos\Common.proto" />
<Protobuf Include="Protos\SsmService.proto" />
</ItemGroup>
生成項(xiàng)目,就會(huì)在 obj文件夾中生成對(duì)應(yīng)的C#文件。其他文件都是生成對(duì)應(yīng)的實(shí)體類,但是定義的服務(wù)的proto文件,比較特殊,它會(huì)生成一個(gè)同名的類文件,類中包含
一個(gè)抽象類,名稱為服務(wù)名+Base。其中包含我們定義的虛兩個(gè)方法
一個(gè)部分類,名稱為服務(wù)名+Client,繼承ClientBase<服務(wù)名Client>
以上所有的Grpc服務(wù)都已經(jīng)定義完了。因?yàn)榭蛻舳瞬豢赡苊總€(gè)都通過添加應(yīng)用項(xiàng)目的方式使用,所以我們還需要打包客戶端Nuget包。
6、生成Nuget包,提供給客戶端使用
通過VS設(shè)置打包生成Nuget包,生成Grpc客戶端Nuget包。
2.2 實(shí)現(xiàn)Grpc服務(wù)
通過VS的GRPC模板創(chuàng)建項(xiàng)目,定義實(shí)現(xiàn)類并繼承上面生成的抽象類,然后重寫我們定義的方法。
public partial class SsmServiceImpl : SsmService.SsmServiceBase
{
public override async Task<HealthResponse> Health(EmptyRequest request, ServerCallContext context)
{
var response = new HealthResponse()
{
Message = string.Empty,
Success = true
};
return await Task.FromResult(response);
}
}
配置Grpc服務(wù)
public void ConfigureServices(IServiceCollection services)
{
services.AddGrpc();
}
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
app.UseEndpoints(endpoints =>
{
endpoints.MapGrpcService<SsmServiceImpl>();//注入服務(wù)的實(shí)現(xiàn)。
endpoints.MapGet("/", async context =>
{
await context.Response.WriteAsync("Communication with gRPC endpoints must be made through a gRPC client. To learn how to create a client, visit:https://go.microsoft.com/fwlink/?linkid=2086909 ");
});
});
}
項(xiàng)目結(jié)構(gòu)截圖:
2.3 客戶端調(diào)用Grpc
1、添加引用Google.Protobuf、Grpc.Core、Grpc.Net.Client 還有剛才生成的Nuget包ShenDa.SSM.Grpc
2、調(diào)用
class Program
{
static async Task Main(string[] args)
{
var channel = GrpcChannel.ForAddress("https://localhost:5001");
var client = new SsmServiceClient(channel);
await HealthCheck(client);
}
public static async Task HealthCheck(SsmServiceClient client)
{
var response = await client.HealthAsync(new EmptyRequest());
System.Console.WriteLine(response.Success ? "健康" : "連接失敗");
}
}
總結(jié)
到此這篇關(guān)于.Net Core中使用Grpc的方法的文章就介紹到這了,更多相關(guān).Net Core使用Grpc內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
來源:腳本之家
鏈接:https://www.jb51.net/article/197559.htm
申請(qǐng)創(chuàng)業(yè)報(bào)道,分享創(chuàng)業(yè)好點(diǎn)子。點(diǎn)擊此處,共同探討創(chuàng)業(yè)新機(jī)遇!