Package com.linecorp.armeria.server.grpc

Class GrpcServiceBuilder

java.lang.Object

com.linecorp.armeria.server.grpc.GrpcServiceBuilder

public final class GrpcServiceBuilder
extends Object

Constructs a GrpcService to serve gRPC services from within Armeria.

Method Summary

Modifier and Type	Method	Description
GrpcServiceBuilder	addExceptionMapping(Class<? extends Throwable> exceptionType, GrpcStatusFunction statusFunction)	Adds the specified exception mapping that maps a Throwable to a gRPC Status.
GrpcServiceBuilder	addExceptionMapping(Class<? extends Throwable> exceptionType, Status status)	Adds the specified exception mapping that maps a Throwable to a gRPC Status.
<T extends Throwable> GrpcServiceBuilder	addExceptionMapping(Class<T> exceptionType, BiFunction<T,Metadata,Status> statusFunction)	Deprecated. Use addExceptionMapping(Class, GrpcStatusFunction) instead.
GrpcServiceBuilder	addService(BindableService bindableService)	Adds a gRPC BindableService to this GrpcServiceBuilder.
GrpcServiceBuilder	addService(BindableService bindableService, Iterable<? extends Function<? super HttpService,? extends HttpService>> decorators)	Decorates a gRPC BindableService with the given decorators, in the order of iteration.
GrpcServiceBuilder	addService(ServerServiceDefinition service)	Adds a gRPC ServerServiceDefinition to this GrpcServiceBuilder, such as what's returned by BindableService.bindService().
GrpcServiceBuilder	addService(String path, BindableService bindableService)	Adds a gRPC BindableService to this GrpcServiceBuilder.
GrpcServiceBuilder	addService(String path, BindableService bindableService, MethodDescriptor<?,?> methodDescriptor)	Adds a method of gRPC BindableService to this GrpcServiceBuilder.
GrpcServiceBuilder	addService(String path, BindableService bindableService, MethodDescriptor<?,?> methodDescriptor, Iterable<? extends Function<? super HttpService,? extends HttpService>> decorators)	Decorates a method of gRPC BindableService with the given decorators, in the order of iteration.
GrpcServiceBuilder	addService(String path, BindableService bindableService, Iterable<? extends Function<? super HttpService,? extends HttpService>> decorators)	Decorates a gRPC BindableService with the given decorators, in the order of iteration.
GrpcServiceBuilder	addService(String path, ServerServiceDefinition service)	Adds a gRPC ServerServiceDefinition to this GrpcServiceBuilder, such as what's returned by BindableService.bindService().
GrpcServiceBuilder	addService(String path, ServerServiceDefinition service, MethodDescriptor<?,?> methodDescriptor)	Adds a method of gRPC ServerServiceDefinition to this GrpcServiceBuilder.
<T> GrpcServiceBuilder	addService(T implementation, Function<? super T,ServerServiceDefinition> serviceDefinitionFactory)	Adds an implementation of gRPC service to this GrpcServiceBuilder.
<T> GrpcServiceBuilder	addService(T implementation, Function<? super T,ServerServiceDefinition> serviceDefinitionFactory, Iterable<? extends Function<? super HttpService,? extends HttpService>> decorators)	Decorates an implementation of gRPC service with the given decorators, in the order of iteration.
GrpcServiceBuilder	addServiceDefinitions(ServerServiceDefinition... services)	Adds gRPC ServerServiceDefinitions to this GrpcServiceBuilder.
GrpcServiceBuilder	addServiceDefinitions(Iterable<ServerServiceDefinition> services)	Adds gRPC ServerServiceDefinitions to this GrpcServiceBuilder.
GrpcServiceBuilder	addServices(BindableService... bindableServices)	Adds gRPC BindableServices to this GrpcServiceBuilder.
GrpcServiceBuilder	addServices(Iterable<BindableService> bindableServices)	Adds gRPC BindableServices to this GrpcServiceBuilder.
GrpcServiceBuilder	autoCompression(boolean autoCompression)	Sets whether the gRPC response is compressed automatically when a client sends the grpc-accept-encoding header with the encoding registered in the CompressorRegistry.
GrpcService	build()	Constructs a new GrpcService that can be bound to ServerBuilder.
GrpcServiceBuilder	compressorRegistry(CompressorRegistry registry)	Sets the CompressorRegistry to use when compressing messages.
GrpcServiceBuilder	decompressorRegistry(DecompressorRegistry registry)	Sets the DecompressorRegistry to use when decompressing messages.
GrpcServiceBuilder	enableHealthCheckService(boolean enableHealthCheckService)	Sets the default GrpcHealthCheckService to this GrpcServiceBuilder.
GrpcServiceBuilder	enableHttpJsonTranscoding(boolean enableHttpJsonTranscoding)	Sets whether the service handles HTTP/JSON requests using the gRPC wire protocol.
GrpcServiceBuilder	enableHttpJsonTranscoding(HttpJsonTranscodingOptions httpJsonTranscodingOptions)	Enables HTTP/JSON transcoding using the gRPC wire protocol.
GrpcServiceBuilder	enableUnframedRequests(boolean enableUnframedRequests)	Sets whether the service handles requests not framed using the gRPC wire protocol.
GrpcServiceBuilder	exceptionMapping(GrpcStatusFunction statusFunction)	Sets the specified GrpcStatusFunction that maps a Throwable to a gRPC Status.
GrpcServiceBuilder	httpJsonTranscodingErrorHandler(UnframedGrpcErrorHandler httpJsonTranscodingErrorHandler)	Deprecated. Use HttpJsonTranscodingOptionsBuilder.errorHandler(UnframedGrpcErrorHandler) instead.
GrpcServiceBuilder	intercept(ServerInterceptor... interceptors)	Adds server interceptors into the gRPC service.
GrpcServiceBuilder	intercept(Iterable<? extends ServerInterceptor> interceptors)	Adds server interceptors into the gRPC service.
GrpcServiceBuilder	jsonMarshallerFactory(Function<? super ServiceDescriptor,? extends GrpcJsonMarshaller> jsonMarshallerFactory)	Sets the factory that creates a GrpcJsonMarshaller that serializes and deserializes request or response messages to and from JSON depending on the SerializationFormat.
GrpcServiceBuilder	maxRequestMessageLength(int maxRequestMessageLength)	Sets the maximum size in bytes of an individual request message.
GrpcServiceBuilder	maxResponseMessageLength(int maxResponseMessageLength)	Sets the maximum size in bytes of an individual response message.
GrpcServiceBuilder	setMaxInboundMessageSizeBytes(int maxInboundMessageSizeBytes)	Deprecated. Use maxRequestMessageLength(int) instead.
GrpcServiceBuilder	setMaxOutboundMessageSizeBytes(int maxOutboundMessageSizeBytes)	Deprecated. Use maxResponseMessageLength(int) instead.
GrpcServiceBuilder	supportedSerializationFormats(SerializationFormat... formats)	Sets the SerializationFormats supported by this server.
GrpcServiceBuilder	supportedSerializationFormats(Iterable<SerializationFormat> formats)	Sets the SerializationFormats supported by this server.
GrpcServiceBuilder	unframedGrpcErrorHandler(UnframedGrpcErrorHandler unframedGrpcErrorHandler)	Set a custom error response mapper.
GrpcServiceBuilder	unsafeWrapRequestBuffers(boolean unsafeWrapRequestBuffers)	Enables unsafe retention of request buffers.
GrpcServiceBuilder	useBlockingTaskExecutor(boolean useBlockingTaskExecutor)	Sets whether the service executes service methods using the blocking executor.
GrpcServiceBuilder	useClientTimeoutHeader(boolean useClientTimeoutHeader)	Sets whether to use a grpc-timeout header sent by the client to control the timeout for request processing.

Methods inherited from class java.lang.Object

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

Method Details

addService

public GrpcServiceBuilder addService(ServerServiceDefinition service)

Adds a gRPC ServerServiceDefinition to this GrpcServiceBuilder, such as what's returned by BindableService.bindService().

addService

public GrpcServiceBuilder addService(String path,
 ServerServiceDefinition service)

Adds a gRPC ServerServiceDefinition to this GrpcServiceBuilder, such as what's returned by BindableService.bindService().

Note that the specified path replaces the normal gRPC service path. Let's say you have the following gRPC service definition.

 package example.grpc.hello;

 service HelloService {
   rpc Hello (HelloRequest) returns (HelloReply) {}
 }

The normal gRPC service path for the Hello method is "/example.grpc.hello.HelloService/Hello". However, if you set "/foo" to path, the Hello method will be served at "/foo/Hello". This is useful for supporting unframed gRPC with HTTP idiomatic path.

addService

public GrpcServiceBuilder addService(String path,
 ServerServiceDefinition service,
 MethodDescriptor<?,?> methodDescriptor)

Adds a method of gRPC ServerServiceDefinition to this GrpcServiceBuilder. You can get MethodDescriptors from the enclosing class of your generated stub.

Note that the specified path replaces the normal gRPC service path. Let's say you have the following gRPC service definition.

 package example.grpc.hello;

 service HelloService {
   rpc Hello (HelloRequest) returns (HelloReply) {}
 }

The normal gRPC service path for the Hello method is "/example.grpc.hello.HelloService/Hello". However, if you set "/fooHello" to path, the Hello method will be served at "/fooHello". This is useful for supporting unframed gRPC with HTTP idiomatic path.

addService

public GrpcServiceBuilder addService(BindableService bindableService)

Adds a gRPC BindableService to this GrpcServiceBuilder. Most gRPC service implementations are BindableServices.

addService

@UnstableApi
public GrpcServiceBuilder addService(BindableService bindableService,
 Iterable<? extends Function<? super HttpService,? extends HttpService>> decorators)

Decorates a gRPC BindableService with the given decorators, in the order of iteration. For more details on decorator behavior, please refer to the following document.

See Also:

• Decorating a GrpcService

addService

public GrpcServiceBuilder addService(String path,
 BindableService bindableService)

Adds a gRPC BindableService to this GrpcServiceBuilder. Most gRPC service implementations are BindableServices.

Note that the specified path replaces the normal gRPC service path. Let's say you have the following gRPC service definition.

 package example.grpc.hello;

 service HelloService {
   rpc Hello (HelloRequest) returns (HelloReply) {}
 }

The normal gRPC service path for the Hello method is "/example.grpc.hello.HelloService/Hello". However, if you set "/foo" to path, the Hello method will be served at "/foo/Hello". This is useful for supporting unframed gRPC with HTTP idiomatic path.

addService

@UnstableApi
public GrpcServiceBuilder addService(String path,
 BindableService bindableService,
 Iterable<? extends Function<? super HttpService,? extends HttpService>> decorators)

Decorates a gRPC BindableService with the given decorators, in the order of iteration. For more details on decorator behavior, please refer to the following document.

See Also:

• Decorating a GrpcService

addService

public <T> GrpcServiceBuilder addService(T implementation,
 Function<? super T,ServerServiceDefinition> serviceDefinitionFactory)

Adds an implementation of gRPC service to this GrpcServiceBuilder. Most gRPC service implementations are BindableServices. This method is useful in cases like the followings.

Used for ScalaPB gRPC stubs

 GrpcService.builder()
            .addService(new HelloServiceImpl,
                        HelloServiceGrpc.bindService(_,
                                                     ExecutionContext.global))
 

Used for intercepted gRPC-Java stubs

 GrpcService.builder()
            .addService(new TestServiceImpl,
                        impl -> ServerInterceptors.intercept(impl, interceptors));
 

addService

@UnstableApi
public <T> GrpcServiceBuilder addService(T implementation,
 Function<? super T,ServerServiceDefinition> serviceDefinitionFactory,
 Iterable<? extends Function<? super HttpService,? extends HttpService>> decorators)

Decorates an implementation of gRPC service with the given decorators, in the order of iteration.

Most gRPC service implementations are BindableServices. This method is useful in cases like the followings.

Used for ScalaPB gRPC stubs

 GrpcService.builder()
            .addService(new HelloServiceImpl,
                        HelloServiceGrpc.bindService(_,
                                                     ExecutionContext.global))
 

Used for intercepted gRPC-Java stubs

 GrpcService.builder()
            .addService(new TestServiceImpl,
                        impl -> ServerInterceptors.intercept(impl, interceptors));
 

For more details on decorator behavior, please refer to the following document.

See Also:

• Decorating a GrpcService

addService

public GrpcServiceBuilder addService(String path,
 BindableService bindableService,
 MethodDescriptor<?,?> methodDescriptor)

Adds a method of gRPC BindableService to this GrpcServiceBuilder. You can get MethodDescriptors from the enclosing class of your generated stub.

Note that the specified path replaces the normal gRPC service path. Let's say you have the following gRPC service definition.

 package example.grpc.hello;

 service HelloService {
   rpc Hello (HelloRequest) returns (HelloReply) {}
 }

The normal gRPC service path for the Hello method is "/example.grpc.hello.HelloService/Hello". However, if you set "/fooHello" to path, the Hello method will be served at "/fooHello". This is useful for supporting unframed gRPC with HTTP idiomatic path.

addService

@UnstableApi
public GrpcServiceBuilder addService(String path,
 BindableService bindableService,
 MethodDescriptor<?,?> methodDescriptor,
 Iterable<? extends Function<? super HttpService,? extends HttpService>> decorators)

Decorates a method of gRPC BindableService with the given decorators, in the order of iteration. For more details on decorator behavior, please refer to the following document.

See Also:

• Decorating a GrpcService

intercept

public GrpcServiceBuilder intercept(ServerInterceptor... interceptors)

Adds server interceptors into the gRPC service. The last interceptor will have its ServerInterceptor.interceptCall(io.grpc.ServerCall<ReqT, RespT>, io.grpc.Metadata, io.grpc.ServerCallHandler<ReqT, RespT>) called first.

Parameters:

interceptors - array of interceptors to apply to the service.

intercept

public GrpcServiceBuilder intercept(Iterable<? extends ServerInterceptor> interceptors)

Adds server interceptors into the gRPC service. The last interceptor will have its ServerInterceptor.interceptCall(io.grpc.ServerCall<ReqT, RespT>, io.grpc.Metadata, io.grpc.ServerCallHandler<ReqT, RespT>) called first.

Parameters:

interceptors - list of interceptors to apply to the service.

addServices

public GrpcServiceBuilder addServices(BindableService... bindableServices)

Adds gRPC BindableServices to this GrpcServiceBuilder. Most gRPC service implementations are BindableServices.

addServices

public GrpcServiceBuilder addServices(Iterable<BindableService> bindableServices)

Adds gRPC BindableServices to this GrpcServiceBuilder. Most gRPC service implementations are BindableServices.

addServiceDefinitions

public GrpcServiceBuilder addServiceDefinitions(ServerServiceDefinition... services)

Adds gRPC ServerServiceDefinitions to this GrpcServiceBuilder.

addServiceDefinitions

public GrpcServiceBuilder addServiceDefinitions(Iterable<ServerServiceDefinition> services)

Adds gRPC ServerServiceDefinitions to this GrpcServiceBuilder.

decompressorRegistry

public GrpcServiceBuilder decompressorRegistry(DecompressorRegistry registry)

Sets the DecompressorRegistry to use when decompressing messages. If not set, will use the default, which supports gzip only.

compressorRegistry

public GrpcServiceBuilder compressorRegistry(CompressorRegistry registry)

Sets the CompressorRegistry to use when compressing messages. If not set, will use the default, which supports gzip only.

supportedSerializationFormats

public GrpcServiceBuilder supportedSerializationFormats(SerializationFormat... formats)

Sets the SerializationFormats supported by this server. If not set, defaults to support all GrpcSerializationFormats.values().

supportedSerializationFormats

public GrpcServiceBuilder supportedSerializationFormats(Iterable<SerializationFormat> formats)

Sets the SerializationFormats supported by this server. If not set, defaults to support all GrpcSerializationFormats.values().

setMaxInboundMessageSizeBytes

@Deprecated
public GrpcServiceBuilder setMaxInboundMessageSizeBytes(int maxInboundMessageSizeBytes)

Deprecated.

Use maxRequestMessageLength(int) instead.

Sets the maximum size in bytes of an individual incoming message. If not set, will use VirtualHost.maxRequestLength(). To support long-running RPC streams, it is recommended to set ServerBuilder.maxRequestLength(long) (or VirtualHostBuilder.maxRequestLength(long)) and ServerBuilder.requestTimeoutMillis(long) (or VirtualHostBuilder.requestTimeoutMillis(long)) to very high values and set this to the expected limit of individual messages in the stream.

setMaxOutboundMessageSizeBytes

@Deprecated
public GrpcServiceBuilder setMaxOutboundMessageSizeBytes(int maxOutboundMessageSizeBytes)

Deprecated.

Use maxResponseMessageLength(int) instead.

Sets the maximum size in bytes of an individual outgoing message. If not set, all messages will be sent. This can be a safety valve to prevent overflowing network connections with large messages due to business logic bugs.

maxRequestMessageLength

public GrpcServiceBuilder maxRequestMessageLength(int maxRequestMessageLength)

Sets the maximum size in bytes of an individual request message. If not set, will use VirtualHost.maxRequestLength(). To support long-running RPC streams, it is recommended to set ServerBuilder.maxRequestLength(long) (or VirtualHostBuilder.maxRequestLength(long)) and ServerBuilder.requestTimeoutMillis(long) (or VirtualHostBuilder.requestTimeoutMillis(long)) to very high values and set this to the expected limit of individual messages in the stream.

maxResponseMessageLength

public GrpcServiceBuilder maxResponseMessageLength(int maxResponseMessageLength)

Sets the maximum size in bytes of an individual response message. If not set, all messages will be sent. This can be a safety valve to prevent overflowing network connections with large messages due to business logic bugs.

enableUnframedRequests

public GrpcServiceBuilder enableUnframedRequests(boolean enableUnframedRequests)

Sets whether the service handles requests not framed using the gRPC wire protocol. Such requests should only have the serialized message as the request content, and the response content will only have the serialized response message. Supporting unframed requests can be useful, for example, when migrating an existing service to gRPC.

Limitations:

• Only unary methods (single request, single response) are supported.
• Message compression is not supported. EncodingService should be used instead for transport level encoding.

unframedGrpcErrorHandler

@UnstableApi
public GrpcServiceBuilder unframedGrpcErrorHandler(UnframedGrpcErrorHandler unframedGrpcErrorHandler)

Set a custom error response mapper. This is useful to serve custom response when using unframed gRPC service.

Parameters:

unframedGrpcErrorHandler - The function which maps the error response to an HttpResponse.

enableHttpJsonTranscoding

@UnstableApi
public GrpcServiceBuilder enableHttpJsonTranscoding(boolean enableHttpJsonTranscoding)

Sets whether the service handles HTTP/JSON requests using the gRPC wire protocol.

Limitations:

• Only unary methods (single request, single response) are supported.
• Message compression is not supported. EncodingService should be used instead for transport level encoding.
• Transcoding will not work if the GrpcService is configured with ServerBuilder.serviceUnder(String, HttpService).

See Also:

• Transcoding HTTP/JSON to gRPC

enableHttpJsonTranscoding

@UnstableApi
public GrpcServiceBuilder enableHttpJsonTranscoding(HttpJsonTranscodingOptions httpJsonTranscodingOptions)

Enables HTTP/JSON transcoding using the gRPC wire protocol. Provide HttpJsonTranscodingOptions to customize HttpJsonTranscoding.

Example:

 HttpJsonTranscodingOptions options =
   HttpJsonTranscodingOptions.builder()
                             .queryParamMatchRules(ORIGINAL_FIELD)
                             ...
                             .build();

 GrpcService.builder()
            // Enable HttpJsonTranscoding and use the specified HttpJsonTranscodingOption
            .enableHttpJsonTranscoding(options)
            .build();
 

Limitations:

• Only unary methods (single request, single response) are supported.
• Message compression is not supported. EncodingService should be used instead for transport level encoding.
• Transcoding will not work if the GrpcService is configured with ServerBuilder.serviceUnder(String, HttpService).

See Also:

• Transcoding HTTP/JSON to gRPC

httpJsonTranscodingErrorHandler

@UnstableApi
@Deprecated
public GrpcServiceBuilder httpJsonTranscodingErrorHandler(UnframedGrpcErrorHandler httpJsonTranscodingErrorHandler)

Deprecated.

Use HttpJsonTranscodingOptionsBuilder.errorHandler(UnframedGrpcErrorHandler) instead.

Sets an error handler which handles an exception raised while serving a gRPC request transcoded from an HTTP/JSON request. By default, UnframedGrpcErrorHandler.ofJson() would be set.

useBlockingTaskExecutor

public GrpcServiceBuilder useBlockingTaskExecutor(boolean useBlockingTaskExecutor)

Sets whether the service executes service methods using the blocking executor. By default, service methods are executed directly on the event loop for implementing fully asynchronous services. If your service uses blocking logic, you should either execute such logic in a separate thread using something like Executors.newCachedThreadPool() or enable this setting.

unsafeWrapRequestBuffers

public GrpcServiceBuilder unsafeWrapRequestBuffers(boolean unsafeWrapRequestBuffers)

Enables unsafe retention of request 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 client 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 request 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 service 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 isn't working if the payloads are compressed or the SerializationFormat is GrpcSerializationFormats.PROTO_WEB_TEXT.

jsonMarshallerFactory

public GrpcServiceBuilder jsonMarshallerFactory(Function<? super ServiceDescriptor,? extends GrpcJsonMarshaller> jsonMarshallerFactory)

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).

  
         GrpcService.builder()
                    .jsonMarshallerFactory(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.

useClientTimeoutHeader

public GrpcServiceBuilder useClientTimeoutHeader(boolean useClientTimeoutHeader)

Sets whether to use a grpc-timeout header sent by the client to control the timeout for request processing. If disabled, the request timeout will be the one configured for the Armeria server, e.g., using ServerBuilder.requestTimeout(Duration).

It is recommended to disable this when clients are not trusted code, e.g., for gRPC-Web clients that can come from arbitrary browsers.

enableHealthCheckService

public GrpcServiceBuilder enableHealthCheckService(boolean enableHealthCheckService)

Sets the default GrpcHealthCheckService to this GrpcServiceBuilder. The gRPC health check service manages only the health checker that determines the healthiness of the Server.

See Also:

• GRPC Health Checking Protocol

exceptionMapping

public GrpcServiceBuilder exceptionMapping(GrpcStatusFunction statusFunction)

Sets the specified GrpcStatusFunction that maps a Throwable to a gRPC Status.

Note that this method and addExceptionMapping(Class, Status) are mutually exclusive.

autoCompression

@UnstableApi
public GrpcServiceBuilder autoCompression(boolean autoCompression)

Sets whether the gRPC response is compressed automatically when a client sends the grpc-accept-encoding header with the encoding registered in the CompressorRegistry.

addExceptionMapping

public GrpcServiceBuilder addExceptionMapping(Class<? extends Throwable> exceptionType,
 Status status)

Adds the specified exception mapping that maps a Throwable to a gRPC Status. The mapping is used to handle a Throwable when it is raised.

Note that this method and exceptionMapping(GrpcStatusFunction) are mutually exclusive.

addExceptionMapping

@Deprecated
public <T extends Throwable> GrpcServiceBuilder addExceptionMapping(Class<T> exceptionType,
 BiFunction<T,Metadata,Status> statusFunction)

Deprecated.

Use addExceptionMapping(Class, GrpcStatusFunction) instead.

Adds the specified exception mapping that maps a Throwable to a gRPC Status. The mapping is used to handle a Throwable when it is raised.

Note that this method and exceptionMapping(GrpcStatusFunction) are mutually exclusive.

addExceptionMapping

public GrpcServiceBuilder addExceptionMapping(Class<? extends Throwable> exceptionType,
 GrpcStatusFunction statusFunction)

Adds the specified exception mapping that maps a Throwable to a gRPC Status. The mapping is used to handle a Throwable when it is raised.

Note that this method and exceptionMapping(GrpcStatusFunction) are mutually exclusive.

build

public GrpcService build()

Constructs a new GrpcService that can be bound to ServerBuilder. It is recommended to bind the service to a server using ServerBuilder.service(HttpServiceWithRoutes) to mount all service paths without interfering with other services.