Interface THttpClient

All Superinterfaces:
com.linecorp.armeria.client.ClientBuilderParams, com.linecorp.armeria.common.util.Unwrappable

public interface THttpClient extends com.linecorp.armeria.common.util.Unwrappable, com.linecorp.armeria.client.ClientBuilderParams
A generic Thrift-over-HTTP client.

You will usually create a Thrift client object that implements a specific Thrift service interface (e.g. HelloService.AsyncIface):


 HelloService.AsyncIface client = Clients.newClient(
         "tbinary+http://127.0.0.1/hello", HelloService.AsyncIface.class);
 client.hello("John Doe", ...);
 
However, if you want a generic Thrift client that works with any Thrift services, this client may be useful:

 ThriftClient client = Clients.newClient("tbinary+http://127.0.0.1/", ThriftClient.class);
 client.execute("/hello", HelloService.Iface.class, "hello", "John Doe");
 client.execute("/foo", FooService.Iface.class, "foo", "arg1", "arg2", ...);
 
  • Method Summary

    Modifier and Type
    Method
    Description
    com.linecorp.armeria.common.RpcResponse
    execute(String path, Class<?> serviceType, String method, Object... args)
    Executes the specified Thrift call.
    com.linecorp.armeria.common.RpcResponse
    executeMultiplexed(String path, Class<?> serviceType, String serviceName, String method, Object... args)
    Executes the specified multiplexed Thrift call.
    com.linecorp.armeria.client.RpcClient
     

    Methods inherited from interface com.linecorp.armeria.client.ClientBuilderParams

    absolutePathRef, clientType, endpointGroup, options, scheme, uri

    Methods inherited from interface com.linecorp.armeria.common.util.Unwrappable

    as, equalsIgnoreWrapper, unwrapAll
  • Method Details

    • execute

      com.linecorp.armeria.common.RpcResponse execute(String path, Class<?> serviceType, String method, Object... args)
      Executes the specified Thrift call.
      Parameters:
      path - the path of the Thrift service
      serviceType - the Thrift service interface
      method - the method name
      args - the arguments of the call
    • executeMultiplexed

      com.linecorp.armeria.common.RpcResponse executeMultiplexed(String path, Class<?> serviceType, String serviceName, String method, Object... args)
      Executes the specified multiplexed Thrift call.
      Parameters:
      path - the path of the Thrift service
      serviceType - the Thrift service interface
      serviceName - the Thrift service name
      method - the method name
      args - the arguments of the call
    • unwrap

      com.linecorp.armeria.client.RpcClient unwrap()
      Specified by:
      unwrap in interface com.linecorp.armeria.common.util.Unwrappable