重新整理 .net core 实践篇—————grpc[三十三]

前言

简单整理一下grpc。

正文

什么是grpc?

  1. 一个远程过程调用框架,可以像类一样调用远程方法。

这种模式一般来说就是代理模式,然后都是框架自我生成的。

  1. 由google 公司发起并开源,故而前面有个g。

grpc的特点:

  1. 提供几乎所有主流语言的实现,打破语言隔阂。

  2. 基于http/2,开放协议,收到广泛的支持,易于实现和集成

http/2 有个特点哈,就是更快,可以了解下,后续会专门整理关于http相关的,要等网络原理整理完后。

  1. 默认使用protocol buffers 序列化,性能相较于restful json好很多

  2. 工具链成熟,代码生成便捷,开箱即用

  3. 支持双向流式的请求和相应,对批量处理、低延迟场景友好

.net 生态对gRPC的支持情况:

  1. 提供基于httpClient 的原生框架的实现

  2. 提供了原生的ASP .net Core 集成库

  3. 提供完整的代码工具

  4. visual studio 和 visual Stuido Code 提供proto 文件的智能提示
    实践:

service 服务端:

.net core 在服务端使用的包:

  1. Grpc.AspNetCore

客户端使用的包:

  1. google.protobuf

  2. Grpc.Net.Client

  3. Grpc.Net.ClientFactory

  4. Grpc.Tools

通过工具会生成proto 文件。

proto 文件:

  1. 定义包、库名

  2. 定义服务"service"

  3. 定义输入输出模型"message"

gRPC 异常处理:

  1. 使用Grpc.Core.RpcException

  2. 使用Grpc.Core.Interceptors.Interceptor

grpc 的加密方式:

grpc 因为是http2,默认使用https证书。

也可以不使用证书,里面可以设置,如果设置了,那么就是不加密的。

  1. 注入服务
services.AddGrpcClient<Greeter.GreeterClient>(options =>
{
	options.Address = new Uri("https://localhost:5001");
});
  1. 测试代码
app.UseEndpoints(endpoints =>
{
	endpoints.MapGet("/", async context =>
	{
		Greeter.GreeterClient service = context.RequestServices.GetService<Greeter.GreeterClient>();

		HelloRequest helloRequest = new HelloRequest();
		var reply = await service.SayHelloAsync(helloRequest);
		Console.Read();
	});
	endpoints.MapControllers();
});
  1. 结果

重新整理 .net core 实践篇—————grpc[三十三]

这样就可以调用了。

这里如果我们使用http://localhost:5000,那么访问会失败,显示协议不可用,不支持http1.1。

重新整理 .net core 实践篇—————grpc[三十三]

那么如果需要http的话,就需要配置一些http2了。

在服务端的配置文件中,这样写:

  "Kestrel": {
    "Endpoints": {
      "Http": {
        "Url": "http://*:5000"
      },
      "Https": {
        "Url": "https://*:5001"
      },
      "Http2": {
        "Url": "http://*:5002",
        "Protocols": "Http2"
      }
    }
  }

将http2的url设置为http://*:5002。

然后你就发现报错了:

重新整理 .net core 实践篇—————grpc[三十三]

这个问题也是比较简单的,因为http2默认使用加密,也就是应用解密的方式去解,自然就出错了。

那么需要这样:

AppContext.SetSwitch("System.Net.Http.SocketsHttpHandler.Http2UnencryptedSupport",true);

支持不使用加密方式的http2。如果是在内网内,可以不使用加密方式,这样更加流畅。

那么还有一种情况就是如果在有证书的情况下,那么我们的开发环境可能就跑不过了,因为本地使用自签名证书,通过不了验证。

下面是生成证书的powershell脚本,百度的。

# setup certificate properties including the commonName (DNSName) property for Chrome 58+
$certificate = New-SelfSignedCertificate `
    -Subject 改成自己想要的标题不要带乱七八糟的符号(安装证书的时候会显示这个) `
    -DnsName 友好域名 `
    -KeyAlgorithm RSA `
    -KeyLength 2048 `
    -NotBefore (Get-Date) `
    -NotAfter (Get-Date).AddYears(2) `
    -CertStoreLocation "cert:CurrentUser\My" `
    -FriendlyName "证书的友好名称,在IIS指定的时候显示Certificate for .NET Core" `
    -HashAlgorithm SHA256 `
    -KeyUsage DigitalSignature, KeyEncipherment, DataEncipherment `
    -TextExtension @("2.5.29.37={text}1.3.6.1.5.5.7.3.1")
$certificatePath = 'Cert:\CurrentUser\My\' + ($certificate.ThumbPrint) 
 
# create temporary certificate path
$tmpPath = "C:\tmp"
If(!(test-path $tmpPath))
{
New-Item -ItemType Directory -Force -Path $tmpPath
}
 
# set certificate password here
$pfxPassword = ConvertTo-SecureString -String "证书的密码" -Force -AsPlainText
$pfxFilePath = "c:\tmp\证书的名称.pfx"
$cerFilePath = "c:\tmp\证书的名称.cer"
 
# create pfx certificate
Export-PfxCertificate -Cert $certificatePath -FilePath $pfxFilePath -Password $pfxPassword
Export-Certificate -Cert $certificatePath -FilePath $cerFilePath
 
# import the pfx certificate
Import-PfxCertificate -FilePath $pfxFilePath Cert:\LocalMachine\My -Password $pfxPassword -Exportable
 
# trust the certificate by importing the pfx certificate into your trusted root
Import-Certificate -FilePath $cerFilePath -CertStoreLocation Cert:\CurrentUser\Root
 
# optionally delete the physical certificates (don’t delete the pfx file as you need to copy this to your app directory)
# Remove-Item $pfxFilePath
Remove-Item $cerFilePath

然后在服务端配置一下证书:

  "Kestrel": {
    "Endpoints": {
      "Http": {
        "Url": "http://*:5000"
      },
      "Https": {
        "Url": "https://*:5001"
      },
      "Http2": {
        "Url": "http://*:5002",
        "Protocols": "Http2"
      }
    },
    "Certificates": {
      "Default": {
        "Path": "self.cer",
        "Password": "123456"
      }
    }
  }

Certificates 配置了默认证书。

那么客户端请求一下https://localhost:5001.

返回:

重新整理 .net core 实践篇—————grpc[三十三]

那么这个时候无论证书验证是否成功,都返回true:

services.AddGrpcClient<Greeter.GreeterClient>(options =>
{
	options.Address = new Uri("https://localhost:5001");
}).ConfigurePrimaryHttpMessageHandler(provider =>
{
	var handle = new SocketsHttpHandler();
	handle.SslOptions.RemoteCertificateValidationCallback = (a, b, c, d) => true;
	return handle;
});

然后就可以访问了。

下面整理一下异常拦截器,如果我们服务端发生异常,我们希望有某种规律的错误发出。

测试异常:

public override Task<HelloReply> SayHello(HelloRequest request, ServerCallContext context)
{
	throw new Exception("异常信息");
	return Task.FromResult(new HelloReply
	{
		Message = "Hello " + request.Name
	});
}

重新整理 .net core 实践篇—————grpc[三十三]

通过异常拦截器过滤一下:

services.AddGrpc(options =>
 {
        options.EnableDetailedErrors = false;
         options.Interceptors.Add<ExceptionInterceptor>();
  });

具体异常拦截类:

public override async Task<TResponse> UnaryServerHandler<TRequest, TResponse>(TRequest request, ServerCallContext context, UnaryServerMethod<TRequest, TResponse> continuation)
{
	try
	{
		return await base.UnaryServerHandler(request, context, continuation);
	}
	catch (Exception ex)
	{
		//log 处理
		Metadata entries = new Metadata();
		entries.Add("message",ex.Message);
		throw new RpcException(new Status(StatusCode.Unknown, "Unknown"), entries);
	}
}

调试:

重新整理 .net core 实践篇—————grpc[三十三]

重新整理 .net core 实践篇—————grpc[三十三]

下一节实践一下用工具生成grpc 代码。

上一篇:什么是grpc和protobuf


下一篇:【Python 上手 GRPC】(一)初体验