org.apache.hadoop.hbase.ipc

Class AsyncRpcClient

java.lang.Object

org.apache.hadoop.hbase.ipc.AbstractRpcClient

org.apache.hadoop.hbase.ipc.AsyncRpcClient

@InterfaceAudience.Private
public class AsyncRpcClient
extends AbstractRpcClient

Netty client for the requests and responses

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AsyncRpcClient.RpcChannelImplementation Blocking rpc channel that goes via hbase rpc.

Nested classes/interfaces inherited from class org.apache.hadoop.hbase.ipc.AbstractRpcClient

AbstractRpcClient.BlockingRpcChannelImplementation

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.concurrent.atomic.AtomicInteger	callIdCnt
static io.netty.util.HashedWheelTimer	WHEEL_TIMER

Fields inherited from class org.apache.hadoop.hbase.ipc.AbstractRpcClient

clusterId, codec, compressor, conf, connectTO, DEFAULT_CODEC_CLASS, DEFAULT_SOCKET_TIMEOUT_CONNECT, DEFAULT_SOCKET_TIMEOUT_READ, DEFAULT_SOCKET_TIMEOUT_WRITE, failureSleep, fallbackAllowed, IDLE_TIME, ipcUtil, localAddr, LOG, maxRetries, minIdleTimeBeforeClose, readTO, SOCKET_TIMEOUT_CONNECT, SOCKET_TIMEOUT_READ, SOCKET_TIMEOUT_WRITE, tcpKeepAlive, tcpNoDelay, userProvider, writeTO

Constructor Summary

Constructors

Constructor and Description
AsyncRpcClient(org.apache.hadoop.conf.Configuration configuration, java.lang.String clusterId, java.net.SocketAddress localAddress) Constructor

Method Summary

Methods

Modifier and Type	Method and Description
java.nio.ByteBuffer	buildCellBlock(org.apache.hadoop.hbase.CellScanner cells) Build cell block
protected org.apache.hadoop.hbase.util.Pair<com.google.protobuf.Message,org.apache.hadoop.hbase.CellScanner>	call(AsyncPayloadCarryingRpcController pcrc, com.google.protobuf.Descriptors.MethodDescriptor md, com.google.protobuf.Message param, com.google.protobuf.Message returnType, org.apache.hadoop.hbase.security.User ticket, java.net.InetSocketAddress addr) Make a call, passing param, to the IPC server running at address which is servicing the protocol protocol, with the ticket credentials, returning the value.
void	cancelConnections(org.apache.hadoop.hbase.ServerName sn) Interrupt the connections to the given ip:port server.
void	close() Close netty
org.apache.hadoop.hbase.CellScanner	createCellScanner(byte[] cellBlock) Create a cell scanner
com.google.protobuf.RpcChannel	createRpcChannel(org.apache.hadoop.hbase.ServerName sn, org.apache.hadoop.hbase.security.User user, int rpcTimeout) Creates a "channel" that can be used by a protobuf service.
io.netty.util.concurrent.EventExecutor	getEventLoop() Get netty event loop
void	removeConnection(org.apache.hadoop.hbase.ipc.RpcClient.ConnectionId connectionId) Remove connection from pool

Methods inherited from class org.apache.hadoop.hbase.ipc.AbstractRpcClient

createBlockingRpcChannel, getDefaultCodec, getPoolSize, getPoolType

Methods inherited from class java.lang.Object

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

Field Detail

WHEEL_TIMER

public static final io.netty.util.HashedWheelTimer WHEEL_TIMER

callIdCnt

protected final java.util.concurrent.atomic.AtomicInteger callIdCnt

Constructor Detail

AsyncRpcClient

public AsyncRpcClient(org.apache.hadoop.conf.Configuration configuration,
              java.lang.String clusterId,
              java.net.SocketAddress localAddress)

Constructor

Parameters:

configuration - to HBase

clusterId - for the cluster

localAddress - local address to connect to

Method Detail

call

protected org.apache.hadoop.hbase.util.Pair<com.google.protobuf.Message,org.apache.hadoop.hbase.CellScanner> call(AsyncPayloadCarryingRpcController pcrc,
                                                                                                      com.google.protobuf.Descriptors.MethodDescriptor md,
                                                                                                      com.google.protobuf.Message param,
                                                                                                      com.google.protobuf.Message returnType,
                                                                                                      org.apache.hadoop.hbase.security.User ticket,
                                                                                                      java.net.InetSocketAddress addr)
                                                                                                           throws java.io.IOException,
                                                                                                                  java.lang.InterruptedException

Make a call, passing param, to the IPC server running at address which is servicing the protocol protocol, with the ticket credentials, returning the value. Throws exceptions if there are network problems or if the remote code threw an exception.

Specified by:

call in class AbstractRpcClient

Parameters:

ticket - Be careful which ticket you pass. A new user will mean a new Connection. UserProvider.getCurrent() makes a new instance of User each time so will be a new Connection each time.

Returns:

A pair with the Message response and the Cell data (if any).

Throws:

java.lang.InterruptedException - if call is interrupted

java.io.IOException - if a connection failure is encountered

close

public void close()

Close netty

createCellScanner

public org.apache.hadoop.hbase.CellScanner createCellScanner(byte[] cellBlock)
                                                      throws java.io.IOException

Create a cell scanner

Parameters:

cellBlock - to create scanner for

Returns:

CellScanner

Throws:

java.io.IOException - on error on creation cell scanner

buildCellBlock

public java.nio.ByteBuffer buildCellBlock(org.apache.hadoop.hbase.CellScanner cells)
                                   throws java.io.IOException

Build cell block

Parameters:

cells - to create block with

Returns:

ByteBuffer with cells

Throws:

java.io.IOException - if block creation fails

cancelConnections

public void cancelConnections(org.apache.hadoop.hbase.ServerName sn)

Interrupt the connections to the given ip:port server. This should be called if the server is known as actually dead. This will not prevent current operation to be retried, and, depending on their own behavior, they may retry on the same server. This can be a feature, for example at startup. In any case, they're likely to get connection refused (if the process died) or no route to host: i.e. there next retries should be faster and with a safe exception.

Parameters:

sn - server to cancel connections for

removeConnection

public void removeConnection(org.apache.hadoop.hbase.ipc.RpcClient.ConnectionId connectionId)

Remove connection from pool

Parameters:

connectionId - of connection

createRpcChannel

public com.google.protobuf.RpcChannel createRpcChannel(org.apache.hadoop.hbase.ServerName sn,
                                              org.apache.hadoop.hbase.security.User user,
                                              int rpcTimeout)

Creates a "channel" that can be used by a protobuf service. Useful setting up protobuf stubs.

Parameters:

sn - server name describing location of server

user - which is to use the connection

rpcTimeout - default rpc operation timeout

Returns:

A rpc channel that goes via this rpc client instance.

Throws:

java.io.IOException - when channel could not be created

getEventLoop

public io.netty.util.concurrent.EventExecutor getEventLoop()

Get netty event loop

Returns:

event loop