org.apache.hadoop.hbase.client

Class RpcConnectionRegistry

java.lang.Object

org.apache.hadoop.hbase.client.RpcConnectionRegistry

All Implemented Interfaces:

Closeable, AutoCloseable, ConnectionRegistry

@InterfaceAudience.LimitedPrivate(value="Configuration")
public class RpcConnectionRegistry
extends Object

Rpc based connection registry. It will make use of the RegistryProtos.ClientMetaService to get registry information.

It needs bootstrap node list when start up, and then it will use RegistryProtos.ClientMetaService to refresh the bootstrap node list periodically.

Usually, you could set masters as the bootstrap nodes,as they will also implement the RegistryProtos.ClientMetaService, and then, we will switch to use region servers after refreshing the bootstrap nodes.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static interface	AbstractRpcBasedConnectionRegistry.Callable<T> For describing the actual asynchronous rpc call.

Field Summary

Fields

Modifier and Type	Field and Description
static String	BOOTSTRAP_NODES
static int	HEDGED_REQS_FANOUT_DEFAULT Default value for the fan out of hedged requests.
static String	HEDGED_REQS_FANOUT_KEY Configuration key that controls the fan out of requests
static String	INITIAL_REFRESH_DELAY_SECS As end users could configure any nodes in a cluster as the initial bootstrap nodes, it is possible that different end users will configure the same machine which makes the machine over load.
static String	MIN_SECS_BETWEEN_REFRESHES
static String	PERIODIC_REFRESH_INTERVAL_SECS

Method Summary

Modifier and Type	Method and Description
protected <T extends org.apache.hbase.thirdparty.com.google.protobuf.Message> CompletableFuture<T>	call(AbstractRpcBasedConnectionRegistry.Callable<T> callable, Predicate<T> isValidResp, String debug)
void	close() Closes this instance and releases any system resources associated with it
protected CompletableFuture<Set<ServerName>>	fetchEndpoints()
CompletableFuture<ServerName>	getActiveMaster() Get the address of active HMaster.
protected Set<ServerName>	getBootstrapNodes(org.apache.hadoop.conf.Configuration conf)
CompletableFuture<String>	getClusterId() Should only be called once.
String	getConnectionString() Return the connection string associated with this registry instance.
CompletableFuture<RegionLocations>	getMetaRegionLocations() Get the location of meta region(s).

Methods inherited from class java.lang.Object

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

Field Detail

HEDGED_REQS_FANOUT_KEY

public static final String HEDGED_REQS_FANOUT_KEY

Configuration key that controls the fan out of requests

See Also:

Constant Field Values

INITIAL_REFRESH_DELAY_SECS

public static final String INITIAL_REFRESH_DELAY_SECS

As end users could configure any nodes in a cluster as the initial bootstrap nodes, it is possible that different end users will configure the same machine which makes the machine over load. So we should have a shorter delay for the initial refresh, to let users quickly switch to the bootstrap nodes we want them to connect to.

The default value for initial refresh delay is 1/10 of periodic refresh interval.

See Also:

Constant Field Values

PERIODIC_REFRESH_INTERVAL_SECS

public static final String PERIODIC_REFRESH_INTERVAL_SECS

See Also:

Constant Field Values

MIN_SECS_BETWEEN_REFRESHES

public static final String MIN_SECS_BETWEEN_REFRESHES

See Also:

Constant Field Values

BOOTSTRAP_NODES

public static final String BOOTSTRAP_NODES

See Also:

Constant Field Values

HEDGED_REQS_FANOUT_DEFAULT

public static final int HEDGED_REQS_FANOUT_DEFAULT

Default value for the fan out of hedged requests.

See Also:

Constant Field Values

Method Detail

getBootstrapNodes

protected Set<ServerName> getBootstrapNodes(org.apache.hadoop.conf.Configuration conf)
                                     throws IOException

Throws:

IOException

getConnectionString

public String getConnectionString()

Description copied from interface: ConnectionRegistry

Return the connection string associated with this registry instance. This value is informational, used for annotating traces. Values returned may not be valid for establishing a working cluster connection.

fetchEndpoints

protected CompletableFuture<Set<ServerName>> fetchEndpoints()

call

protected final <T extends org.apache.hbase.thirdparty.com.google.protobuf.Message> CompletableFuture<T> call(AbstractRpcBasedConnectionRegistry.Callable<T> callable,
                                                                                                              Predicate<T> isValidResp,
                                                                                                              String debug)

getMetaRegionLocations

public CompletableFuture<RegionLocations> getMetaRegionLocations()

Description copied from interface: ConnectionRegistry

Get the location of meta region(s).

Specified by:

getMetaRegionLocations in interface ConnectionRegistry

getClusterId

public CompletableFuture<String> getClusterId()

Description copied from interface: ConnectionRegistry

Should only be called once.

The upper layer should store this value somewhere as it will not be change any more.

Specified by:

getClusterId in interface ConnectionRegistry

getActiveMaster

public CompletableFuture<ServerName> getActiveMaster()

Description copied from interface: ConnectionRegistry

Get the address of active HMaster.

Specified by:

getActiveMaster in interface ConnectionRegistry

close

public void close()

Description copied from interface: ConnectionRegistry

Closes this instance and releases any system resources associated with it

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in interface ConnectionRegistry