org.dataone.client

Class NodeLocator

java.lang.Object

org.dataone.client.NodeLocator

Direct Known Subclasses:

NodeListNodeLocator, NodeListNodeLocator

public abstract class NodeLocator
extends Object

An abstract Service Locator class to resolve NodeReferences into MNode or CNode objects. In the standard implementation, the NodeLocator would populate its nodes from a cn.NodeList call.

Author:

rnahf

Field Summary

Fields

Modifier and Type	Field and Description
protected Map<NodeReference,D1Node>	nodeMap this property can be re-initialized by concrete subclasses

Constructor Summary

Constructors

Constructor and Description
NodeLocator()

Method Summary

Modifier and Type	Method and Description
abstract D1Node	getCNode() This method should return the favored CNode, so that a CN can be obtained without NodeReference or serviceBaseUrl.
D1Node	getNode(NodeReference nodeReference) Return a Node associated with the nodeReference parameter, or throw a ClientSideException
D1Node	getNode(String baseUrl) Return a node associated with the baseUrl parameter, or throw a ClientSideException
Set<NodeReference>	listD1Nodes() Returns the set of NodeReferences in the NodeLocator
Set<NodeReference>	listD1Nodes(NodeType nodeType) Returns the set of NodeReferences of D1Nodes matching the nodeType parameter
void	putNode(NodeReference nodeRef, D1Node node) Puts a constructed node into the NodeLocator.

Methods inherited from class java.lang.Object

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

Field Detail

nodeMap

protected Map<NodeReference,D1Node> nodeMap

this property can be re-initialized by concrete subclasses

Constructor Detail

NodeLocator

public NodeLocator()

Method Detail

putNode

public void putNode(NodeReference nodeRef,
                    D1Node node)

Puts a constructed node into the NodeLocator.

Parameters:

nodeRef -

node -

getNode

public D1Node getNode(NodeReference nodeReference)
               throws ClientSideException

Return a Node associated with the nodeReference parameter, or throw a ClientSideException

Parameters:

nodeReference -

Returns:

Throws:

ClientSideException

getNode

public D1Node getNode(String baseUrl)
               throws ClientSideException

Return a node associated with the baseUrl parameter, or throw a ClientSideException

Parameters:

baseUrl -

Returns:

Throws:

ClientSideException

listD1Nodes

public Set<NodeReference> listD1Nodes()

Returns the set of NodeReferences in the NodeLocator

Returns:

listD1Nodes

public Set<NodeReference> listD1Nodes(NodeType nodeType)

Returns the set of NodeReferences of D1Nodes matching the nodeType parameter

Parameters:

nodeType -

Returns:

getCNode

public abstract D1Node getCNode()
                         throws ClientSideException

This method should return the favored CNode, so that a CN can be obtained without NodeReference or serviceBaseUrl. If none can be determined, a ClientSideException should be thrown.

Returns:

Throws:

ClientSideException