.NET yapılandırması için gRPC

Hizmet seçeneklerini yapılandırma

gRPC hizmetleri içinde Startup.csile AddGrpc yapılandırılır. Yapılandırma seçenekleri pakettedir Grpc.AspNetCore.Server .

Aşağıdaki tabloda gRPC hizmetlerini yapılandırma seçenekleri açıklanmaktadır:

seçenekleri, içinde arama Startup.ConfigureServicesiçin AddGrpc bir seçenek temsilcisi sağlayarak tüm hizmetler için yapılandırılabilir:

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

Tek bir hizmet için seçenekler, içinde AddGrpc sağlanan genel seçenekleri geçersiz kılar ve kullanılarak AddServiceOptions<TService>yapılandırılabilir:

public void ConfigureServices(IServiceCollection services)
{
    services.AddGrpc().AddServiceOptions<MyService>(options =>
    {
        options.MaxReceiveMessageSize = 2 * 1024 * 1024; // 2 MB
        options.MaxSendMessageSize = 5 * 1024 * 1024; // 5 MB
    });
}

Hizmet kesme aracılarının varsayılan olarak istek başına yaşam süresi vardır. Kesme noktası türünün DI ile kaydedilmesi, bir kesme noktasının nasıl oluşturulduğunu ve ömrünü geçersiz kılar.

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

ASP.NET Core sunucu seçenekleri

Grpc.AspNetCore.Server bir ASP.NET Core web sunucusu tarafından barındırılır. ASP.NET Core sunucuları için, IIS ve HTTP.sys gibi Kestrelçeşitli seçenekler vardır. Her sunucu, HTTP isteklerinin nasıl sunulduğuna ilişkin ek seçenekler sunar.

ASP.NET Core uygulaması tarafından kullanılan sunucu, uygulama başlatma kodunda yapılandırılır. Varsayılan sunucu şeklindedir Kestrel.

Farklı sunucular ve yapılandırma seçenekleri hakkında daha fazla bilgi için bkz:

• Kestrel ASP.NET Core'da web sunucusu
• ASP.NET Core'da HTTP.sys web sunucusu uygulaması
• IIS ile Windows'da ASP.NET Core'u barındırma

İstemci seçeneklerini yapılandırma

gRPC istemci yapılandırması üzerinde GrpcChannelOptionsayarlanır. Yapılandırma seçenekleri pakettedir Grpc.Net.Client .

Aşağıdaki tabloda gRPC kanallarını yapılandırma seçenekleri açıklanmaktadır:

Aşağıdaki kod:

• Kanalda ileti gönderme ve alma boyutu üst sınırını ayarlar.
• bir istemci oluşturur.

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

İstemci kesme yollarının ile GrpcChannelOptionsyapılandırılmadığını unutmayın. Bunun yerine, istemci kesme cihazları bir kanal ile uzantı yöntemi kullanılarak Intercept yapılandırılır. Bu uzantı yöntemi ad alanındadır 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);
}

System.Net işleyici seçenekleri

Grpc.Net.Client , HTTP isteklerinde bulunmak için adresinden HttpMessageHandler türetilen bir HTTP aktarım kullanır. Her işleyici, HTTP isteklerinin nasıl yapıldığına yönelik ek seçenekler sunar.

İşleyici bir kanalda yapılandırılır ve ayarıyla GrpcChannelOptions.HttpHandlergeçersiz kılınabilir. .NET Core 3 ve .NET 5 veya üzeri varsayılan olarak kullanır SocketsHttpHandler . .NET Framework'te gRPC istemci uygulamaları WinHttpHandler'ı yapılandırmalıdır.

Farklı işleyiciler ve yapılandırma seçenekleri hakkında daha fazla bilgi için bkz:

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

Ek kaynaklar

• ASP.NET Core ile gRPC hizmetleri
• .NET istemcisiyle gRPC hizmetlerini çağırma
• .NET üzerinde gRPC'de günlüğe kaydetme ve tanılama
• ASP.NET Core'de .NET Core gRPC istemcisi ve sunucusu oluşturma