gRPC för .NET-konfiguration

Konfigurera tjänstalternativ

gRPC-tjänster konfigureras med AddGrpc i Startup.cs. Konfigurationsalternativ finns i paketet Grpc.AspNetCore.Server .

I följande tabell beskrivs alternativ för att konfigurera gRPC-tjänster:

Alternativ kan konfigureras för alla tjänster genom att tillhandahålla ett alternativdelegat till anropet AddGrpc i 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
    });
}

Alternativ för en enskild tjänst åsidosätter de globala alternativ som anges i AddGrpc och kan konfigureras med hjälp av 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
    });
}

Tjänstavlyssnare har en livslängd per begäran som standard. Om du registrerar interceptor-typen med DI åsidosätts hur en interceptor skapas och dess livslängd.

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

ASP.NET Core-serveralternativ

Grpc.AspNetCore.Server hanteras av en ASP.NET Core-webbserver. Det finns ett antal alternativ för ASP.NET Core-servrar, inklusive Kestrel, IIS och HTTP.sys. Varje server erbjuder ytterligare alternativ för hur HTTP-begäranden hanteras.

Servern som används av en ASP.NET Core-app konfigureras i appens startkod. Standardservern är Kestrel.

Mer information om de olika servrarna och deras konfigurationsalternativ finns i:

• Kestrel webbserver i ASP.NET Core
• HTTP.sys webbserverimplementering i ASP.NET Core
• Köra ASP.NET Core på Windows med IIS

Konfigurera klientalternativ

gRPC-klientkonfigurationen är inställd på GrpcChannelOptions. Konfigurationsalternativ finns i paketet Grpc.Net.Client .

I följande tabell beskrivs alternativ för att konfigurera gRPC-kanaler:

Följande kod:

• Anger den maximala storleken för skicka och ta emot meddelanden på kanalen.
• Skapar en klient.

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);
}

Observera att klientavlyssnare inte har konfigurerats med GrpcChannelOptions. I stället konfigureras klientavlyssnare med hjälp av Intercept tilläggsmetoden med en kanal. Den här tilläggsmetoden finns i Grpc.Core.Interceptors namnområdet.

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);
}

System.Net-hanteringsalternativ

Grpc.Net.Client använder en HTTP-transport som härleds från HttpMessageHandler för att göra HTTP-begäranden. Varje hanterare erbjuder ytterligare alternativ för hur HTTP-begäranden görs.

Hanteraren är konfigurerad på en kanal och kan åsidosättas genom att ange GrpcChannelOptions.HttpHandler. .NET Core 3 och .NET 5 eller senare används SocketsHttpHandler som standard. gRPC-klientappar på .NET Framework bör konfigurera WinHttpHandler.

Mer information om de olika hanterarna och deras konfigurationsalternativ finns i:

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

Additional resources

• gRPC-tjänster med ASP.NET Core
• Anropa gRPC-tjänster med .NET-klienten
• Loggning och diagnostik i gRPC på .NET
• Skapa en .NET gRPC-klient och -server i ASP.NET Core