ServerName (Apache HBase 2.4.0 API)

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

All Implemented Interfaces:

Serializable, Comparable<ServerName>
```
@InterfaceAudience.Public
public class ServerName
extends Object
implements Comparable<ServerName>, Serializable
```
Name of a particular incarnation of an HBase Server. A ServerName is used uniquely identifying a server instance in a cluster and is made of the combination of hostname, port, and startcode. The startcode distinguishes restarted servers on same hostname and port (startcode is usually timestamp of server startup). The toString() format of ServerName is safe to use in the filesystem and as znode name up in ZooKeeper. Its format is: <hostname> 'SERVERNAME_SEPARATOR' <port> 'SERVERNAME_SEPARATOR' <startcode>. For example, if hostname is www.example.org, port is 1234, and the startcode for the regionserver is 1212121212, then the toString() would be www.example.org,1234,1212121212.
You can obtain a versioned serialized form of this class by calling getVersionedBytes(). To deserialize, call parseVersionedServerName(byte[]).
Use getAddress() to obtain the Server hostname + port (Endpoint/Socket Address).
Immutable.

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static List<ServerName>`	`EMPTY_SERVER_LIST`
`static int`	`NON_STARTCODE` What to use if no startcode supplied.
`static Pattern`	`SERVERNAME_PATTERN`
`static String`	`SERVERNAME_SEPARATOR` This character is used as separator between server hostname, port and startcode.
`static String`	`UNKNOWN_SERVERNAME` What to use if server name is unknown.

Constructor Summary

Constructors
Modifier Constructor and Description

protected ServerName(String hostname, int port, long startcode)

Constructors
Modifier	Constructor and Description
`protected`	`ServerName(String hostname, int port, long startcode)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`int`	`compareTo(ServerName other)`
`boolean`	`equals(Object o)`
`Address`	`getAddress()`
`String`	`getHostAndPort()` Deprecated. Since 2.0. Use `getAddress()` instead.
`String`	`getHostname()`
`String`	`getHostnameLowerCase()`
`int`	`getPort()`
`String`	`getServerName()`
`static String`	`getServerName(String hostAndPort, long startcode)` Deprecated. Since 2.0. Use `valueOf(String, long)` instead.
`static String`	`getServerNameLessStartCode(String inServerName)` Deprecated. Since 2.0. Use `getAddress()`
`static long`	`getServerStartcodeFromServerName(String serverName)` Deprecated. Since 2.0. Use instance of ServerName to pull out start code.
`long`	`getStartcode()`
`byte[]`	`getVersionedBytes()`
`int`	`hashCode()`
`static boolean`	`isFullServerName(String str)`
`static boolean`	`isSameAddress(ServerName left, ServerName right)`
`static String`	`parseHostname(String serverName)` Deprecated. Since 2.0. Use `valueOf(String)`
`static int`	`parsePort(String serverName)` Deprecated. Since 2.0. Use `valueOf(String)`
`static ServerName`	`parseServerName(String str)`
`static long`	`parseStartcode(String serverName)` Deprecated. Since 2.0. Use `valueOf(String)`
`static ServerName`	`parseVersionedServerName(byte[] versionedBytes)` Use this method instantiating a `ServerName` from bytes gotten from a call to `getVersionedBytes()`.
`String`	`toShortString()`
`String`	`toString()`
`static ServerName`	`valueOf(String serverName)` Retrieve an instance of ServerName.
`static ServerName`	`valueOf(String hostname, int port, long startcode)` Retrieve an instance of ServerName.
`static ServerName`	`valueOf(String hostAndPort, long startCode)` Retrieve an instance of ServerName.

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

- Field Detail
  - NON_STARTCODE
```
public static final int NON_STARTCODE
```
    What to use if no startcode supplied.
    
    See Also:
    
    Constant Field Values
  - SERVERNAME_SEPARATOR
```
public static final String SERVERNAME_SEPARATOR
```
    This character is used as separator between server hostname, port and startcode.
    
    See Also:
    
    Constant Field Values
  - SERVERNAME_PATTERN
```
public static final Pattern SERVERNAME_PATTERN
```
  - UNKNOWN_SERVERNAME
```
public static final String UNKNOWN_SERVERNAME
```
    What to use if server name is unknown.
    
    See Also:
    
    Constant Field Values
  - EMPTY_SERVER_LIST
```
public static final List<ServerName> EMPTY_SERVER_LIST
```
- Constructor Detail
  - ServerName
```
protected ServerName(String hostname,
                     int port,
                     long startcode)
```
- Method Detail
  - parseHostname
```
@Deprecated
public static String parseHostname(String serverName)
```
    Deprecated. Since 2.0. Use valueOf(String)
  - parsePort
```
@Deprecated
public static int parsePort(String serverName)
```
    Deprecated. Since 2.0. Use valueOf(String)
  - parseStartcode
```
@Deprecated
public static long parseStartcode(String serverName)
```
    Deprecated. Since 2.0. Use valueOf(String)
  - valueOf
```
public static ServerName valueOf(String hostname,
                                 int port,
                                 long startcode)
```
    Retrieve an instance of ServerName. Callers should use the equals method to compare returned instances, though we may return a shared immutable object as an internal optimization.
  - valueOf
```
public static ServerName valueOf(String serverName)
```
    Retrieve an instance of ServerName. Callers should use the equals method to compare returned instances, though we may return a shared immutable object as an internal optimization.
  - valueOf
```
public static ServerName valueOf(String hostAndPort,
                                 long startCode)
```
    Retrieve an instance of ServerName. Callers should use the equals method to compare returned instances, though we may return a shared immutable object as an internal optimization.
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - toShortString
```
public String toShortString()
```
    Returns:
    
    Return a SHORT version of toString(), one that has the host only, minus the domain, and the port only -- no start code; the String is for us internally mostly tying threads to their server. Not for external use. It is lossy and will not work in in compares, etc.
  - getVersionedBytes
```
public byte[] getVersionedBytes()
```
    Returns:
    
    getServerName() as bytes with a short-sized prefix with the ServerName#VERSION of this class.
  - getServerName
```
public String getServerName()
```
  - getHostname
```
public String getHostname()
```
  - getHostnameLowerCase
```
public String getHostnameLowerCase()
```
  - getPort
```
public int getPort()
```
  - getStartcode
```
public long getStartcode()
```
  - getServerName
```
@Deprecated
public static String getServerName(String hostAndPort,
                                               long startcode)
```
    Deprecated. Since 2.0. Use valueOf(String, long) instead.
    
    Parameters:
    
    hostAndPort - String in form of <hostname> ':' <port>
    
    startcode -
    
    Returns:
    
    Server name made of the concatenation of hostname, port and startcode formatted as <hostname> ',' <port> ',' <startcode>
  - getHostAndPort
```
@Deprecated
public String getHostAndPort()
```
    Deprecated. Since 2.0. Use getAddress() instead.
    
    Returns:
    
    Hostname and port formatted as described at Addressing.createHostAndPortStr(String, int)
  - getAddress
```
public Address getAddress()
```
  - getServerStartcodeFromServerName
```
@Deprecated
public static long getServerStartcodeFromServerName(String serverName)
```
    Deprecated. Since 2.0. Use instance of ServerName to pull out start code.
    
    Parameters:
    
    serverName - ServerName in form specified by getServerName()
    
    Returns:
    
    The server start code parsed from servername
  - getServerNameLessStartCode
```
@Deprecated
public static String getServerNameLessStartCode(String inServerName)
```
    Deprecated. Since 2.0. Use getAddress()
    
    Utility method to excise the start code from a server name
    
    Parameters:
    
    inServerName - full server name
    
    Returns:
    
    server name less its start code
  - compareTo
```
public int compareTo(ServerName other)
```
    Specified by:
    
    compareTo in interface Comparable<ServerName>
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - equals
```
public boolean equals(Object o)
```
    Overrides:
    
    equals in class Object
  - isSameAddress
```
public static boolean isSameAddress(ServerName left,
                                    ServerName right)
```
    Parameters:
    
    left -
    
    right -
    
    Returns:
    
    True if other has same hostname and port.
  - parseVersionedServerName
```
public static ServerName parseVersionedServerName(byte[] versionedBytes)
```
    Use this method instantiating a ServerName from bytes gotten from a call to getVersionedBytes(). Will take care of the case where bytes were written by an earlier version of hbase.
    
    Parameters:
    
    versionedBytes - Pass bytes gotten from a call to getVersionedBytes()
    
    Returns:
    
    A ServerName instance.
    
    See Also:
    
    getVersionedBytes()
  - parseServerName
```
public static ServerName parseServerName(String str)
```
    Parameters:
    
    str - Either an instance of toString() or a "'<hostname>' ':' '<port>'".
    
    Returns:
    
    A ServerName instance.
  - isFullServerName
```
public static boolean isFullServerName(String str)
```
    Returns:
    
    true if the String follows the pattern of toString(), false otherwise.

Class ServerName

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

NON_STARTCODE

SERVERNAME_SEPARATOR

SERVERNAME_PATTERN

UNKNOWN_SERVERNAME

EMPTY_SERVER_LIST

Constructor Detail

ServerName

Method Detail

parseHostname

parsePort

parseStartcode

valueOf

valueOf

valueOf

toString

toShortString

getVersionedBytes

getServerName

getHostname

getHostnameLowerCase

getPort

getStartcode

getServerName

getHostAndPort

getAddress

getServerStartcodeFromServerName

getServerNameLessStartCode

compareTo

hashCode

equals

isSameAddress

parseVersionedServerName

parseServerName

isFullServerName