Package com.linecorp.armeria.client.grpc

Class GrpcClientOptions

java.lang.Object

com.linecorp.armeria.client.grpc.GrpcClientOptions

public final class GrpcClientOptions
extends Object

ClientOptions to control gRPC-specific behavior.

Field Summary

Fields

Modifier and Type	Field	Description
static ClientOption<GrpcClientStubFactory>	GRPC_CLIENT_STUB_FACTORY	Sets the GrpcClientStubFactory that creates a gRPC client stub.
static ClientOption<Function<? super ServiceDescriptor,? extends GrpcJsonMarshaller>>	GRPC_JSON_MARSHALLER_FACTORY	Sets the factory that creates a GrpcJsonMarshaller that serializes and deserializes request or response messages to and from JSON depending on the SerializationFormat.
static ClientOption<Integer>	MAX_INBOUND_MESSAGE_SIZE_BYTES	The maximum size, in bytes, of messages coming in a response.
static ClientOption<Integer>	MAX_OUTBOUND_MESSAGE_SIZE_BYTES	The maximum size, in bytes, of messages sent in a request.
static ClientOption<Boolean>	UNSAFE_WRAP_RESPONSE_BUFFERS	Enables unsafe retention of response buffers.

Method Summary

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

MAX_INBOUND_MESSAGE_SIZE_BYTES

public static final ClientOption<Integer> MAX_INBOUND_MESSAGE_SIZE_BYTES

The maximum size, in bytes, of messages coming in a response. The default value is -1, which means 'use ClientOptions.MAX_RESPONSE_LENGTH'.

MAX_OUTBOUND_MESSAGE_SIZE_BYTES

public static final ClientOption<Integer> MAX_OUTBOUND_MESSAGE_SIZE_BYTES

The maximum size, in bytes, of messages sent in a request. The default value is -1, which means unlimited.

UNSAFE_WRAP_RESPONSE_BUFFERS

public static final ClientOption<Boolean> UNSAFE_WRAP_RESPONSE_BUFFERS

Enables unsafe retention of response buffers. Can improve performance when working with very large (i.e., several megabytes) payloads.

DISCLAIMER: Do not use this if you don't know what you are doing. It is very easy to introduce memory leaks when using this method. You will probably spend much time debugging memory leaks during development if this is enabled. You will probably spend much time debugging memory leaks in production if this is enabled. You probably don't want to do this and should turn back now.

When enabled, the reference-counted buffer received from the server will be stored into RequestContext instead of being released. All ByteString in a protobuf message will reference sections of this buffer instead of having their own copies. When done with a response message, call GrpcUnsafeBufferUtil.releaseBuffer(Object, RequestContext) with the message and the request's context to release the buffer. The message must be the same reference as what was passed to the client stub - a message with the same contents will not work. If GrpcUnsafeBufferUtil.releaseBuffer(Object, RequestContext) is not called, the memory will be leaked.

Note that this has no effect if the payloads are compressed or the SerializationFormat is GrpcSerializationFormats.PROTO_WEB_TEXT.

GRPC_JSON_MARSHALLER_FACTORY

public static final ClientOption<Function<? super ServiceDescriptor,? extends GrpcJsonMarshaller>> GRPC_JSON_MARSHALLER_FACTORY

Sets the factory that creates a GrpcJsonMarshaller that serializes and deserializes request or response messages to and from JSON depending on the SerializationFormat. The returned GrpcJsonMarshaller from the factory replaces the built-in GrpcJsonMarshaller.

This is commonly used to:

• Switch from the default of using lowerCamelCase for field names to using the field name from the proto definition, by setting MessageMarshaller.Builder.preservingProtoFieldNames(boolean) via GrpcJsonMarshallerBuilder.jsonMarshallerCustomizer(Consumer).

  
          Clients.builder(grpcServerUri)
                 .option(GrpcClientOptions.GRPC_JSON_MARSHALLER_FACTORY.newValue(serviceDescriptor -> {
                     return GrpcJsonMarshaller.builder()
                                              .jsonMarshallerCustomizer(builder -> {
                                                  builder.preservingProtoFieldNames(true);
                                              })
                                              .build(serviceDescriptor);
                 }))
                 .build();
         

• Set a customer marshaller for non-Message types such as scalapb.GeneratedMessage for Scala and pbandk.Message for Kotlin.

GRPC_CLIENT_STUB_FACTORY

public static final ClientOption<GrpcClientStubFactory> GRPC_CLIENT_STUB_FACTORY

Sets the GrpcClientStubFactory that creates a gRPC client stub. If not specified, Armeria provides built-in factories for the following gRPC client stubs:

• gRPC-Java
• Reactive-gRPC
• gRPC-Kotlin
• ScalaPB