gRPC para configuração do .NET

Configurar opções de serviços

Os serviços gRPC são configurados com AddGrpc no Startup.cs. As opções de configuração estão no pacote Grpc.AspNetCore.Server.

A tabela a seguir descreve as opções para configurar os serviços gRPC:

As opções podem ser configuradas para todos os serviços por meio do fornecimento de um delegado de opções para a chamada AddGrpc em 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
    });
}

As opções para um único serviço substituem as opções globais fornecidas em AddGrpc e podem ser configuradas usando 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
    });
}

Por padrão, os interceptadores de serviço têm um tempo de vida por solicitação. Registrar o tipo de interceptador com a DI substitui a forma como um interceptador é criado e seu tempo de vida.

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

Opções de servidor do ASP.NET Core

Grpc.AspNetCore.Server é hospedado por um servidor Web do ASP.NET Core. Há várias opções para servidores ASP.NET Core, incluindo Kestrel, IIS e HTTP.sys. Cada servidor oferece opções adicionais para como as solicitações HTTP são atendidas.

O servidor usado por um aplicativo ASP.NET Core é configurado no código de inicialização do aplicativo. O servidor padrão é Kestrel.

Para obter mais informações sobre os diferentes servidores e suas opções de configuração, confira:

• Kestrelservidor Web no ASP.NET Core
• Implementação do servidor Web HTTP.sys no ASP.NET Core
• Hospedar o ASP.NET Core no Windows com o IIS

Configurar opções de cliente

A configuração do cliente gRPC é definida em GrpcChannelOptions. As opções de configuração estão no pacote Grpc.Net.Client.

A tabela a seguir descreve as opções para configurar canais gRPC:

O seguinte código:

• Define o tamanho máximo de mensagens a serem enviadas e recebidas no canal.
• Cria um cliente.

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

Note que os interceptadores de cliente não estão configurados com GrpcChannelOptions. Em vez disso, os interceptadores de cliente são configurados usando o método de extensão Intercept com um canal. Esse método de extensão está no 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);
}

Opções de manipulador do System.Net

Grpc.Net.Client usa um transporte HTTP derivado de HttpMessageHandler para fazer solicitações HTTP. Cada manipulador oferece opções adicionais sobre como as solicitações HTTP são feitas.

O manipulador é configurado em um canal e pode ser substituído ao definir GrpcChannelOptions.HttpHandler. Por padrão, o .NET Core 3 e o .NET 5 ou posterior usam SocketsHttpHandler. Os aplicativos do cliente gRPC no .NET Framework devem configurar o WinHttpHandler.

Para obter mais informações sobre os diferentes manipuladores e suas opções de configuração, confira:

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

Recursos adicionais

• Serviços do gRPC com o ASP.NET Core
• Chamar os serviços gRPC com o cliente .NET
• Registro em log e diagnóstico no gRPC no .NET
• Criar um cliente e um servidor gRPC do .NET Core no ASP.NET Core