Cấu hình gRPC cho .NET

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

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

Bảng sau mô tả các tùy chọn để 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ả 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ụ đơn lẻ ghi đè các tùy chọn toàn cục được cung cấp trong AddGrpc và có thể được cấu hình bằ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
    });
}

Các interceptor dịch vụ có vòng đời theo từng yêu cầu theo mặc định. Đăng ký loại interceptor với DI sẽ ghi đè cách tạo và vòng đời của interceptor.

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

Tùy chọn server ASP.NET Core

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

Server được sử dụng bởi ứng dụng ASP.NET Core được cấu hình trong code khởi động ứng dụng. Server mặc định là Kestrel.

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

• Kestrel web server trong ASP.NET Core
• HTTP.sys web server trong ASP.NET Core
• Host ASP.NET Core trên Windows với IIS

Cấu hình tùy chọn client

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

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

Đoạn code sau:

• Đặt kích thước thông điệp gửi và nhận tối đa trên kênh.
• Tạo một client.

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 interceptor client không được cấu hình bằng GrpcChannelOptions. Thay vào đó, các interceptor client được 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 handler System.Net

Grpc.Net.Client sử dụng HTTP transport được dẫn xuất từ HttpMessageHandler để thực hiện các yêu cầu HTTP. Mỗi handler cung cấp các tùy chọn bổ sung cho cách thực hiện các yêu cầu HTTP.

Handler được cấu hình trên kênh và có thể được ghi đè bằng cách đặ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 gRPC client trên .NET Framework nên cấu hình WinHttpHandler.

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

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