org.apache.hadoop.hbase.master.assignment

Class RegionStates

java.lang.Object

org.apache.hadoop.hbase.master.assignment.RegionStates

@InterfaceAudience.Private
public class RegionStates
extends Object

RegionStates contains a set of Maps that describes the in-memory state of the AM, with the regions available in the system, the region in transition, the offline regions and the servers holding regions.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RegionStates.RegionFailedOpen
static class	RegionStates.RegionStateNode Current Region State.
static class	RegionStates.ServerState
static class	RegionStates.ServerStateNode

Field Summary

Fields

Modifier and Type	Field and Description
static org.apache.hadoop.hbase.master.assignment.RegionStates.RegionStateStampComparator	REGION_STATE_STAMP_COMPARATOR
protected static RegionState.State[]	STATES_EXPECTED_ON_CLOSE
protected static RegionState.State[]	STATES_EXPECTED_ON_OPEN

Constructor Summary

Constructors

Constructor and Description
RegionStates()

Method Summary

Modifier and Type	Method and Description
protected boolean	addRegionInTransition(RegionStates.RegionStateNode regionNode, RegionTransitionProcedure procedure)
RegionStates.ServerStateNode	addRegionToServer(ServerName serverName, RegionStates.RegionStateNode regionNode)
RegionStates.RegionFailedOpen	addToFailedOpen(RegionStates.RegionStateNode regionNode)
void	addToOfflineRegions(RegionStates.RegionStateNode regionNode)
void	clear()
protected RegionStates.RegionStateNode	createRegionNode(HRegionInfo regionInfo)
void	deleteRegion(HRegionInfo regionInfo)
List<HRegionInfo>	getAssignedRegions()
Map<TableName,Map<ServerName,List<HRegionInfo>>>	getAssignmentsByTable()
Map<TableName,Map<ServerName,List<HRegionInfo>>>	getAssignmentsByTable(boolean forceByCluster) This is an EXPENSIVE clone.
double	getAverageLoad()
RegionStates.RegionFailedOpen	getFailedOpen(HRegionInfo regionInfo)
protected RegionStates.RegionStateNode	getOrCreateRegionNode(HRegionInfo regionInfo)
RegionStates.ServerStateNode	getOrCreateServer(ServerName serverName)
Map<HRegionInfo,ServerName>	getRegionAssignments()
Map<RegionState.State,List<HRegionInfo>>	getRegionByStateOfTable(TableName tableName)
List<RegionState>	getRegionFailedOpen()
protected RegionStates.RegionStateNode	getRegionNode(HRegionInfo regionInfo)
ServerName	getRegionServerOfRegion(HRegionInfo regionInfo)
List<RegionStates.RegionStateNode>	getRegionsInTransition()
int	getRegionsInTransitionCount() Get the number of regions in transition.
SortedSet<RegionState>	getRegionsInTransitionOrderedByTimestamp()
List<HRegionInfo>	getRegionsOfTable(TableName table)
List<RegionState>	getRegionsStateInTransition()
RegionState	getRegionState(HRegionInfo regionInfo)
RegionState	getRegionState(String encodedRegionName)
ArrayList<RegionState>	getRegionStates()
RegionTransitionProcedure	getRegionTransitionProcedure(HRegionInfo hri)
RegionState	getRegionTransitionState(HRegionInfo hri)
protected RegionStates.ServerStateNode	getServerNode(ServerName serverName)
List<HRegionInfo>	getServerRegionInfoSet(ServerName serverName) Returns the set of regions hosted by the specified server
Map<ServerName,List<HRegionInfo>>	getSnapShotOfAssignment(Collection<HRegionInfo> regions)
boolean	hasRegionsInTransition()
boolean	hasTableRegionStates(TableName tableName)
boolean	isRegionInRegionStates(HRegionInfo hri)
boolean	isRegionInState(HRegionInfo regionInfo, RegionState.State... state)
boolean	isRegionInTransition(HRegionInfo regionInfo)
boolean	isRegionOffline(HRegionInfo regionInfo)
boolean	isRegionOnline(HRegionInfo regionInfo)
void	logSplit(HRegionInfo regionInfo)
void	logSplit(ServerName serverName)
static String	regionNamesToString(Collection<byte[]> regions)
void	removeFromFailedOpen(HRegionInfo regionInfo)
void	removeFromOfflineRegions(HRegionInfo regionInfo)
RegionStates.ServerStateNode	removeRegionFromServer(ServerName serverName, RegionStates.RegionStateNode regionNode)
protected void	removeRegionInTransition(RegionStates.RegionStateNode regionNode, RegionTransitionProcedure procedure)
void	removeServer(ServerName serverName)
void	updateRegionState(HRegionInfo regionInfo, RegionState.State state)

Methods inherited from class java.lang.Object

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

Field Detail

STATES_EXPECTED_ON_OPEN

protected static final RegionState.State[] STATES_EXPECTED_ON_OPEN

STATES_EXPECTED_ON_CLOSE

protected static final RegionState.State[] STATES_EXPECTED_ON_CLOSE

REGION_STATE_STAMP_COMPARATOR

public static final org.apache.hadoop.hbase.master.assignment.RegionStates.RegionStateStampComparator REGION_STATE_STAMP_COMPARATOR

Constructor Detail

RegionStates

public RegionStates()

Method Detail

clear

public void clear()

isRegionInRegionStates

public boolean isRegionInRegionStates(HRegionInfo hri)

createRegionNode

protected RegionStates.RegionStateNode createRegionNode(HRegionInfo regionInfo)

getOrCreateRegionNode

protected RegionStates.RegionStateNode getOrCreateRegionNode(HRegionInfo regionInfo)

getRegionNode

protected RegionStates.RegionStateNode getRegionNode(HRegionInfo regionInfo)

deleteRegion

public void deleteRegion(HRegionInfo regionInfo)

getRegionStates

public ArrayList<RegionState> getRegionStates()

getRegionState

public RegionState getRegionState(HRegionInfo regionInfo)

getRegionState

public RegionState getRegionState(String encodedRegionName)

hasTableRegionStates

public boolean hasTableRegionStates(TableName tableName)

getRegionsOfTable

public List<HRegionInfo> getRegionsOfTable(TableName table)

getServerRegionInfoSet

public List<HRegionInfo> getServerRegionInfoSet(ServerName serverName)

Returns the set of regions hosted by the specified server

Parameters:

serverName - the server we are interested in

Returns:

set of HRegionInfo hosted by the specified server

logSplit

public void logSplit(ServerName serverName)

logSplit

public void logSplit(HRegionInfo regionInfo)

updateRegionState

public void updateRegionState(HRegionInfo regionInfo,
                              RegionState.State state)

getAssignedRegions

public List<HRegionInfo> getAssignedRegions()

isRegionInState

public boolean isRegionInState(HRegionInfo regionInfo,
                               RegionState.State... state)

isRegionOnline

public boolean isRegionOnline(HRegionInfo regionInfo)

isRegionOffline

public boolean isRegionOffline(HRegionInfo regionInfo)

Returns:

True if region is offline (In OFFLINE or CLOSED state).

getSnapShotOfAssignment

public Map<ServerName,List<HRegionInfo>> getSnapShotOfAssignment(Collection<HRegionInfo> regions)

getRegionAssignments

public Map<HRegionInfo,ServerName> getRegionAssignments()

getRegionByStateOfTable

public Map<RegionState.State,List<HRegionInfo>> getRegionByStateOfTable(TableName tableName)

getRegionServerOfRegion

public ServerName getRegionServerOfRegion(HRegionInfo regionInfo)

getAssignmentsByTable

public Map<TableName,Map<ServerName,List<HRegionInfo>>> getAssignmentsByTable(boolean forceByCluster)

This is an EXPENSIVE clone. Cloning though is the safest thing to do. Can't let out original since it can change and at least the load balancer wants to iterate this exported list. We need to synchronize on regions since all access to this.servers is under a lock on this.regions.

Parameters:

forceByCluster - a flag to force to aggregate the server-load to the cluster level

Returns:

A clone of current assignments by table.

getAssignmentsByTable

public Map<TableName,Map<ServerName,List<HRegionInfo>>> getAssignmentsByTable()

addRegionInTransition

protected boolean addRegionInTransition(RegionStates.RegionStateNode regionNode,
                                        RegionTransitionProcedure procedure)

removeRegionInTransition

protected void removeRegionInTransition(RegionStates.RegionStateNode regionNode,
                                        RegionTransitionProcedure procedure)

hasRegionsInTransition

public boolean hasRegionsInTransition()

isRegionInTransition

public boolean isRegionInTransition(HRegionInfo regionInfo)

getRegionTransitionProcedure

public RegionTransitionProcedure getRegionTransitionProcedure(HRegionInfo hri)

Returns:

If a procedure-in-transition for hri, return it else null.

getRegionTransitionState

public RegionState getRegionTransitionState(HRegionInfo hri)

getRegionsInTransition

public List<RegionStates.RegionStateNode> getRegionsInTransition()

getRegionsInTransitionCount

public int getRegionsInTransitionCount()

Get the number of regions in transition.

getRegionsStateInTransition

public List<RegionState> getRegionsStateInTransition()

getRegionsInTransitionOrderedByTimestamp

public SortedSet<RegionState> getRegionsInTransitionOrderedByTimestamp()

addToOfflineRegions

public void addToOfflineRegions(RegionStates.RegionStateNode regionNode)

removeFromOfflineRegions

public void removeFromOfflineRegions(HRegionInfo regionInfo)

addToFailedOpen

public RegionStates.RegionFailedOpen addToFailedOpen(RegionStates.RegionStateNode regionNode)

getFailedOpen

public RegionStates.RegionFailedOpen getFailedOpen(HRegionInfo regionInfo)

removeFromFailedOpen

public void removeFromFailedOpen(HRegionInfo regionInfo)

getRegionFailedOpen

public List<RegionState> getRegionFailedOpen()

getOrCreateServer

public RegionStates.ServerStateNode getOrCreateServer(ServerName serverName)

removeServer

public void removeServer(ServerName serverName)

getServerNode

protected RegionStates.ServerStateNode getServerNode(ServerName serverName)

getAverageLoad

public double getAverageLoad()

addRegionToServer

public RegionStates.ServerStateNode addRegionToServer(ServerName serverName,
                                                      RegionStates.RegionStateNode regionNode)

removeRegionFromServer

public RegionStates.ServerStateNode removeRegionFromServer(ServerName serverName,
                                                           RegionStates.RegionStateNode regionNode)

regionNamesToString

public static String regionNamesToString(Collection<byte[]> regions)