com.linkedin.r2.netty.client

Class HttpNettyClient

java.lang.Object

com.linkedin.r2.netty.client.HttpNettyClient

All Implemented Interfaces:

com.linkedin.r2.transport.common.bridge.client.TransportClient

public class HttpNettyClient
extends java.lang.Object
implements com.linkedin.r2.transport.common.bridge.client.TransportClient

Netty implementation of TransportClient

Constructor Summary

Constructors

Constructor and Description

HttpNettyClient(io.netty.channel.EventLoopGroup eventLoopGroup, java.util.concurrent.ScheduledExecutorService scheduler, java.util.concurrent.ExecutorService callbackExecutor, ChannelPoolManager channelPoolManager, ChannelPoolManager sslChannelPoolManager, com.linkedin.r2.transport.http.common.HttpProtocolVersion protocolVersion, com.linkedin.util.clock.Clock clock, long requestTimeout, long streamingTimeout, long shutdownTimeout) Creates a new instance of HttpNettyClient.

Method Summary

Modifier and Type	Method and Description
static java.net.SocketAddress	resolveAddress(com.linkedin.r2.message.Request request, com.linkedin.r2.message.RequestContext requestContext) Resolves the IP Address from the URI host
static long	resolveRequestTimeout(com.linkedin.r2.message.RequestContext context, long requestTimeout) Resolves the request timeout based on the client configured timeout, request timeout, and preemptive request timeout rate.
void	restRequest(com.linkedin.r2.message.rest.RestRequest request, com.linkedin.r2.message.RequestContext requestContext, java.util.Map<java.lang.String,java.lang.String> wireAttrs, com.linkedin.r2.transport.common.bridge.common.TransportCallback<com.linkedin.r2.message.rest.RestResponse> callback)
void	shutdown(com.linkedin.common.callback.Callback<com.linkedin.common.util.None> callback)
void	streamRequest(com.linkedin.r2.message.stream.StreamRequest request, com.linkedin.r2.message.RequestContext requestContext, java.util.Map<java.lang.String,java.lang.String> wireAttrs, com.linkedin.r2.transport.common.bridge.common.TransportCallback<com.linkedin.r2.message.stream.StreamResponse> callback)

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpNettyClient

public HttpNettyClient(io.netty.channel.EventLoopGroup eventLoopGroup,
                       java.util.concurrent.ScheduledExecutorService scheduler,
                       java.util.concurrent.ExecutorService callbackExecutor,
                       ChannelPoolManager channelPoolManager,
                       ChannelPoolManager sslChannelPoolManager,
                       com.linkedin.r2.transport.http.common.HttpProtocolVersion protocolVersion,
                       com.linkedin.util.clock.Clock clock,
                       long requestTimeout,
                       long streamingTimeout,
                       long shutdownTimeout)

Creates a new instance of HttpNettyClient.

Parameters:

eventLoopGroup - Non-blocking event loop group implementation for selectors and channels

callbackExecutor - Executor service for executing user callbacks. The executor must be provided because user callbacks can potentially be blocking. If executed with the event loop group, threads might be blocked and cause channels to hang.

channelPoolManager - Channel pool manager for non-SSL channels

sslChannelPoolManager - Channel pool manager for SSL channels

protocolVersion - HTTP version the client uses to send requests and receive responses

clock - Clock to get current time

requestTimeout - Time in milliseconds before an error response is returned in the callback with a TimeoutException

shutdownTimeout - Client shutdown timeout

Method Detail

restRequest

public void restRequest(com.linkedin.r2.message.rest.RestRequest request,
                        com.linkedin.r2.message.RequestContext requestContext,
                        java.util.Map<java.lang.String,java.lang.String> wireAttrs,
                        com.linkedin.r2.transport.common.bridge.common.TransportCallback<com.linkedin.r2.message.rest.RestResponse> callback)

Specified by:

restRequest in interface com.linkedin.r2.transport.common.bridge.client.TransportClient

streamRequest

public void streamRequest(com.linkedin.r2.message.stream.StreamRequest request,
                          com.linkedin.r2.message.RequestContext requestContext,
                          java.util.Map<java.lang.String,java.lang.String> wireAttrs,
                          com.linkedin.r2.transport.common.bridge.common.TransportCallback<com.linkedin.r2.message.stream.StreamResponse> callback)

Specified by:

streamRequest in interface com.linkedin.r2.transport.common.bridge.client.TransportClient

shutdown

public void shutdown(com.linkedin.common.callback.Callback<com.linkedin.common.util.None> callback)

Specified by:

shutdown in interface com.linkedin.r2.transport.common.bridge.client.TransportClient

resolveRequestTimeout

public static long resolveRequestTimeout(com.linkedin.r2.message.RequestContext context,
                                         long requestTimeout)

Resolves the request timeout based on the client configured timeout, request timeout, and preemptive request timeout rate.

Parameters:

context - Request context

requestTimeout - client configured timeout

Returns:

Resolve request timeout

resolveAddress

public static java.net.SocketAddress resolveAddress(com.linkedin.r2.message.Request request,
                                                    com.linkedin.r2.message.RequestContext requestContext)
                                             throws java.net.UnknownHostException,
                                                    UnknownSchemeException

Resolves the IP Address from the URI host

Parameters:

request - Request object

requestContext - Request's context

Returns:

SocketAddress resolved from the URI host

Throws:

java.net.UnknownHostException

UnknownSchemeException