gRPC pro konfiguraci .NET

Konfigurace možností služeb

Služby gRPC jsou nakonfigurovány AddGrpc v Startup.cssystému . Možnosti konfigurace jsou v Grpc.AspNetCore.Server balíčku.

Následující tabulka popisuje možnosti konfigurace služeb gRPC:

Možnosti lze nakonfigurovat pro všechny služby poskytnutím delegáta možností na AddGrpc hovor v 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
    });
}

Možnosti jedné služby přepíší globální možnosti uvedené v AddGrpc této službě a dají se nakonfigurovat pomocí 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
    });
}

Zachytávání služeb má ve výchozím nastavení životnost jednotlivých požadavků. Registrace typu zachytávání pomocí di přepisuje způsob vytvoření průsečíku a jeho životnost.

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

Možnosti serveru ASP.NET Core

Grpc.AspNetCore.Server hostuje webový server ASP.NET Core. Existuje řada možností pro servery ASP.NET Core, včetně Kestrel, SLUŽBY IIS a HTTP.sys. Každý server nabízí další možnosti obsluhy požadavků HTTP.

Server používaný aplikací ASP.NET Core se konfiguruje ve spouštěcím kódu aplikace. Výchozí server je Kestrel.

Další informace o různýchserverch

• Kestrel webový server v ASP.NET Core
• Implementace webového serveru HTTP.sys v ASP.NET Core
• Hostování ASP.NET Core ve Windows pomocí služby IIS

Konfigurace možností klienta

Konfigurace klienta gRPC je nastavena na .GrpcChannelOptions Možnosti konfigurace jsou v Grpc.Net.Client balíčku.

Následující tabulka popisuje možnosti konfigurace kanálů gRPC:

Následující kód:

• Nastaví maximální velikost zprávy pro odesílání a přijímání v kanálu.
• Vytvoří klienta.

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

Všimněte si, že průsečíky klienta nejsou nakonfigurovány na GrpcChannelOptions. Místo toho se zachytávání klientů konfigurují pomocí Intercept metody rozšíření s kanálem. Tato metoda rozšíření je v Grpc.Core.Interceptors oboru názvů.

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

možnosti obslužné rutiny System.Net

Grpc.Net.Client používá přenos HTTP odvozený z HttpMessageHandler provádění požadavků HTTP. Každá obslužná rutina nabízí další možnosti, jak se provádějí požadavky HTTP.

Obslužná rutina je nakonfigurována v kanálu a lze ji přepsat nastavením GrpcChannelOptions.HttpHandler. .NET Core 3 a .NET 5 nebo novější používá SocketsHttpHandler ve výchozím nastavení. Klientské aplikace gRPC v rozhraní .NET Framework by měly konfigurovat Rutinu WinHttpHandler.

Další informace o různých obslužných rutinách a jejich možnostech konfigurace najdete tady:

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

Další materiály

• Služby gRPC s ASP.NET Core
• Volání služeb gRPC pomocí klienta .NET
• Protokolování a diagnostika v gRPC v .NET
• Vytvoření serveru a klienta .NET Core gRPC v ASP.NET Core