HRegionInfo (Apache HBase 1.2.12 API)

java.lang.Object
- org.apache.hadoop.hbase.HRegionInfo

All Implemented Interfaces:

Comparable<HRegionInfo>

Direct Known Subclasses:

HBaseFsck.MetaEntry, UnmodifyableHRegionInfo
```
@InterfaceAudience.Public
@InterfaceStability.Evolving
public class HRegionInfo
extends Object
implements Comparable<HRegionInfo>
```
Information about a region. A region is a range of keys in the whole keyspace of a table, an identifier (a timestamp) for differentiating between subset ranges (after region split) and a replicaId for differentiating the instance for the same range and some status information about the region. The region has a unique name which consists of the following fields:
- tableName : The name of the table
- startKey : The startKey for the region.
- regionId : A timestamp when the region is created.
- replicaId : An id starting from 0 to differentiate replicas of the same region range but hosted in separated servers. The same region range can be hosted in multiple locations.
- encodedName : An MD5 encoded string for the region name.
Other than the fields in the region name, region info contains:
- endKey : the endKey for the region (exclusive)
- split : Whether the region is split
- offline : Whether the region is offline
In 0.98 or before, a list of table's regions would fully cover the total keyspace, and at any point in time, a row key always belongs to a single region, which is hosted in a single server. In 0.99+, a region can have multiple instances (called replicas), and thus a range (or row) can correspond to multiple HRegionInfo's. These HRI's share the same fields however except the replicaId field. If the replicaId is not set, it defaults to 0, which is compatible with the previous behavior of a range corresponding to 1 region.

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`DEFAULT_REPLICA_ID`
`private static int`	`ENC_SEPARATOR` Separator used to demarcate the encodedName in a region name in the new format.
`static String`	`ENCODED_REGION_NAME_REGEX` A non-capture group so that this can be embedded.
`private String`	`encodedName`
`private byte[]`	`encodedNameAsBytes`
`private byte[]`	`endKey`
`static HRegionInfo`	`FIRST_META_REGIONINFO` HRegionInfo for first meta region
`private int`	`hashCode`
`static String`	`INVALID_REGION_NAME_FORMAT_MESSAGE`
`private static org.apache.commons.logging.Log`	`LOG`
`private static int`	`MAX_REPLICA_ID`
`static int`	`MD5_HEX_LENGTH`
`static String`	`NO_HASH`
`private boolean`	`offLine`
`private long`	`regionId`
`private byte[]`	`regionName`
`static byte`	`REPLICA_ID_DELIMITER`
`static String`	`REPLICA_ID_FORMAT`
`private int`	`replicaId`
`private boolean`	`split`
`private byte[]`	`startKey`
`private TableName`	`tableName`
`static byte`	`VERSION` Deprecated.

Constructor Summary

Constructors
Modifier	Constructor and Description
	`HRegionInfo()` Deprecated. As of release 0.96 (HBASE-5453). This will be removed in HBase 2.0.0. Used by Writables and Writables are going away.
	`HRegionInfo(HRegionInfo other)` Costruct a copy of another HRegionInfo
	`HRegionInfo(HRegionInfo other, int replicaId)`
`private`	`HRegionInfo(long regionId, TableName tableName)` Private constructor used constructing HRegionInfo for the first meta regions
	`HRegionInfo(long regionId, TableName tableName, int replicaId)`
	`HRegionInfo(TableName tableName)`
	`HRegionInfo(TableName tableName, byte[] startKey, byte[] endKey)` Construct HRegionInfo with explicit parameters
	`HRegionInfo(TableName tableName, byte[] startKey, byte[] endKey, boolean split)` Construct HRegionInfo with explicit parameters
	`HRegionInfo(TableName tableName, byte[] startKey, byte[] endKey, boolean split, long regionid)` Construct HRegionInfo with explicit parameters
	`HRegionInfo(TableName tableName, byte[] startKey, byte[] endKey, boolean split, long regionid, int replicaId)` Construct HRegionInfo with explicit parameters

Method Summary

Methods
Modifier and Type	Method and Description
`static boolean`	`areAdjacent(HRegionInfo regionA, HRegionInfo regionB)` Check whether two regions are adjacent
`int`	`compareTo(HRegionInfo o)`
`boolean`	`containsRange(byte[] rangeStartKey, byte[] rangeEndKey)` Returns true if the given inclusive range of rows is fully contained by this region.
`boolean`	`containsRow(byte[] row)` Return true if the given row falls in this region.
`(package private) org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.RegionInfo`	`convert()` Convert a HRegionInfo to the protobuf RegionInfo
`static HRegionInfo`	`convert(org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.RegionInfo proto)` Convert a RegionInfo to a HRegionInfo
`static org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.RegionInfo`	`convert(HRegionInfo info)` Convert a HRegionInfo to a RegionInfo
`static byte[]`	`createRegionName(TableName tableName, byte[] startKey, byte[] id, boolean newFormat)` Make a region name of passed parameters.
`static byte[]`	`createRegionName(TableName tableName, byte[] startKey, byte[] id, int replicaId, boolean newFormat)` Make a region name of passed parameters.
`static byte[]`	`createRegionName(TableName tableName, byte[] startKey, long regionid, boolean newFormat)` Make a region name of passed parameters.
`static byte[]`	`createRegionName(TableName tableName, byte[] startKey, long regionid, int replicaId, boolean newFormat)` Make a region name of passed parameters.
`static byte[]`	`createRegionName(TableName tableName, byte[] startKey, String id, boolean newFormat)` Make a region name of passed parameters.
`static String`	`encodeRegionName(byte[] regionName)`
`boolean`	`equals(Object o)`
`KeyValue.KVComparator`	`getComparator()`
`static PairOfSameType<HRegionInfo>`	`getDaughterRegions(Result data)` Deprecated. use MetaTableAccessor methods for interacting with meta layouts
`String`	`getEncodedName()`
`byte[]`	`getEncodedNameAsBytes()`
`byte[]`	`getEndKey()`
`static HRegionInfo`	`getHRegionInfo(Result data)` Deprecated. use MetaTableAccessor methods for interacting with meta layouts
`static HRegionInfo`	`getHRegionInfo(Result r, byte[] qualifier)` Deprecated. use MetaTableAccessor methods for interacting with meta layouts
`static Pair<HRegionInfo,ServerName>`	`getHRegionInfoAndServerName(Result r)` Deprecated. use MetaTableAccessor methods for interacting with meta layouts
`static PairOfSameType<HRegionInfo>`	`getMergeRegions(Result data)` Deprecated. use MetaTableAccessor methods for interacting with meta layouts
`long`	`getRegionId()`
`byte[]`	`getRegionName()`
`String`	`getRegionNameAsString()`
`int`	`getReplicaId()` Returns the region replica id
`static long`	`getSeqNumDuringOpen(Result r)` Deprecated. use MetaTableAccessor methods for interacting with meta layouts
`static ServerName`	`getServerName(Result r)` Deprecated. use MetaTableAccessor methods for interacting with meta layouts
`String`	`getShortNameToLog()`
`byte[]`	`getStartKey()`
`static byte[]`	`getStartKey(byte[] regionName)` Gets the start key from the specified region name.
`TableName`	`getTable()` Get current table name of the region
`static TableName`	`getTable(byte[] regionName)` Gets the table name from the specified region name.
`byte[]`	`getTableName()` Deprecated. As of release 0.96 (HBASE-9508). This will be removed in HBase 2.0.0. Use `getTable()`.
`static byte[]`	`getTableName(byte[] regionName)` Deprecated. As of release 0.96 (HBASE-9508). This will be removed in HBase 2.0.0. Use `getTable(byte[])`.
`byte`	`getVersion()` Deprecated. HRI is no longer a VersionedWritable
`private static boolean`	`hasEncodedName(byte[] regionName)` Does region name contain its encoded name?
`int`	`hashCode()`
`boolean`	`isMetaRegion()`
`boolean`	`isMetaTable()`
`boolean`	`isOffline()`
`boolean`	`isSplit()`
`boolean`	`isSplitParent()`
`boolean`	`isSystemTable()`
`static List<HRegionInfo>`	`parseDelimitedFrom(byte[] bytes, int offset, int length)` Parses all the HRegionInfo instances from the passed in stream until EOF.
`static HRegionInfo`	`parseFrom(byte[] bytes)`
`static HRegionInfo`	`parseFrom(byte[] bytes, int offset, int len)`
`static HRegionInfo`	`parseFrom(DataInputStream in)` Parses an HRegionInfo instance from the passed in stream.
`static HRegionInfo`	`parseFromOrNull(byte[] bytes)`
`static HRegionInfo`	`parseFromOrNull(byte[] bytes, int offset, int len)`
`static byte[][]`	`parseRegionName(byte[] regionName)` Separate elements of a regionName.
`static String`	`prettyPrint(String encodedRegionName)` Use logging.
`private void`	`readFields(byte[] bytes, int offset, int len)` Deprecated.
`void`	`readFields(DataInput in)` Deprecated. Use protobuf deserialization instead.
`private void`	`setHashCode()`
`void`	`setOffline(boolean offLine)` The parent of a region split is offline while split daughters hold references to the parent.
`void`	`setSplit(boolean split)`
`byte[]`	`toByteArray()`
`byte[]`	`toDelimitedByteArray()` Use this instead of `toByteArray()` when writing to a stream and you want to use the pb mergeDelimitedFrom (w/o the delimiter, pb reads to EOF which may not be what you want).
`static byte[]`	`toDelimitedByteArray(HRegionInfo... infos)` Serializes given HRegionInfo's as a byte array.
`String`	`toString()`
`void`	`write(DataOutput out)` Deprecated. Use protobuf serialization instead. See `toByteArray()` and `toDelimitedByteArray()`

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - VERSION
```
@Deprecated
public static final byte VERSION
```
    Deprecated.
    
    See Also:
    Constant Field Values
  - LOG
```
private static final org.apache.commons.logging.Log LOG
```
  - ENC_SEPARATOR
```
private static final int ENC_SEPARATOR
```
    Separator used to demarcate the encodedName in a region name in the new format. See description on new format above.
    
    See Also:
    Constant Field Values
  - MD5_HEX_LENGTH
```
public static final int MD5_HEX_LENGTH
```
    See Also:
    Constant Field Values
  - ENCODED_REGION_NAME_REGEX
```
public static final String ENCODED_REGION_NAME_REGEX
```
    A non-capture group so that this can be embedded.
    
    See Also:
    Constant Field Values
  - REPLICA_ID_FORMAT
```
public static final String REPLICA_ID_FORMAT
```
    See Also:
    Constant Field Values
  - REPLICA_ID_DELIMITER
```
public static final byte REPLICA_ID_DELIMITER
```
    See Also:
    Constant Field Values
  - MAX_REPLICA_ID
```
private static final int MAX_REPLICA_ID
```
    See Also:
    Constant Field Values
  - DEFAULT_REPLICA_ID
```
public static final int DEFAULT_REPLICA_ID
```
    See Also:
    Constant Field Values
  - INVALID_REGION_NAME_FORMAT_MESSAGE
```
public static final String INVALID_REGION_NAME_FORMAT_MESSAGE
```
    See Also:
    Constant Field Values
  - endKey
```
private byte[] endKey
```
  - offLine
```
private boolean offLine
```
  - regionId
```
private long regionId
```
  - regionName
```
private transient byte[] regionName
```
  - split
```
private boolean split
```
  - startKey
```
private byte[] startKey
```
  - hashCode
```
private int hashCode
```
  - NO_HASH
```
public static final String NO_HASH
```
  - encodedName
```
private String encodedName
```
  - encodedNameAsBytes
```
private byte[] encodedNameAsBytes
```
  - replicaId
```
private int replicaId
```
  - tableName
```
private TableName tableName
```
  - FIRST_META_REGIONINFO
```
public static final HRegionInfo FIRST_META_REGIONINFO
```
    HRegionInfo for first meta region
- Constructor Detail
  - HRegionInfo
```
private HRegionInfo(long regionId,
           TableName tableName)
```
    Private constructor used constructing HRegionInfo for the first meta regions
  - HRegionInfo
```
public HRegionInfo(long regionId,
           TableName tableName,
           int replicaId)
```
  - HRegionInfo
```
@Deprecated
public HRegionInfo()
```
    Deprecated. As of release 0.96 (HBASE-5453). This will be removed in HBase 2.0.0. Used by Writables and Writables are going away.
    
    Default constructor - creates empty object
  - HRegionInfo
```
public HRegionInfo(TableName tableName)
```
  - HRegionInfo
```
public HRegionInfo(TableName tableName,
           byte[] startKey,
           byte[] endKey)
            throws IllegalArgumentException
```
    Construct HRegionInfo with explicit parameters
    
    Parameters:
    tableName - the table name
    startKey - first key in region
    endKey - end of key range
    
    Throws:
    
    IllegalArgumentException
  - HRegionInfo
```
public HRegionInfo(TableName tableName,
           byte[] startKey,
           byte[] endKey,
           boolean split)
            throws IllegalArgumentException
```
    Construct HRegionInfo with explicit parameters
    
    Parameters:
    tableName - the table descriptor
    startKey - first key in region
    endKey - end of key range
    split - true if this region has split and we have daughter regions regions that may or may not hold references to this region.
    
    Throws:
    
    IllegalArgumentException
  - HRegionInfo
```
public HRegionInfo(TableName tableName,
           byte[] startKey,
           byte[] endKey,
           boolean split,
           long regionid)
            throws IllegalArgumentException
```
    Construct HRegionInfo with explicit parameters
    
    Parameters:
    tableName - the table descriptor
    startKey - first key in region
    endKey - end of key range
    split - true if this region has split and we have daughter regions regions that may or may not hold references to this region.
    regionid - Region id to use.
    
    Throws:
    
    IllegalArgumentException
  - HRegionInfo
```
public HRegionInfo(TableName tableName,
           byte[] startKey,
           byte[] endKey,
           boolean split,
           long regionid,
           int replicaId)
            throws IllegalArgumentException
```
    Construct HRegionInfo with explicit parameters
    
    Parameters:
    tableName - the table descriptor
    startKey - first key in region
    endKey - end of key range
    split - true if this region has split and we have daughter regions regions that may or may not hold references to this region.
    regionid - Region id to use.
    replicaId - the replicaId to use
    
    Throws:
    
    IllegalArgumentException
  - HRegionInfo
```
public HRegionInfo(HRegionInfo other)
```
    Costruct a copy of another HRegionInfo
    
    Parameters:
    other -
  - HRegionInfo
```
public HRegionInfo(HRegionInfo other,
           int replicaId)
```
- Method Detail
  - hasEncodedName
```
private static boolean hasEncodedName(byte[] regionName)
```
    Does region name contain its encoded name?
    
    Parameters:
    regionName - region name
    
    Returns:
    boolean indicating if this a new format region name which contains its encoded name.
  - encodeRegionName
```
public static String encodeRegionName(byte[] regionName)
```
    Parameters:
    regionName -
    
    Returns:
    the encodedName
  - getShortNameToLog
```
public String getShortNameToLog()
```
    Returns:
    Return a short, printable name for this region (usually encoded name) for us logging.
  - prettyPrint
```
public static String prettyPrint(String encodedRegionName)
```
    Use logging.
    
    Parameters:
    encodedRegionName - The encoded regionname.
    
    Returns:
    hbase:meta if passed 1028785192 else returns encodedRegionName
  - setHashCode
```
private void setHashCode()
```
  - createRegionName
```
public static byte[] createRegionName(TableName tableName,
                      byte[] startKey,
                      long regionid,
                      boolean newFormat)
```
    Make a region name of passed parameters.
    
    Parameters:
    tableName -
    startKey - Can be null
    regionid - Region id (Usually timestamp from when region was created).
    newFormat - should we create the region name in the new format (such that it contains its encoded name?).
    
    Returns:
    Region name made of passed tableName, startKey and id
  - createRegionName
```
public static byte[] createRegionName(TableName tableName,
                      byte[] startKey,
                      String id,
                      boolean newFormat)
```
    Make a region name of passed parameters.
    
    Parameters:
    tableName -
    startKey - Can be null
    id - Region id (Usually timestamp from when region was created).
    newFormat - should we create the region name in the new format (such that it contains its encoded name?).
    
    Returns:
    Region name made of passed tableName, startKey and id
  - createRegionName
```
public static byte[] createRegionName(TableName tableName,
                      byte[] startKey,
                      long regionid,
                      int replicaId,
                      boolean newFormat)
```
    Make a region name of passed parameters.
    
    Parameters:
    tableName -
    startKey - Can be null
    regionid - Region id (Usually timestamp from when region was created).
    replicaId -
    newFormat - should we create the region name in the new format (such that it contains its encoded name?).
    
    Returns:
    Region name made of passed tableName, startKey, id and replicaId
  - createRegionName
```
public static byte[] createRegionName(TableName tableName,
                      byte[] startKey,
                      byte[] id,
                      boolean newFormat)
```
    Make a region name of passed parameters.
    
    Parameters:
    tableName -
    startKey - Can be null
    id - Region id (Usually timestamp from when region was created).
    newFormat - should we create the region name in the new format (such that it contains its encoded name?).
    
    Returns:
    Region name made of passed tableName, startKey and id
  - createRegionName
```
public static byte[] createRegionName(TableName tableName,
                      byte[] startKey,
                      byte[] id,
                      int replicaId,
                      boolean newFormat)
```
    Make a region name of passed parameters.
    
    Parameters:
    tableName -
    startKey - Can be null
    id - Region id (Usually timestamp from when region was created).
    replicaId -
    newFormat - should we create the region name in the new format
    
    Returns:
    Region name made of passed tableName, startKey, id and replicaId
  - getTableName
```
@Deprecated
public static byte[] getTableName(byte[] regionName)
```
    Deprecated. As of release 0.96 (HBASE-9508). This will be removed in HBase 2.0.0. Use getTable(byte[]).
    
    Gets the table name from the specified region name.
    
    Parameters:
    regionName -
    
    Returns:
    Table name.
  - getTable
```
public static TableName getTable(byte[] regionName)
```
    Gets the table name from the specified region name. Like getTableName(byte[]) only returns a TableName rather than a byte array.
    
    Parameters:
    regionName -
    
    Returns:
    Table name
    See Also:
    getTableName(byte[])
  - getStartKey
```
public static byte[] getStartKey(byte[] regionName)
                          throws IOException
```
    Gets the start key from the specified region name.
    
    Parameters:
    regionName -
    
    Returns:
    Start key.
    
    Throws:
    
    IOException
  - parseRegionName
```
public static byte[][] parseRegionName(byte[] regionName)
                                throws IOException
```
    Separate elements of a regionName.
    
    Parameters:
    regionName -
    
    Returns:
    Array of byte[] containing tableName, startKey and id
    
    Throws:
    
    IOException
  - getRegionId
```
public long getRegionId()
```
    Returns:
    the regionId
  - getRegionName
```
public byte[] getRegionName()
```
    Returns:
    the regionName as an array of bytes.
    See Also:
    getRegionNameAsString()
  - getRegionNameAsString
```
public String getRegionNameAsString()
```
    Returns:
    Region name as a String for use in logging, etc.
  - getEncodedName
```
public String getEncodedName()
```
    Returns:
    the encoded region name
  - getEncodedNameAsBytes
```
public byte[] getEncodedNameAsBytes()
```
  - getStartKey
```
public byte[] getStartKey()
```
    Returns:
    the startKey
  - getEndKey
```
public byte[] getEndKey()
```
    Returns:
    the endKey
  - getTableName
```
@Deprecated
public byte[] getTableName()
```
    Deprecated. As of release 0.96 (HBASE-9508). This will be removed in HBase 2.0.0. Use getTable().
    
    Get current table name of the region
    
    Returns:
    byte array of table name
  - getTable
```
public TableName getTable()
```
    Get current table name of the region
    
    Returns:
    TableName
    See Also:
    getTableName()
  - containsRange
```
public boolean containsRange(byte[] rangeStartKey,
                    byte[] rangeEndKey)
```
    Returns true if the given inclusive range of rows is fully contained by this region. For example, if the region is foo,a,g and this is passed ["b","c"] or ["a","c"] it will return true, but if this is passed ["b","z"] it will return false.
    
    Throws:
    
    IllegalArgumentException - if the range passed is invalid (ie. end < start)
  - containsRow
```
public boolean containsRow(byte[] row)
```
    Return true if the given row falls in this region.
  - isMetaTable
```
public boolean isMetaTable()
```
    Returns:
    true if this region is from hbase:meta
  - isMetaRegion
```
public boolean isMetaRegion()
```
    Returns:
    true if this region is a meta region
  - isSystemTable
```
public boolean isSystemTable()
```
    Returns:
    true if this region is from a system table
  - isSplit
```
public boolean isSplit()
```
    Returns:
    True if has been split and has daughters.
  - setSplit
```
public void setSplit(boolean split)
```
    Parameters:
    split - set split status
  - isOffline
```
public boolean isOffline()
```
    Returns:
    True if this region is offline.
  - setOffline
```
public void setOffline(boolean offLine)
```
    The parent of a region split is offline while split daughters hold references to the parent. Offlined regions are closed.
    
    Parameters:
    offLine - Set online/offline status.
  - isSplitParent
```
public boolean isSplitParent()
```
    Returns:
    True if this is a split parent region.
  - getReplicaId
```
public int getReplicaId()
```
    Returns the region replica id
    
    Returns:
    returns region replica id
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
    
    See Also:
    Object.toString()
  - equals
```
public boolean equals(Object o)
```
    Overrides:
    
    equals in class Object
    
    See Also:
    Object.equals(java.lang.Object)
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
    
    See Also:
    Object.hashCode()
  - getVersion
```
@Deprecated
public byte getVersion()
```
    Deprecated. HRI is no longer a VersionedWritable
    
    Returns:
    the object version number
  - write
```
@Deprecated
public void write(DataOutput out)
           throws IOException
```
    Deprecated. Use protobuf serialization instead. See toByteArray() and toDelimitedByteArray()
    
    Throws:
    
    IOException
  - readFields
```
@Deprecated
public void readFields(DataInput in)
                throws IOException
```
    Deprecated. Use protobuf deserialization instead.
    
    Throws:
    
    IOException
    See Also:
    parseFrom(byte[])
  - readFields
```
@Deprecated
private void readFields(byte[] bytes,
                         int offset,
                         int len)
                 throws IOException
```
    Deprecated.
    
    Throws:
    
    IOException
  - compareTo
```
public int compareTo(HRegionInfo o)
```
    Specified by:
    
    compareTo in interface Comparable<HRegionInfo>
  - getComparator
```
public KeyValue.KVComparator getComparator()
```
    Returns:
    Comparator to use comparing KeyValues.
  - convert
```
org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.RegionInfo convert()
```
    Convert a HRegionInfo to the protobuf RegionInfo
    
    Returns:
    the converted RegionInfo
  - convert
```
public static org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.RegionInfo convert(HRegionInfo info)
```
    Convert a HRegionInfo to a RegionInfo
    
    Parameters:
    info - the HRegionInfo to convert
    
    Returns:
    the converted RegionInfo
  - convert
```
public static HRegionInfo convert(org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.RegionInfo proto)
```
    Convert a RegionInfo to a HRegionInfo
    
    Parameters:
    proto - the RegionInfo to convert
    
    Returns:
    the converted HRegionInfho
  - toByteArray
```
public byte[] toByteArray()
```
    Returns:
    This instance serialized as protobuf w/ a magic pb prefix.
    See Also:
    parseFrom(byte[])
  - parseFromOrNull
```
public static HRegionInfo parseFromOrNull(byte[] bytes)
```
    Returns:
    A deserialized HRegionInfo or null if we failed deserialize or passed bytes null
    See Also:
    toByteArray()
  - parseFromOrNull
```
public static HRegionInfo parseFromOrNull(byte[] bytes,
                          int offset,
                          int len)
```
    Returns:
    A deserialized HRegionInfo or null if we failed deserialize or passed bytes null
    See Also:
    toByteArray()
  - parseFrom
```
public static HRegionInfo parseFrom(byte[] bytes)
                             throws DeserializationException
```
    Parameters:
    bytes - A pb RegionInfo serialized with a pb magic prefix.
    
    Returns:
    A deserialized HRegionInfo
    
    Throws:
    
    DeserializationException
    See Also:
    toByteArray()
  - parseFrom
```
public static HRegionInfo parseFrom(byte[] bytes,
                    int offset,
                    int len)
                             throws DeserializationException
```
    Parameters:
    bytes - A pb RegionInfo serialized with a pb magic prefix.
    offset - starting point in the byte array
    len - length to read on the byte array
    
    Returns:
    A deserialized HRegionInfo
    
    Throws:
    
    DeserializationException
    See Also:
    toByteArray()
  - toDelimitedByteArray
```
public byte[] toDelimitedByteArray()
                            throws IOException
```
    Use this instead of toByteArray() when writing to a stream and you want to use the pb mergeDelimitedFrom (w/o the delimiter, pb reads to EOF which may not be what you want).
    
    Returns:
    This instance serialized as a delimited protobuf w/ a magic pb prefix.
    
    Throws:
    
    IOException
    See Also:
    toByteArray()
  - getHRegionInfoAndServerName
```
@Deprecated
public static Pair<HRegionInfo,ServerName> getHRegionInfoAndServerName(Result r)
```
    Deprecated. use MetaTableAccessor methods for interacting with meta layouts
    
    Extract a HRegionInfo and ServerName from catalog table Result.
    
    Parameters:
    r - Result to pull from
    
    Returns:
    A pair of the HRegionInfo and the ServerName (or null for server address if no address set in hbase:meta).
  - getHRegionInfo
```
@Deprecated
public static HRegionInfo getHRegionInfo(Result data)
```
    Deprecated. use MetaTableAccessor methods for interacting with meta layouts
    
    Returns HRegionInfo object from the column HConstants.CATALOG_FAMILY:HConstants.REGIONINFO_QUALIFIER of the catalog table Result.
    
    Parameters:
    data - a Result object from the catalog table scan
    
    Returns:
    HRegionInfo or null
  - getDaughterRegions
```
@Deprecated
public static PairOfSameType<HRegionInfo> getDaughterRegions(Result data)
                                                      throws IOException
```
    Deprecated. use MetaTableAccessor methods for interacting with meta layouts
    
    Returns the daughter regions by reading the corresponding columns of the catalog table Result.
    
    Parameters:
    data - a Result object from the catalog table scan
    
    Returns:
    a pair of HRegionInfo or PairOfSameType(null, null) if the region is not a split parent
    
    Throws:
    
    IOException
  - getMergeRegions
```
@Deprecated
public static PairOfSameType<HRegionInfo> getMergeRegions(Result data)
                                                   throws IOException
```
    Deprecated. use MetaTableAccessor methods for interacting with meta layouts
    
    Returns the merge regions by reading the corresponding columns of the catalog table Result.
    
    Parameters:
    data - a Result object from the catalog table scan
    
    Returns:
    a pair of HRegionInfo or PairOfSameType(null, null) if the region is not a split parent
    
    Throws:
    
    IOException
  - getHRegionInfo
```
@Deprecated
public static HRegionInfo getHRegionInfo(Result r,
                                    byte[] qualifier)
```
    Deprecated. use MetaTableAccessor methods for interacting with meta layouts
    
    Returns the HRegionInfo object from the column HConstants.CATALOG_FAMILY and qualifier of the catalog table result.
    
    Parameters:
    r - a Result object from the catalog table scan
    qualifier - Column family qualifier -- either HConstants.SPLITA_QUALIFIER, HConstants.SPLITB_QUALIFIER or HConstants.REGIONINFO_QUALIFIER.
    
    Returns:
    An HRegionInfo instance or null.
  - getServerName
```
@Deprecated
public static ServerName getServerName(Result r)
```
    Deprecated. use MetaTableAccessor methods for interacting with meta layouts
  - getSeqNumDuringOpen
```
@Deprecated
public static long getSeqNumDuringOpen(Result r)
```
    Deprecated. use MetaTableAccessor methods for interacting with meta layouts
    
    The latest seqnum that the server writing to meta observed when opening the region. E.g. the seqNum when the result of getServerName(Result) was written.
    
    Parameters:
    r - Result to pull the seqNum from
    
    Returns:
    SeqNum, or HConstants.NO_SEQNUM if there's no value written.
  - parseFrom
```
public static HRegionInfo parseFrom(DataInputStream in)
                             throws IOException
```
    Parses an HRegionInfo instance from the passed in stream. Presumes the HRegionInfo was serialized to the stream with toDelimitedByteArray()
    
    Parameters:
    in -
    
    Returns:
    An instance of HRegionInfo.
    
    Throws:
    
    IOException
  - toDelimitedByteArray
```
public static byte[] toDelimitedByteArray(HRegionInfo... infos)
                                   throws IOException
```
    Serializes given HRegionInfo's as a byte array. Use this instead of toByteArray() when writing to a stream and you want to use the pb mergeDelimitedFrom (w/o the delimiter, pb reads to EOF which may not be what you want). parseDelimitedFrom(byte[], int, int) can be used to read back the instances.
    
    Parameters:
    infos - HRegionInfo objects to serialize
    
    Returns:
    This instance serialized as a delimited protobuf w/ a magic pb prefix.
    
    Throws:
    
    IOException
    See Also:
    toByteArray()
  - parseDelimitedFrom
```
public static List<HRegionInfo> parseDelimitedFrom(byte[] bytes,
                                   int offset,
                                   int length)
                                            throws IOException
```
    Parses all the HRegionInfo instances from the passed in stream until EOF. Presumes the HRegionInfo's were serialized to the stream with toDelimitedByteArray()
    
    Parameters:
    bytes - serialized bytes
    offset - the start offset into the byte[] buffer
    length - how far we should read into the byte[] buffer
    
    Returns:
    All the hregioninfos that are in the byte array. Keeps reading till we hit the end.
    
    Throws:
    
    IOException
  - areAdjacent
```
public static boolean areAdjacent(HRegionInfo regionA,
                  HRegionInfo regionB)
```
    Check whether two regions are adjacent
    
    Parameters:
    regionA -
    regionB -
    
    Returns:
    true if two regions are adjacent

Class HRegionInfo

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

VERSION

LOG

ENC_SEPARATOR

MD5_HEX_LENGTH

ENCODED_REGION_NAME_REGEX

REPLICA_ID_FORMAT

REPLICA_ID_DELIMITER

MAX_REPLICA_ID

DEFAULT_REPLICA_ID

INVALID_REGION_NAME_FORMAT_MESSAGE

endKey

offLine

regionId

regionName

split

startKey

hashCode

NO_HASH

encodedName

encodedNameAsBytes

replicaId

tableName

FIRST_META_REGIONINFO

Constructor Detail

HRegionInfo

HRegionInfo

HRegionInfo

HRegionInfo

HRegionInfo

HRegionInfo

HRegionInfo

HRegionInfo

HRegionInfo

HRegionInfo

Method Detail

hasEncodedName

encodeRegionName

getShortNameToLog

prettyPrint

setHashCode

createRegionName

createRegionName

createRegionName

createRegionName

createRegionName

getTableName

getTable

getStartKey

parseRegionName

getRegionId

getRegionName

getRegionNameAsString

getEncodedName

getEncodedNameAsBytes

getStartKey

getEndKey

getTableName

getTable

containsRange

containsRow

isMetaTable

isMetaRegion

isSystemTable

isSplit

setSplit

isOffline

setOffline

isSplitParent

getReplicaId

toString

equals

hashCode

getVersion

write