Package com.linecorp.armeria.server.thrift

Class THttpServiceBuilder

java.lang.Object

com.linecorp.armeria.server.thrift.THttpServiceBuilder

public final class THttpServiceBuilder
extends Object

A fluent builder to build an instance of THttpService. This builder allows to bind multiple thrift service implementations along with mixing TMultiplexed protocol to a route.

Example

 Server server =
     Server.builder()
           .http(8080)
           .service("/", THttpService.builder()
                                     .addService(new FooService())              // foo() method
                                     .addService(new BarService())              // bar() method
                                     .addService("foobar", new FooBarService()) // TMultiplexed service
                                     .build())
           .build();
 

When the thrift request has a method foo() then FooService.foo() handles the request and similarly when thrift request has a method bar() then BarService.bar() handles the request. And when the service name is "foobar" then FooBarService

See Also:

• THttpService
• ThriftCallService

Method Summary

Modifier and Type	Method	Description
THttpServiceBuilder	addService(Object implementation)	Adds a new service implementation to the builder.
THttpServiceBuilder	addService(String name, Object implementation)	Adds a new TMultiplexed service to the builder.
THttpService	build()	Builds a new instance of THttpService.
THttpServiceBuilder	decorate(Function<? super RpcService,? extends RpcService> decoratorFunction)	A Function<? super RpcService, ? extends RpcService> to decorate the RpcService.
THttpServiceBuilder	defaultSerializationFormat(SerializationFormat defaultSerializationFormat)	Adds the default serialization format which will be used when the client does not specify one in request.
THttpServiceBuilder	exceptionHandler(BiFunction<? super ServiceRequestContext,? super Throwable,? extends RpcResponse> exceptionHandler)	Sets the BiFunction that returns an RpcResponse using the given Throwable and ServiceRequestContext.
Function<? super RpcService,THttpService>	newDecorator()	Returns a newly-created THttpService decorator with the properties of this builder.
THttpServiceBuilder	otherSerializationFormats(SerializationFormat otherSerializationFormat)	Adds other SerializationFormat to the builder.
THttpServiceBuilder	otherSerializationFormats(Iterable<SerializationFormat> otherSerializationFormats)	Adds other SerializationFormats to the builder.

Methods inherited from class java.lang.Object

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

Method Details

addService

public THttpServiceBuilder addService(String name,
 Object implementation)

Adds a new TMultiplexed service to the builder.

Parameters:

name - name of the service.

implementation - an implementation of *.Iface or *.AsyncIface service interface generated by the Apache Thrift compiler.

addService

public THttpServiceBuilder addService(Object implementation)

Adds a new service implementation to the builder.

Parameters:

implementation - an implementation of *.Iface or *.AsyncIface service interface generated by the Apache Thrift compiler

otherSerializationFormats

public THttpServiceBuilder otherSerializationFormats(SerializationFormat otherSerializationFormat)

Adds other SerializationFormat to the builder. By default, all SerializationFormats in ThriftSerializationFormats are supported. If nothing is specified then they are added. To add a new custom Thrift serialization format, define a new SPI ThriftProtocolFactoryProvider.

Currently, the only way to specify a serialization format at request time is by using the HTTP session protocol and setting the "Content-Type" header to the appropriate SerializationFormat.mediaType().

otherSerializationFormats

public THttpServiceBuilder otherSerializationFormats(Iterable<SerializationFormat> otherSerializationFormats)

Adds other SerializationFormats to the builder. If nothing is specified then all SerializationFormats returned by ThriftSerializationFormats.values() are added.

Currently, the only way to specify a serialization format at request time is by using the HTTP session protocol and setting the "Content-Type" header to the appropriate SerializationFormat.mediaType().

defaultSerializationFormat

public THttpServiceBuilder defaultSerializationFormat(SerializationFormat defaultSerializationFormat)

Adds the default serialization format which will be used when the client does not specify one in request.

Currently, the only way to specify a serialization format is by using the HTTP session protocol and setting the "Content-Type" header to the appropriate SerializationFormat.mediaType().

exceptionHandler

public THttpServiceBuilder exceptionHandler(BiFunction<? super ServiceRequestContext,? super Throwable,? extends RpcResponse> exceptionHandler)

Sets the BiFunction that returns an RpcResponse using the given Throwable and ServiceRequestContext.

decorate

public THttpServiceBuilder decorate(Function<? super RpcService,? extends RpcService> decoratorFunction)

A Function<? super RpcService, ? extends RpcService> to decorate the RpcService.

build

public THttpService build()

Builds a new instance of THttpService.

newDecorator

public Function<? super RpcService,THttpService> newDecorator()

Returns a newly-created THttpService decorator with the properties of this builder.