org.apache.hadoop.hbase.client

Class MasterRegistry

java.lang.Object

org.apache.hadoop.hbase.client.MasterRegistry

All Implemented Interfaces:

Closeable, AutoCloseable, ConnectionRegistry

Deprecated.

Since 2.5.0, will be removed in 4.0.0. Use RpcConnectionRegistry instead.

@Deprecated
 @InterfaceAudience.Private
public class MasterRegistry
extends Object

Master based registry implementation. Makes RPCs to the configured master addresses from config "hbase.masters".

It supports hedged reads, set the fan out of the requests batch by MASTER_REGISTRY_HEDGED_REQS_FANOUT_KEY to a value greater than 1 will enable it(the default value is AbstractRpcBasedConnectionRegistry.HEDGED_REQS_FANOUT_DEFAULT).

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 int	HEDGED_REQS_FANOUT_DEFAULT Default value for the fan out of hedged requests.
static String	MASTER_REGISTRY_HEDGED_REQS_FANOUT_KEY Deprecated. Configuration key that controls the fan out of requests
static String	MASTER_REGISTRY_INITIAL_REFRESH_DELAY_SECS Deprecated.
static String	MASTER_REGISTRY_MIN_SECS_BETWEEN_REFRESHES Deprecated.
static String	MASTER_REGISTRY_PERIODIC_REFRESH_INTERVAL_SECS Deprecated.

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() Deprecated.
CompletableFuture<ServerName>	getActiveMaster() Get the address of active HMaster.
protected Set<ServerName>	getBootstrapNodes(org.apache.hadoop.conf.Configuration conf) Deprecated.
CompletableFuture<String>	getClusterId() Should only be called once.
String	getConnectionString() Deprecated. Return the connection string associated with this registry instance.
static String	getMasterAddr(org.apache.hadoop.conf.Configuration conf) Deprecated. Builds the default master address end point if it is not specified in the configuration.
CompletableFuture<RegionLocations>	getMetaRegionLocations() Get the location of meta region(s).
static Set<ServerName>	parseMasterAddrs(org.apache.hadoop.conf.Configuration conf) Deprecated. Parses the list of master addresses from the provided configuration.

Methods inherited from class java.lang.Object

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

Field Detail

MASTER_REGISTRY_HEDGED_REQS_FANOUT_KEY

public static final String MASTER_REGISTRY_HEDGED_REQS_FANOUT_KEY

Deprecated.

Configuration key that controls the fan out of requests

See Also:

Constant Field Values

MASTER_REGISTRY_INITIAL_REFRESH_DELAY_SECS

public static final String MASTER_REGISTRY_INITIAL_REFRESH_DELAY_SECS

Deprecated.

See Also:

Constant Field Values

MASTER_REGISTRY_PERIODIC_REFRESH_INTERVAL_SECS

public static final String MASTER_REGISTRY_PERIODIC_REFRESH_INTERVAL_SECS

Deprecated.

See Also:

Constant Field Values

MASTER_REGISTRY_MIN_SECS_BETWEEN_REFRESHES

public static final String MASTER_REGISTRY_MIN_SECS_BETWEEN_REFRESHES

Deprecated.

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

parseMasterAddrs

public static Set<ServerName> parseMasterAddrs(org.apache.hadoop.conf.Configuration conf)
                                        throws UnknownHostException

Deprecated.

Parses the list of master addresses from the provided configuration. Supported format is comma separated host[:port] values. If no port number if specified, default master port is assumed.

Parameters:

conf - Configuration to parse from.

Throws:

UnknownHostException

getBootstrapNodes

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

Deprecated.

Throws:

IOException

fetchEndpoints

protected CompletableFuture<Set<ServerName>> fetchEndpoints()

Deprecated.

getConnectionString

public String getConnectionString()

Deprecated.

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.

getMasterAddr

public static String getMasterAddr(org.apache.hadoop.conf.Configuration conf)
                            throws UnknownHostException

Deprecated.

Builds the default master address end point if it is not specified in the configuration.

Will be called in HBaseTestingUtility.

Throws:

UnknownHostException

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