Package com.linecorp.armeria.server.thrift

Class THttpService

java.lang.Object
com.linecorp.armeria.common.util.AbstractUnwrappable<com.linecorp.armeria.server.Service<T_I,​T_O>>
com.linecorp.armeria.server.DecoratingService<com.linecorp.armeria.common.RpcRequest,​com.linecorp.armeria.common.RpcResponse,​com.linecorp.armeria.common.HttpRequest,​com.linecorp.armeria.common.HttpResponse>
com.linecorp.armeria.server.thrift.THttpService
All Implemented Interfaces:
com.linecorp.armeria.common.util.Unwrappable, com.linecorp.armeria.server.HttpService, com.linecorp.armeria.server.Service<com.linecorp.armeria.common.HttpRequest,​com.linecorp.armeria.common.HttpResponse>
public final class THttpService
extends com.linecorp.armeria.server.DecoratingService<com.linecorp.armeria.common.RpcRequest,​com.linecorp.armeria.common.RpcResponse,​com.linecorp.armeria.common.HttpRequest,​com.linecorp.armeria.common.HttpResponse>
implements com.linecorp.armeria.server.HttpService
An HttpService that handles a Thrift call.
See Also:
ThriftProtocolFactories

  • Method Summary

    Modifier and Type Method Description
    static THttpServiceBuilder builder()
    Creates a new instance of THttpServiceBuilder which can build an instance of THttpService fluently.
    com.linecorp.armeria.common.SerializationFormat defaultSerializationFormat()
    Returns the default SerializationFormat of this service.
    Map<String,​ThriftServiceEntry> entries()
    Returns the information about the Thrift services being served.
    static Function<? super com.linecorp.armeria.server.RpcService,​THttpService> newDecorator()
    Creates a new decorator that supports all thrift protocols and defaults to TBinary protocol when the client doesn't specify one.
    static Function<? super com.linecorp.armeria.server.RpcService,​THttpService> newDecorator​(com.linecorp.armeria.common.SerializationFormat defaultSerializationFormat)
    Creates a new decorator that supports all thrift protocols and defaults to the specified defaultSerializationFormat when the client doesn't specify one.
    static Function<? super com.linecorp.armeria.server.RpcService,​THttpService> newDecorator​(com.linecorp.armeria.common.SerializationFormat defaultSerializationFormat, com.linecorp.armeria.common.SerializationFormat... otherSupportedSerializationFormats)
    Creates a new decorator that supports only the formats specified and defaults to the specified defaultSerializationFormat when the client doesn't specify one.
    static Function<? super com.linecorp.armeria.server.RpcService,​THttpService> newDecorator​(com.linecorp.armeria.common.SerializationFormat defaultSerializationFormat, Iterable<com.linecorp.armeria.common.SerializationFormat> otherSupportedSerializationFormats)
    Creates a new decorator that supports the protocols specified in otherSupportedSerializationFormats and defaults to the specified defaultSerializationFormat when the client doesn't specify one.
    static THttpService of​(Object implementation)
    Creates a new THttpService with the specified service implementation, supporting all thrift protocols and defaulting to TBinary protocol when the client doesn't specify one.
    static THttpService of​(Object implementation, com.linecorp.armeria.common.SerializationFormat defaultSerializationFormat)
    Creates a new THttpService with the specified service implementation, supporting all thrift protocols and defaulting to the specified defaultSerializationFormat when the client doesn't specify one.
    static THttpService ofFormats​(Object implementation, com.linecorp.armeria.common.SerializationFormat defaultSerializationFormat, com.linecorp.armeria.common.SerializationFormat... otherSupportedSerializationFormats)
    Creates a new THttpService with the specified service implementation, supporting only the formats specified and defaulting to the specified defaultSerializationFormat when the client doesn't specify one.
    static THttpService ofFormats​(Object implementation, com.linecorp.armeria.common.SerializationFormat defaultSerializationFormat, Iterable<com.linecorp.armeria.common.SerializationFormat> otherSupportedSerializationFormats)
    Creates a new THttpService with the specified service implementation, supporting the protocols specified in otherSupportedSerializationFormats and defaulting to the specified defaultSerializationFormat when the client doesn't specify one.
    com.linecorp.armeria.common.HttpResponse serve​(com.linecorp.armeria.server.ServiceRequestContext ctx, com.linecorp.armeria.common.HttpRequest req)  
    Set<com.linecorp.armeria.common.SerializationFormat> supportedSerializationFormats()
    Returns the SerializationFormats supported by this service.

    Methods inherited from class com.linecorp.armeria.server.DecoratingService

    serviceAdded, shouldCachePath

    Methods inherited from class com.linecorp.armeria.common.util.AbstractUnwrappable

    as, toString, unwrap

    Methods inherited from class java.lang.Object

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

    Methods inherited from interface com.linecorp.armeria.server.HttpService

    decorate, decorate

    Methods inherited from interface com.linecorp.armeria.server.Service

    as, serviceAdded, shouldCachePath, unwrap

  • Method Details

    • builder

      public static THttpServiceBuilder builder()
      Creates a new instance of THttpServiceBuilder which can build an instance of THttpService fluently.

      The default SerializationFormat ThriftSerializationFormats.BINARY will be used when client does not specify one in the request, but also supports ThriftSerializationFormats.values().

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

    • of

      public static THttpService of​(Object implementation)
      Creates a new THttpService with the specified service implementation, supporting all thrift protocols and defaulting to TBinary protocol when the client doesn't specify one.

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

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

    • of

      public static THttpService of​(Object implementation, com.linecorp.armeria.common.SerializationFormat defaultSerializationFormat)
      Creates a new THttpService with the specified service implementation, supporting all thrift protocols and defaulting to the specified defaultSerializationFormat when the client doesn't specify one.

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

      Parameters:
      implementation - an implementation of *.Iface or *.AsyncIface service interface generated by the Apache Thrift compiler
      defaultSerializationFormat - the default serialization format to use when not specified by the client

    • ofFormats

      public static THttpService ofFormats​(Object implementation, com.linecorp.armeria.common.SerializationFormat defaultSerializationFormat, com.linecorp.armeria.common.SerializationFormat... otherSupportedSerializationFormats)
      Creates a new THttpService with the specified service implementation, supporting only the formats specified and defaulting to the specified defaultSerializationFormat when the client doesn't specify one.

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

      Parameters:
      implementation - an implementation of *.Iface or *.AsyncIface service interface generated by the Apache Thrift compiler
      defaultSerializationFormat - the default serialization format to use when not specified by the client
      otherSupportedSerializationFormats - other serialization formats that should be supported by this service in addition to the default

    • ofFormats

      public static THttpService ofFormats​(Object implementation, com.linecorp.armeria.common.SerializationFormat defaultSerializationFormat, Iterable<com.linecorp.armeria.common.SerializationFormat> otherSupportedSerializationFormats)
      Creates a new THttpService with the specified service implementation, supporting the protocols specified in otherSupportedSerializationFormats and defaulting to the specified defaultSerializationFormat when the client doesn't specify one.

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

      Parameters:
      implementation - an implementation of *.Iface or *.AsyncIface service interface generated by the Apache Thrift compiler
      defaultSerializationFormat - the default serialization format to use when not specified by the client
      otherSupportedSerializationFormats - other serialization formats that should be supported by this service in addition to the default

    • newDecorator

      public static Function<? super com.linecorp.armeria.server.RpcService,​THttpService> newDecorator()
      Creates a new decorator that supports all thrift protocols and defaults to TBinary protocol when the client doesn't specify one.

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

    • newDecorator

      public static Function<? super com.linecorp.armeria.server.RpcService,​THttpService> newDecorator​(com.linecorp.armeria.common.SerializationFormat defaultSerializationFormat)
      Creates a new decorator that supports all thrift protocols and defaults to the specified defaultSerializationFormat when the client doesn't specify one. 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().
      Parameters:
      defaultSerializationFormat - the default serialization format to use when not specified by the client

    • newDecorator

      public static Function<? super com.linecorp.armeria.server.RpcService,​THttpService> newDecorator​(com.linecorp.armeria.common.SerializationFormat defaultSerializationFormat, com.linecorp.armeria.common.SerializationFormat... otherSupportedSerializationFormats)
      Creates a new decorator that supports only the formats specified and defaults to the specified defaultSerializationFormat when the client doesn't specify one. 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().
      Parameters:
      defaultSerializationFormat - the default serialization format to use when not specified by the client
      otherSupportedSerializationFormats - other serialization formats that should be supported by this service in addition to the default

    • newDecorator

      public static Function<? super com.linecorp.armeria.server.RpcService,​THttpService> newDecorator​(com.linecorp.armeria.common.SerializationFormat defaultSerializationFormat, Iterable<com.linecorp.armeria.common.SerializationFormat> otherSupportedSerializationFormats)
      Creates a new decorator that supports the protocols specified in otherSupportedSerializationFormats and defaults to the specified defaultSerializationFormat when the client doesn't specify one. 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().
      Parameters:
      defaultSerializationFormat - the default serialization format to use when not specified by the client
      otherSupportedSerializationFormats - other serialization formats that should be supported by this service in addition to the default

    • entries

      public Map<String,​ThriftServiceEntry> entries()
      Returns the information about the Thrift services being served.
      Returns:
      a Map whose key is a service name, which could be an empty string if this service is not multiplexed

    • supportedSerializationFormats

      public Set<com.linecorp.armeria.common.SerializationFormat> supportedSerializationFormats()
      Returns the SerializationFormats supported by this service.

    • defaultSerializationFormat

      public com.linecorp.armeria.common.SerializationFormat defaultSerializationFormat()
      Returns the default SerializationFormat of this service.

    • serve

      public com.linecorp.armeria.common.HttpResponse serve​(com.linecorp.armeria.server.ServiceRequestContext ctx, com.linecorp.armeria.common.HttpRequest req) throws Exception
      Specified by:
      serve in interface com.linecorp.armeria.server.HttpService
      Specified by:
      serve in interface com.linecorp.armeria.server.Service<com.linecorp.armeria.common.HttpRequest,​com.linecorp.armeria.common.HttpResponse>
      Throws:
      Exception