ASP.NET Core: gRPC cho cấu hình .NET

Trong bài viết này

1. Định cấu hình tùy chọn dịch vụ
2. Định cấu hình tùy chọn máy khách
3. Tài nguyên bổ sung

Định cấu hình tùy chọn dịch vụ

Các dịch vụ gRPC được định cấu hình AddGrpc bằng Startup.cs. hoặc Program.cs. Tùy chọn cấu hình có trong gói Grpc.AspNetCore.Server.

Bảng sau mô tả các tùy chọn để định cấu hình dịch vụ gRPC:

Các tùy chọn có thể được cấu hình cho tất cả các dịch vụ bằng cách cung cấp một delegate tùy chọn cho lời gọi AddGrpc trong Startup.ConfigureServices:

public void ConfigureServices(IServiceCollection services)
{
    services.AddGrpc(options =>
    {
        options.EnableDetailedErrors = true;
        options.MaxReceiveMessageSize = 2 * 1024 * 1024; // 2 MB
        options.MaxSendMessageSize = 5 * 1024 * 1024; // 5 MB
    });
}

Các tùy chọn cho một dịch vụ sẽ ghi đè các tùy chọn chung được cung cấp trong AddGrpc và có thể được định cấu hình bằng cách sử dụng AddServiceOptions<TService>:

public void ConfigureServices(IServiceCollection services)
{
    services.AddGrpc().AddServiceOptions<MyService>(options =>
    {
        options.MaxReceiveMessageSize = 2 * 1024 * 1024; // 2 MB
        options.MaxSendMessageSize = 5 * 1024 * 1024; // 5 MB
    });
}

Theo mặc định, các bộ chặn dịch vụ có thời gian tồn tại theo yêu cầu. Việc đăng ký loại thiết bị chặn với DI sẽ ghi đè cách tạo thiết bị chặn và thời gian tồn tại của nó.

public void ConfigureServices(IServiceCollection services)
{
    services.AddGrpc(options =>
    {
        options.Interceptors.Add<LoggingInterceptor>();
    });
    services.AddSingleton<LoggingInterceptor>();
}

Tùy chọn máy chủ ASP.NET Core

Grpc.AspNetCore.Server được lưu trữ bởi một máy chủ web ASP.NET Core. Có một số tùy chọn cho máy chủ ASP.NET Core, bao gồm Kestrel, IIS và HTTP.sys. Mỗi máy chủ cung cấp các tùy chọn bổ sung về cách phân phát các yêu cầu HTTP.

Máy chủ được ứng dụng ASP.NET Core sử dụng được định cấu hình trong mã khởi động ứng dụng. Máy chủ mặc định là Kestrel.

Để biết thêm thông tin về các máy chủ khác nhau và các tùy chọn cấu hình của chúng, hãy xem:

• Máy chủ web Kestrel trong ASP.NET Core
• Triển khai máy chủ web HTTP.sys trong ASP.NET Core
• Lưu trữ ASP.NET Core trên Windows bằng IIS

Định cấu hình tùy chọn máy khách

Cấu hình máy khách gRPC được đặt trên GrpcChannelOptions. Tùy chọn cấu hình có trong gói Grpc.Net.Client.

Bảng sau mô tả các tùy chọn để định cấu hình kênh gRPC:

Đoạn code sau sau đây sẽ:

• Đặt kích thước tin nhắn gửi và nhận tối đa trên kênh.
• Tạo một máy khách.

static async Task Main(string[] args)
{
    var channel = GrpcChannel.ForAddress("https://localhost:5001", new GrpcChannelOptions
    {
        MaxReceiveMessageSize = 5 * 1024 * 1024, // 5 MB
        MaxSendMessageSize = 2 * 1024 * 1024 // 2 MB
    });
    var client = new Greeter.GreeterClient(channel);

    var reply = await client.SayHelloAsync(
                      new HelloRequest { Name = "GreeterClient" });
    Console.WriteLine("Greeting: " + reply.Message);
}

Lưu ý rằng các thiết bị chặn máy khách không được định cấu hình bằng GrpcChannelOptions. Thay vào đó, các thiết bị chặn máy khách được định cấu hình bằng  phương thức mở rộng Intercept với một kênh. Phương thức mở rộng này nằm trong namespace Grpc.Core.Interceptors.

static async Task Main(string[] args)
{
    var channel = GrpcChannel.ForAddress("https://localhost:5001");
    var callInvoker = channel.Intercept(new LoggingInterceptor());
    var client = new Greeter.GreeterClient(callInvoker);

    var reply = await client.SayHelloAsync(
                      new HelloRequest { Name = "GreeterClient" });
    Console.WriteLine("Greeting: " + reply.Message);
}

Tùy chọn xử lý System.Net

Grpc.Net.Client sử dụng phương thức vận chuyển HTTP dẫn xuất từ HttpMessageHandler để thực hiện các yêu cầu HTTP. Mỗi trình xử lý cung cấp các tùy chọn bổ sung về cách thực hiện các yêu cầu HTTP.

Trình xử lý được định cấu hình trên một kênh và có thể bị ghi đè bằng cách cài đặt GrpcChannelOptions.HttpHandler. .NET Core 3 và .NET 5 trở lên sử dụng SocketsHttpHandler theo mặc định. Các ứng dụng khách gRPC trên .NET Framework nên định cấu hình WinHttpHandler.

Để biết thêm thông tin về các trình xử lý khác nhau và các tùy chọn cấu hình của chúng, hãy xem:

• System.Net.Http.SocketsHttpHandler
• System.Net.Http.WinHttpHandler

Tài nguyên bổ sung

• Dịch vụ gRPC với ASP.NET Core
• Gọi các dịch vụ gRPC bằng máy khách .NET
• Ghi nhật ký và chẩn đoán trong gRPC trên .NET
• Tạo máy khách và máy chủ .NET Core gRPC trong ASP.NET Core