Package org.apache.hadoop.net

Class NodeBase

java.lang.Object

org.apache.hadoop.net.NodeBase

All Implemented Interfaces:

Node

Direct Known Subclasses:

InnerNodeImpl

@LimitedPrivate({"HDFS","MapReduce"})
@Unstable
public class NodeBase
extends Object
implements Node

A base class that implements interface Node

Field Summary

Fields

Modifier and Type	Field	Description
protected int	level
protected String	location
protected String	name
protected Node	parent
static final char	PATH_SEPARATOR	Path separator '/'
static final String	PATH_SEPARATOR_STR	Path separator as a string "/"
static final String	ROOT	string representation of root ""

Constructor Summary

Constructors

Constructor	Description
NodeBase()	Default constructor
NodeBase(String path)	Construct a node from its path
NodeBase(String name, String location)	Construct a node from its name and its location
NodeBase(String name, String location, Node parent, int level)	Construct a node from its name and its location

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object to)
int	getLevel()
String	getName()
String	getNetworkLocation()
Node	getParent()
static String	getPath(Node node)	Get the path of a node
static String[]	getPathComponents(Node node)	Get the path components of a node.
int	hashCode()
static int	locationToDepth(String location)
static String	normalize(String path)	Normalize a path by stripping off any trailing PATH_SEPARATOR
void	setLevel(int level)	Set this node's level in the tree
void	setNetworkLocation(String location)	Set this node's network location
void	setParent(Node parent)	Set this node's parent
String	toString()

Methods inherited from class java.lang.Object

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

Field Details

PATH_SEPARATOR

public static final char PATH_SEPARATOR

Path separator '/'

See Also:

• Constant Field Values

PATH_SEPARATOR_STR

public static final String PATH_SEPARATOR_STR

Path separator as a string "/"

See Also:

• Constant Field Values

ROOT

public static final String ROOT

string representation of root ""

See Also:

• Constant Field Values

name

protected String name

location

protected String location

level

protected int level

parent

protected Node parent

Constructor Details

NodeBase

public NodeBase()

Default constructor

NodeBase

public NodeBase(String path)

Construct a node from its path

Parameters:

path - a concatenation of this node's location, the path separator, and its name

NodeBase

public NodeBase(String name,
 String location)

Construct a node from its name and its location

Parameters:

name - this node's name (can be null, must not contain PATH_SEPARATOR)

location - this node's location

NodeBase

public NodeBase(String name,
 String location,
 Node parent,
 int level)

Construct a node from its name and its location

Parameters:

name - this node's name (can be null, must not contain PATH_SEPARATOR)

location - this node's location

parent - this node's parent node

level - this node's level in the tree

Method Details

getName

public String getName()

Specified by:

getName in interface Node

Returns:

this node's name

getNetworkLocation

public String getNetworkLocation()

Specified by:

getNetworkLocation in interface Node

Returns:

this node's network location

setNetworkLocation

public void setNetworkLocation(String location)

Set this node's network location

Specified by:

setNetworkLocation in interface Node

Parameters:

location - the location

getPath

public static String getPath(Node node)

Get the path of a node

Parameters:

node - a non-null node

Returns:

the path of a node

getPathComponents

public static String[] getPathComponents(Node node)

Get the path components of a node.

Parameters:

node - a non-null node

Returns:

the path of a node

equals

public boolean equals(Object to)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

Returns:

this node's path as its string representation

normalize

public static String normalize(String path)

Normalize a path by stripping off any trailing PATH_SEPARATOR

Parameters:

path - path to normalize.

Returns:

the normalised path If pathis null or empty ROOT is returned

Throws:

IllegalArgumentException - if the first character of a non empty path is not PATH_SEPARATOR

getParent

public Node getParent()

Specified by:

getParent in interface Node

Returns:

this node's parent

setParent

public void setParent(Node parent)

Set this node's parent

Specified by:

setParent in interface Node

Parameters:

parent - the parent

getLevel

public int getLevel()

Specified by:

getLevel in interface Node

Returns:

this node's level in the tree. E.g. the root of a tree returns 0 and its children return 1

setLevel

public void setLevel(int level)

Set this node's level in the tree

Specified by:

setLevel in interface Node

Parameters:

level - the level

locationToDepth

public static int locationToDepth(String location)