org.apache.hadoop.hbase.ipc

类 AbstractRpcClient<T extends org.apache.hadoop.hbase.ipc.RpcConnection>

java.lang.Object

org.apache.hadoop.hbase.ipc.AbstractRpcClient<T>

所有已实现的接口:

Closeable, AutoCloseable, RpcClient

直接已知子类:

BlockingRpcClient, NettyRpcClient

@InterfaceAudience.Private
public abstract class AbstractRpcClient<T extends org.apache.hadoop.hbase.ipc.RpcConnection>
extends Object
implements RpcClient

Provides the basics for a RpcClient implementation like configuration and Logging.

Locking schema of the current IPC implementation

• There is a lock in AbstractRpcClient to protect the fetching or creating connection.
• There is a lock in Call to make sure that we can only finish the call once.
• The same for HBaseRpcController as Call. And see the comment of HBaseRpcController.notifyOnCancel(RpcCallback, HBaseRpcController.CancellationCallback) of how to deal with cancel.
• For connection implementation, the construction of a connection should be as fast as possible because the creation is protected under a lock. Connect to remote side when needed. There is no forced locking schema for a connection implementation.
• For the locking order, the Call and HBaseRpcController's lock should be held at last. So the callbacks in Call and HBaseRpcController should be execute outside the lock in Call and HBaseRpcController which means the implementations of the callbacks are free to hold any lock.

从以下版本开始:

2.0.0

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	AbstractRpcClient.BlockingRpcChannelImplementation Blocking rpc channel that goes via hbase rpc.
static class	AbstractRpcClient.RpcChannelImplementation Async rpc channel that goes via hbase rpc.

字段概要

字段

限定符和类型	字段和说明
protected org.apache.hadoop.hbase.ipc.CellBlockBuilder	cellBlockBuilder
protected String	clusterId
protected Codec	codec
protected org.apache.hadoop.io.compress.CompressionCodec	compressor
protected org.apache.hadoop.conf.Configuration	conf
protected PoolMap<org.apache.hadoop.hbase.ipc.ConnectionId,T>	connections
protected int	connectTO
protected FailedServers	failedServers
protected long	failureSleep
protected boolean	fallbackAllowed
protected SocketAddress	localAddr
static org.slf4j.Logger	LOG
protected int	maxRetries
protected MetricsConnection	metrics
protected int	minIdleTimeBeforeClose
protected int	readTO
protected boolean	running
protected boolean	tcpKeepAlive
protected boolean	tcpNoDelay
protected static Map<org.apache.hadoop.hbase.protobuf.generated.AuthenticationProtos.TokenIdentifier.Kind,org.apache.hadoop.security.token.TokenSelector<? extends org.apache.hadoop.security.token.TokenIdentifier>>	TOKEN_HANDLERS
protected UserProvider	userProvider
protected static org.apache.hbase.thirdparty.io.netty.util.HashedWheelTimer	WHEEL_TIMER
protected int	writeTO

从接口继承的字段 org.apache.hadoop.hbase.ipc.RpcClient

DEFAULT_CODEC_CLASS, DEFAULT_SOCKET_TIMEOUT_CONNECT, DEFAULT_SOCKET_TIMEOUT_READ, DEFAULT_SOCKET_TIMEOUT_WRITE, FAILED_SERVER_EXPIRY_DEFAULT, FAILED_SERVER_EXPIRY_KEY, IDLE_TIME, IPC_CLIENT_FALLBACK_TO_SIMPLE_AUTH_ALLOWED_DEFAULT, IPC_CLIENT_FALLBACK_TO_SIMPLE_AUTH_ALLOWED_KEY, PING_CALL_ID, SOCKET_TIMEOUT_CONNECT, SOCKET_TIMEOUT_READ, SOCKET_TIMEOUT_WRITE, SPECIFIC_WRITE_THREAD

构造器概要

构造器

构造器和说明
AbstractRpcClient(org.apache.hadoop.conf.Configuration conf, String clusterId, SocketAddress localAddr, MetricsConnection metrics) Construct an IPC client for the cluster clusterId

方法概要

限定符和类型	方法和说明
void	cancelConnections(ServerName sn) Interrupt the connections to the given ip:port server.
void	close() Stop all threads related to this client.
protected abstract void	closeInternal()
org.apache.hbase.thirdparty.com.google.protobuf.BlockingRpcChannel	createBlockingRpcChannel(ServerName sn, User ticket, int rpcTimeout) Creates a "channel" that can be used by a blocking protobuf service.
protected abstract T	createConnection(org.apache.hadoop.hbase.ipc.ConnectionId remoteId) Not connected.
org.apache.hbase.thirdparty.com.google.protobuf.RpcChannel	createRpcChannel(ServerName sn, User user, int rpcTimeout) Creates a "channel" that can be used by a protobuf service.
static String	getDefaultCodec(org.apache.hadoop.conf.Configuration c)
boolean	hasCellBlockSupport()

从类继承的方法 java.lang.Object

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

字段详细资料

LOG

public static final org.slf4j.Logger LOG

WHEEL_TIMER

protected static final org.apache.hbase.thirdparty.io.netty.util.HashedWheelTimer WHEEL_TIMER

TOKEN_HANDLERS

protected static final Map<org.apache.hadoop.hbase.protobuf.generated.AuthenticationProtos.TokenIdentifier.Kind,org.apache.hadoop.security.token.TokenSelector<? extends org.apache.hadoop.security.token.TokenIdentifier>> TOKEN_HANDLERS

running

protected boolean running

conf

protected final org.apache.hadoop.conf.Configuration conf

clusterId

protected final String clusterId

localAddr

protected final SocketAddress localAddr

metrics

protected final MetricsConnection metrics

userProvider

protected final UserProvider userProvider

cellBlockBuilder

protected final org.apache.hadoop.hbase.ipc.CellBlockBuilder cellBlockBuilder

minIdleTimeBeforeClose

protected final int minIdleTimeBeforeClose

maxRetries

protected final int maxRetries

failureSleep

protected final long failureSleep

tcpNoDelay

protected final boolean tcpNoDelay

tcpKeepAlive

protected final boolean tcpKeepAlive

codec

protected final Codec codec

compressor

protected final org.apache.hadoop.io.compress.CompressionCodec compressor

fallbackAllowed

protected final boolean fallbackAllowed

failedServers

protected final FailedServers failedServers

connectTO

protected final int connectTO

readTO

protected final int readTO

writeTO

protected final int writeTO

connections

protected final PoolMap<org.apache.hadoop.hbase.ipc.ConnectionId,T extends org.apache.hadoop.hbase.ipc.RpcConnection> connections

构造器详细资料

AbstractRpcClient

public AbstractRpcClient(org.apache.hadoop.conf.Configuration conf,
                         String clusterId,
                         SocketAddress localAddr,
                         MetricsConnection metrics)

Construct an IPC client for the cluster clusterId

参数:

conf - configuration

clusterId - the cluster id

localAddr - client socket bind address.

metrics - the connection metrics

方法详细资料

getDefaultCodec

public static String getDefaultCodec(org.apache.hadoop.conf.Configuration c)

hasCellBlockSupport

public boolean hasCellBlockSupport()

指定者:

hasCellBlockSupport 在接口中 RpcClient

返回:

true when this client uses a Codec and so supports cell blocks.

createConnection

protected abstract T createConnection(org.apache.hadoop.hbase.ipc.ConnectionId remoteId)
                               throws IOException

Not connected.

抛出:

IOException

cancelConnections

public void cancelConnections(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. their next retries should be faster and with a safe exception.

指定者:

cancelConnections 在接口中 RpcClient

参数:

sn - server location to cancel connections of

closeInternal

protected abstract void closeInternal()

close

public void close()

从接口复制的说明: RpcClient

Stop all threads related to this client. No further calls may be made using this client.

指定者:

close 在接口中 Closeable

指定者:

close 在接口中 AutoCloseable

指定者:

close 在接口中 RpcClient

createBlockingRpcChannel

public org.apache.hbase.thirdparty.com.google.protobuf.BlockingRpcChannel createBlockingRpcChannel(ServerName sn,
                                                                                                   User ticket,
                                                                                                   int rpcTimeout)
                                                                                            throws UnknownHostException

从接口复制的说明: RpcClient

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

指定者:

createBlockingRpcChannel 在接口中 RpcClient

参数:

sn - server name describing location of server

ticket - which is to use the connection

rpcTimeout - default rpc operation timeout

返回:

A blocking rpc channel that goes via this rpc client instance.

抛出:

UnknownHostException

createRpcChannel

public org.apache.hbase.thirdparty.com.google.protobuf.RpcChannel createRpcChannel(ServerName sn,
                                                                                   User user,
                                                                                   int rpcTimeout)
                                                                            throws UnknownHostException

从接口复制的说明: RpcClient

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

指定者:

createRpcChannel 在接口中 RpcClient

参数:

sn - server name describing location of server

user - which is to use the connection

rpcTimeout - default rpc operation timeout

返回:

A rpc channel that goes via this rpc client instance.

抛出:

UnknownHostException