gRPC voor .NET-configuratie

Servicesopties configureren

gRPC-services worden geconfigureerd met AddGrpc in Startup.cs. Configuratieopties bevinden zich in het Grpc.AspNetCore.Server pakket.

In de volgende tabel worden opties beschreven voor het configureren van gRPC-services:

Opties kunnen worden geconfigureerd voor alle services door een optie te bieden die delegeren aan de AddGrpc aanroep 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
    });
}

Opties voor één service overschrijven de algemene opties die worden AddGrpc geleverd en kunnen worden geconfigureerd met behulp van 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
    });
}

Service-interceptors hebben standaard een levensduur per aanvraag. Als u het snijpunttype registreert bij DI, wordt overschreven hoe een interceptor wordt gemaakt en de levensduur ervan.

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

ASP.NET Core-serveropties

Grpc.AspNetCore.Server wordt gehost door een ASP.NET Core-webserver. Er zijn een aantal opties voor ASP.NET Core-servers, waaronder KestrelIIS en HTTP.sys. Elke server biedt extra opties voor de wijze waarop HTTP-aanvragen worden verwerkt.

De server die wordt gebruikt door een ASP.NET Core-app is geconfigureerd in de opstartcode van de app. De standaardserver is Kestrel.

Zie voor meer informatie over de verschillende servers en hun configuratieopties:

• Kestrel webserver in ASP.NET Core
• HTTP.sys webserver-implementatie in ASP.NET Core
• Host ASP.NET Core op Windows met IIS

Clientopties configureren

gRPC-clientconfiguratie is ingesteld op GrpcChannelOptions. Configuratieopties bevinden zich in het Grpc.Net.Client pakket.

In de volgende tabel worden opties beschreven voor het configureren van gRPC-kanalen:

De volgende code:

• Hiermee stelt u de maximale grootte van het verzenden en ontvangen van berichten op het kanaal in.
• Hiermee maakt u een 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);
}

Houd er rekening mee dat client interceptors niet zijn geconfigureerd met GrpcChannelOptions. In plaats daarvan worden client interceptors geconfigureerd met behulp van de Intercept extensiemethode met een kanaal. Deze extensiemethode bevindt zich in de Grpc.Core.Interceptors naamruimte.

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 handleropties

Grpc.Net.Client maakt gebruik van een HTTP-transport afgeleid van HttpMessageHandler om HTTP-aanvragen te maken. Elke handler biedt extra opties voor de manier waarop HTTP-aanvragen worden gedaan.

De handler is geconfigureerd op een kanaal en kan worden overschreven door de instelling in te stellen GrpcChannelOptions.HttpHandler. .NET Core 3 en .NET 5 of hoger worden standaard gebruikt SocketsHttpHandler . gRPC-client-apps op .NET Framework moeten WinHttpHandler configureren.

Zie voor meer informatie over de verschillende handlers en hun configuratieopties:

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

Additional resources

• gRPC-services met ASP.NET Core
• gRPC-services aanroepen met de .NET-client
• Logboekregistratie en diagnostische gegevens in gRPC op .NET
• Een .NET gRPC-client en -server maken in ASP.NET Core