Package org.apache.hadoop.hdfs.protocol

Class DatanodeID

java.lang.Object

org.apache.hadoop.hdfs.protocol.DatanodeID

All Implemented Interfaces:

java.lang.Comparable<DatanodeID>

Direct Known Subclasses:

DatanodeInfo

@Private
@Evolving
public class DatanodeID
extends java.lang.Object
implements java.lang.Comparable<DatanodeID>

This class represents the primary identifier for a Datanode. Datanodes are identified by how they can be contacted (hostname and ports) and their storage ID, a unique number that associates the Datanodes blocks with a particular Datanode. DatanodeInfo.getName() should be used to get the network location (for topology) of a datanode, instead of using getXferAddr() here. Helpers are defined below for each context in which a DatanodeID is used.

Field Summary

Fields

Modifier and Type	Field	Description
static DatanodeID[]	EMPTY_ARRAY
static DatanodeID	EMPTY_DATANODE_ID

Constructor Summary

Constructors

Constructor	Description
DatanodeID(java.lang.String ipAddr, java.lang.String hostName, java.lang.String datanodeUuid, int xferPort, int infoPort, int infoSecurePort, int ipcPort)	Create a DatanodeID
DatanodeID(java.lang.String datanodeUuid, DatanodeID from)
DatanodeID(DatanodeID from)

Method Summary

Modifier and Type	Method	Description
int	compareTo(DatanodeID that)	Compare based on data transfer address.
boolean	equals(java.lang.Object to)
java.lang.String	getDatanodeUuid()
org.apache.hadoop.thirdparty.protobuf.ByteString	getDatanodeUuidBytes()
java.lang.String	getHostName()
org.apache.hadoop.thirdparty.protobuf.ByteString	getHostNameBytes()
java.lang.String	getInfoAddr()
int	getInfoPort()
java.lang.String	getInfoSecureAddr()
int	getInfoSecurePort()
java.lang.String	getIpAddr()
org.apache.hadoop.thirdparty.protobuf.ByteString	getIpAddrBytes()
java.lang.String	getIpcAddr(boolean useHostname)
int	getIpcPort()
java.lang.String	getPeerHostName()
java.net.InetSocketAddress	getResolvedAddress()
java.lang.String	getXferAddr()
java.lang.String	getXferAddr(boolean useHostname)
java.lang.String	getXferAddrWithHostname()
int	getXferPort()
int	hashCode()
void	setIpAddr(java.lang.String ipAddr)
void	setPeerHostName(java.lang.String peerHostName)
java.lang.String	toString()
void	updateRegInfo(DatanodeID nodeReg)	Update fields when a new registration request comes in.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

EMPTY_ARRAY

public static final DatanodeID[] EMPTY_ARRAY

EMPTY_DATANODE_ID

public static final DatanodeID EMPTY_DATANODE_ID

Constructor Detail

DatanodeID

public DatanodeID(DatanodeID from)

DatanodeID

@VisibleForTesting
public DatanodeID(java.lang.String datanodeUuid,
                  DatanodeID from)

DatanodeID

public DatanodeID(java.lang.String ipAddr,
                  java.lang.String hostName,
                  java.lang.String datanodeUuid,
                  int xferPort,
                  int infoPort,
                  int infoSecurePort,
                  int ipcPort)

Create a DatanodeID

Parameters:

ipAddr - IP

hostName - hostname

datanodeUuid - data node ID, UUID for new Datanodes, may be the storage ID for pre-UUID datanodes. NULL if unknown e.g. if this is a new datanode. A new UUID will be assigned by the namenode.

xferPort - data transfer port

infoPort - info server port

ipcPort - ipc server port

Method Detail

setIpAddr

public void setIpAddr(java.lang.String ipAddr)

setPeerHostName

public void setPeerHostName(java.lang.String peerHostName)

getDatanodeUuid

public java.lang.String getDatanodeUuid()

Returns:

data node ID.

getDatanodeUuidBytes

public org.apache.hadoop.thirdparty.protobuf.ByteString getDatanodeUuidBytes()

getIpAddr

public java.lang.String getIpAddr()

Returns:

ipAddr;

getIpAddrBytes

public org.apache.hadoop.thirdparty.protobuf.ByteString getIpAddrBytes()

getHostName

public java.lang.String getHostName()

Returns:

hostname

getHostNameBytes

public org.apache.hadoop.thirdparty.protobuf.ByteString getHostNameBytes()

getPeerHostName

public java.lang.String getPeerHostName()

Returns:

hostname from the actual connection

getXferAddr

public java.lang.String getXferAddr()

Returns:

IP:xferPort string

getInfoAddr

public java.lang.String getInfoAddr()

Returns:

IP:infoPort string

getInfoSecureAddr

public java.lang.String getInfoSecureAddr()

Returns:

IP:infoPort string

getXferAddrWithHostname

public java.lang.String getXferAddrWithHostname()

Returns:

hostname:xferPort

getXferAddr

public java.lang.String getXferAddr(boolean useHostname)

Parameters:

useHostname - true to use the DN hostname, use the IP otherwise

Returns:

name:xferPort

getIpcAddr

public java.lang.String getIpcAddr(boolean useHostname)

Parameters:

useHostname - true to use the DN hostname, use the IP otherwise

Returns:

name:ipcPort

getXferPort

public int getXferPort()

Returns:

xferPort (the port for data streaming)

getInfoPort

public int getInfoPort()

Returns:

infoPort (the port at which the HTTP server bound to)

getInfoSecurePort

public int getInfoSecurePort()

Returns:

infoSecurePort (the port at which the HTTPS server bound to)

getIpcPort

public int getIpcPort()

Returns:

ipcPort (the port at which the IPC server bound to)

equals

public boolean equals(java.lang.Object to)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

updateRegInfo

public void updateRegInfo(DatanodeID nodeReg)

Update fields when a new registration request comes in. Note that this does not update storageID.

compareTo

public int compareTo(DatanodeID that)

Compare based on data transfer address.

Specified by:

compareTo in interface java.lang.Comparable<DatanodeID>

Parameters:

that - datanode to compare with

Returns:

as specified by Comparable

getResolvedAddress

public java.net.InetSocketAddress getResolvedAddress()