.NetCore|.Net6 gRPC服務開發及本地除錯

鹹魚Y發表於2022-07-09

前言

最近在專案中實裝應用了gRPC技術，本著能把技術描述出來給別人能看的懂的思想及作為自己學習筆記的心態編寫了此文。因為在實際專案中是webApi介面和gRPC介面使用在同一專案服務中，所以本文的例子也是建立在webApi專案而非控制檯專案中。

1、gRPC介紹

gRPC 是Google發起的一個開源遠端過程呼叫系統。該系統基於HTTP/2 協議傳輸，使用Protocol Buffers 作為介面描述語言。其他功能：認證雙向流流控制超時最常見的應用場景是：微服務框架下，多種語言服務之間的高效互動。將手機服務、瀏覽器連線至後臺產生高效的客戶端庫-- 維基百科
微軟官網介紹:
gRPC是一種與語言無關的高效能遠端過程呼叫 (RPC) 框架。
gRPC 的主要好處是：
現代、高效能、輕量級的 RPC 框架。
合約優先的 API 開發，預設使用 Protocol Buffers，允許語言無關的實現。
可用於多種語言的工具來生成強型別伺服器和客戶端。
支援客戶端、伺服器和雙向流式呼叫。
通過 Protobuf 二進位制序列化減少網路使用。
這些優勢使 gRPC 非常適合：
效率至關重要的輕量級微服務。
需要多種語言進行開發的多語言系統。
需要處理流請求或響應的點對點實時服務。

2、gRPC服務端開發

服務端的介面以傳入一個組織id作為入參，返回該組織使用者基本資訊為例子 * 首先建立一個webApi專案作為服務端 ![](https://img2022.cnblogs.com/blog/855221/202207/855221-20220709130715436-144401422.png)

程式包管理器控制檯新增 Grpc.AspNetCore nuget包引用
Install-Package Grpc.AspNetCore -Version 2.47.0*
新建一個Grpc及Proto資料夾分別放置 gRPC服務和proto檔案（方便管理）
在proto資料夾下新建一個 user.proto 檔案(vs 檔案模板沒有該字尾名檔案，直接新建任意檔案改檔名即可)，在 user.proto檔案中定義gRPC服務方法、入參及返回值

點選檢視程式碼


syntax = "proto3";

option csharp_namespace = "GrpcUser";

package UserApi;

service User {
	rpc GetUserByOrganizationId(OrganizationUserRequest) returns (OrganizationUserRequestResponse) {} 
}

message OrganizationUserRequest {
	string organizationid = 1;
}
 

message OrganizationUserRequestResponse {
	string organizationid = 1;
	repeated OrganizationUserItemResponse items = 2;
}

message OrganizationUserItemResponse {
	string id = 1; 
	string name =2;
	int32 sex = 3; 
}

右鍵編輯專案檔案，增加一個節點，並把 user.proto 檔案包含進去

點選檢視程式碼

<Project Sdk="Microsoft.NET.Sdk.Web">

	<PropertyGroup>
		<TargetFramework>net6.0</TargetFramework>
		<Nullable>enable</Nullable>
		<ImplicitUsings>enable</ImplicitUsings>
	</PropertyGroup>

	<ItemGroup>
		<PackageReference Include="Grpc.AspNetCore" Version="2.47.0" />
		<PackageReference Include="Swashbuckle.AspNetCore" Version="6.2.3" />
	</ItemGroup>

	<ItemGroup>
		<Folder Include="Grpc\" />
	</ItemGroup>

	<ItemGroup>
		<Protobuf Include="Proto\user.proto" GrpcServices="Server" Generator="MSBuild:Compile"/>
	</ItemGroup>
</Project>

Grpc資料夾下新建類 UserService，並繼承 User.UserBase 並重寫 GetUserByOrganizationId 方法實現並介面業務

點選檢視程式碼


using Grpc.Core;
using GrpcUser;

namespace gRPCServer.Grpc
{
    public class UserService : User.UserBase
    {
        public override Task<OrganizationUserResponse> GetUserByOrganizationId(OrganizationUserRequest request, ServerCallContext context)
        {

            /*******此處實際業務從持久層獲取資料**********/
            var organizationUser = new OrganizationUser(request.Organizationid);
            organizationUser.Items = GetUserInfos();

            return Task.FromResult(MapToResponse(organizationUser));
        }

        private List<UserInfo> GetUserInfos()
        {
            var userInfos = new List<UserInfo>();
            userInfos.Add(new UserInfo
            {
                Id = 1,
                Name = "使用者1",
                Sex = 0
            });

            userInfos.Add(new UserInfo
            {
                Id = 2,
                Name = "使用者2",
                Sex = 1
            });

            return userInfos;
        }

        private OrganizationUserResponse MapToResponse(OrganizationUser organizationUser)
        {
            var response = new OrganizationUserResponse()
            {
                Organizationid = organizationUser.OrganizationId
            };

            organizationUser.Items.ForEach(item => response.Items.Add(new OrganizationUserItemResponse
            {
                Id = item.Id,
                Name = item.Name,
                Sex = item.Sex
            }));

            return response;
        }
    }


    public class OrganizationUser
    {
        public string? OrganizationId { get; set; }
        public List<UserInfo> Items { get; set; }
        public OrganizationUser(string organizationId)
        {
            OrganizationId = organizationId;
        }
    }

    public class UserInfo
    {
        public int Id { get; set; }
        public string Name { get; set; }
        public int Sex { get; set; }
    }
}

在Program 檔案中啟用grpc中介軟體並對映我們寫好的服務


//啟用grpc
builder.Services.AddGrpc();

//對映grpc服務
app.MapGrpcService<UserService>();

因為我們的專案是跑在webApi的專案中，所以還要配置核心去監聽另一個埠才能接收並處理gRPC的請求

builder.WebHost.ConfigureKestrel(
    options =>
    {
        //webApi監聽埠
        options.Listen(System.Net.IPAddress.Any, 5157, listenOptions =>
        {
            listenOptions.Protocols = Microsoft.AspNetCore.Server.Kestrel.Core.HttpProtocols.Http1AndHttp2;
        });

        //grpc監聽埠
        options.Listen(System.Net.IPAddress.Any, 5158, listenOptions =>
        {
            listenOptions.Protocols = Microsoft.AspNetCore.Server.Kestrel.Core.HttpProtocols.Http2;
        });
    }
    );

完整的Program

點選檢視程式碼

using gRPCServer.Grpc;

var builder = WebApplication.CreateBuilder(args);
builder.WebHost.ConfigureKestrel(
    options =>
    {
        //webApi監聽埠
        options.Listen(System.Net.IPAddress.Any, 5157, listenOptions =>
        {
            listenOptions.Protocols = Microsoft.AspNetCore.Server.Kestrel.Core.HttpProtocols.Http1AndHttp2;
        });

        //grpc監聽埠
        options.Listen(System.Net.IPAddress.Any, 5158, listenOptions =>
        {
            listenOptions.Protocols = Microsoft.AspNetCore.Server.Kestrel.Core.HttpProtocols.Http2;
        });
    }
    );


// Add services to the container.

builder.Services.AddControllers();
// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

//啟用grpc
builder.Services.AddGrpc();

var app = builder.Build();

// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

//對映grpc服務
app.MapGrpcService<UserService>();

app.UseAuthorization();

app.MapControllers();

app.Run();

這樣，我們的gRPC的服務端就搞定了，完整的專案結構就變成這樣了

3、gRPC客戶端開發

客戶端專案我們也是新建一個webApi專案，並在webapi介面中呼叫我們的gRPC服務介面獲取資料並以json格式輸出 * 首先新建一個webApi專案

程式包管理器控制檯新增 Grpc.AspNetCore nuget包引用
Install-Package Grpc.AspNetCore -Version 2.47.0
新建資料夾proto，並將 gRPCServer專案的 user.proto 檔案拷貝過來
右鍵編輯專案檔案，增加一個節點，並把 user.proto 檔案包含進去（節點Server屬性要設定為 Client）

<Project Sdk="Microsoft.NET.Sdk.Web">
	<PropertyGroup>
		<TargetFramework>net6.0</TargetFramework>
		<Nullable>enable</Nullable>
		<ImplicitUsings>enable</ImplicitUsings>
	</PropertyGroup>

	<ItemGroup>
		<PackageReference Include="Swashbuckle.AspNetCore" Version="6.2.3" />
	</ItemGroup>

	<ItemGroup>
		<Folder Include="Controllers\" />
	</ItemGroup>

	<ItemGroup>
		<Protobuf Include="Proto\user.proto" GrpcServices="Client" Generator="MSBuild:Compile"/>
	</ItemGroup>
</Project>

在Program檔案中注入 Grpc客戶端

//注入grpc客戶端
builder.Services.AddGrpcClient<GrpcUser.User.UserClient>(
    options =>
    {
        options.Address = new Uri("http://localhost:5158"); //grpcServer專案配置的grpc服務監聽埠
    });

新建控制器 UserController 呼叫 grpcClient獲取資料

using Microsoft.AspNetCore.Mvc;
using GrpcUser;

namespace gRPCClient.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class UserController : ControllerBase
    {
        private User.UserClient _userClient;
        public UserController(User.UserClient userClient)
        {
            _userClient = userClient;
        }

        /// <summary>
        /// 獲取使用者
        /// </summary>
        /// <param name="organizationId"></param>
        /// <returns></returns>
        [HttpGet]
        
        public async Task<OrganizationUserResponse> GetUser(string organizationId)
        {
            var user = await _userClient.GetUserByOrganizationIdAsync(new OrganizationUserRequest { Organizationid = organizationId });

            return user;
        }
    }
}

先啟動 grpcSever專案，然後再啟動 client專案，在swagger頁面呼叫 GetUser方法即可獲取到grpc介面返回資料，Grpc服務於客戶端呼叫就搭建好了
完整專案結構

4、gRPC服務端介面本地除錯

grpcServer的介面服務不能像webApi一樣直接啟動就能進行除錯，需要藉助一些第三方中介軟體進行協助測試。我這邊使用的是grpcui 進行對本地grpc服務介面的開發除錯，下面是grpcui的安裝及使用步驟

grpcui是Go語言編寫的，所以第一步我們先要進行Go環境的搭建。
開啟Go官網，下載並安裝
安裝完成，以管理員身份開啟PowerShell,並修改Go環境變數
go env -w GO111MODULE=on
因為Go 包源在外網，所以我們要設定一些代理，方便安裝
go env -w GOPROXY=https://goproxy.cn,direct
安裝grpcui
go install github.com/fullstorydev/grpcui/cmd/grpcui@latest
安裝完成即可使用命令測試是否安裝成功
grpcui --help
安裝完除錯工具還需要修改一些我們的grpcService專案，讓專案把grpc服務介面給反射出來，grpcui工具才能獲取到相應介面並以webUi的方式進行除錯
程式包管理器控制檯新增 Grpc.AspNetCore.Server.Reflection nuget包引用
Install-Package Grpc.AspNetCore.Server.Reflection -Version 2.47.0
專案注入grpc服務反射包服務
builder.Services.AddGrpcReflection();
啟用grpc對映
app.MapGrpcReflectionService();
最終gRPCServer專案的Program 檔案配置如下

using gRPCServer.Grpc;

var builder = WebApplication.CreateBuilder(args);
builder.WebHost.ConfigureKestrel(
    options =>
    {
        //webApi監聽埠
        options.Listen(System.Net.IPAddress.Any, 5157, listenOptions =>
        {
            listenOptions.Protocols = Microsoft.AspNetCore.Server.Kestrel.Core.HttpProtocols.Http1AndHttp2;
        });

        //grpc監聽埠
        options.Listen(System.Net.IPAddress.Any, 5158, listenOptions =>
        {
            listenOptions.Protocols = Microsoft.AspNetCore.Server.Kestrel.Core.HttpProtocols.Http2;
        });
    }
    );


// Add services to the container.

builder.Services.AddControllers();
// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

//啟用grpc
builder.Services.AddGrpc();
//啟用grpc反射
builder.Services.AddGrpcReflection();

var app = builder.Build();

// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

//對映grpc服務
app.MapGrpcService<UserService>();

//對映grpc反射服務
app.MapGrpcReflectionService();

app.UseAuthorization();

app.MapControllers();

app.Run();

啟動gRPC專案
PowerShell 執行命令 grpcui -plaintext {grpc服務的ip埠地址} 即可開啟webUi介面除錯grpc介面
啟動的WebUI除錯頁面

在此頁面我們就可以像使用Postman除錯webApi一樣除錯我們的grpc介面了

參考資料：
微軟gRPC使用教程：https://docs.microsoft.com/en-us/aspnet/core/grpc/?view=aspnetcore-6.0
grpcui測試grpc服務教程：https://docs.microsoft.com/en-us/aspnet/core/grpc/test-tools?view=aspnetcore-6.0
grpcui專案教程：https://github.com/fullstorydev/grpcui

本地除錯遠端服務
2024-11-04
除錯
【.NET6】gRPC服務端和客戶端開發案例，以及minimal API服務、gRPC服務和傳統webapi服務的訪問效率大對決
2021-12-11
RPC服務端客戶端APIWeb
使用 gRPC-UI 除錯.NET 5的gPRC服務
2021-01-20
RPCUI除錯
.NET Core微服務開發服務間呼叫篇-GRPC
2020-07-16
微服務RPC
微信開發的本地除錯環境搭建
2016-06-20
除錯
使用Golang搭建gRPC服務提供給.NetCore客戶端呼叫
2021-10-04
GolangRPCNetCore客戶端
十分鐘學會Golang開發gRPC服務
2022-04-20
GolangRPC
C# netCore Grpc服務（2）配置，proto以及四種呼叫方式
2019-11-04
C#NetCoreRPC
NetCore服務虛擬化01（叢集元件Sodao.Core.Grpc）
2018-12-01
NetCore元件RPC
編譯除錯Net6原始碼
2022-07-01
編譯除錯原始碼
如何在本地開發環境除錯微信 JS-SDK
2018-05-20
開發環境除錯JS
net6 類中獲取服務
2024-04-16
.Net Core(.Net6)建立grpc
2023-02-14
RPC
Windows服務除錯小結（附Demo）
2014-12-04
Windows除錯
SpringBoot配置HTTPS及開發除錯
2024-04-29
Spring BootHTTP除錯
分散式服務框架 gRPC
2019-11-17
分散式框架RPC
讓 gRPC 提供 REST 服務
2021-02-19
RPCREST
從零開始搭建 gRPC 服務 – Golang 篇（一）
2018-12-12
RPCGolang
從零開始搭建 gRPC 服務 - Golang 篇（二）
2018-12-29
RPCGolang
5分鐘搞定服務端本地開發遠端執行
2018-10-03
服務端
.NET Core(.NET6)中gRPC使用
2022-04-14
RPC
搭建本地 mock 服務
2018-12-22
Mock
線上本地除錯大觀
2011-07-26
除錯
grpc套路服務端編寫
2020-08-18
RPC服務端
用 Golang 構建 gRPC 服務
2019-11-17
GolangRPC
GRPC 服務呼叫實踐（一）
2019-11-12
RPC
golang consul-grpc 服務註冊與發現
2018-06-23
GolangRPC
grpc套路（四）php通過grpc呼叫golang的grpc介面服務
2020-08-22
RPCPHPGolang
Netty服務端開發及效能最佳化
2023-05-05
Netty服務端
使用 gRPCurl 除錯.NET 5的gPRC服務
2021-01-19
RPC除錯
本地除錯PERL CGI程式(轉)
2007-08-10
除錯
debug技巧之本地除錯
2024-05-09
除錯
WordPress開發入門01：Windows本地安裝WordPress和PHP除錯環境
2018-07-08
WindowsPHP除錯
grpc實戰——服務端流式呼叫
2021-09-09
RPC服務端
go基於grpc構建微服務框架-服務註冊與發現
2018-04-20
GoRPC微服務框架
VS - 打斷點/本地除錯/遠端除錯問題
2024-03-13
斷點除錯
抖音本地生活服務出新規，本地服務系統OEM成新風口！
2023-04-17
整車電效能裝置開發及測試服務
2019-11-13

.NetCore|.Net6 gRPC服務開發及本地除錯

前言

1、gRPC介紹

2、gRPC服務端開發

3、gRPC客戶端開發

4、gRPC服務端介面本地除錯

相關文章