org.dataone.client.v2.itk

Class D1Client

java.lang.Object

org.dataone.client.v2.itk.D1Client

public class D1Client
extends Object

The D1Client class represents a client-side implementation of the DataONE Service API. The class exposes the DataONE APIs as client methods, dispatches the calls to the correct DataONE node, and then returns the results or throws the appropriate exceptions.

Field Summary

Fields

Modifier and Type	Field and Description
protected static MultipartRestClient	multipartRestClient

Constructor Summary

Constructors

Constructor and Description
D1Client()

Method Summary

Methods

Modifier and Type	Method and Description
static CNode	getCN() Get the cached CNode object for calling Coordinating Node services.
static CNode	getCN(Session session) Deprecated. broken functionality, and unused. use getCN() or getCN(baseUrl) instead
static CNode	getCN(String cnBaseUrl) Returns a Coordinating Node using the base service URL to look up the node in the existing environment.
static MNode	getMN(NodeReference nodeRef) Return an MNode using the nodeReference for the member node.
static MNode	getMN(String mnBaseUrl) Returns a Member Node using the base service URL for the node.
protected static MultipartRestClient	getMultipartRestClient()
static void	setCN(String cnUrl) Use this method to set the environment via the baseUrl to the environment's Coordinating Node.
static void	setNodeLocator(NodeLocator nodeLocator) For testing, we can override the nodeLocator

Methods inherited from class java.lang.Object

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

Field Detail

multipartRestClient

protected static MultipartRestClient multipartRestClient

Constructor Detail

D1Client

public D1Client()

Method Detail

getMultipartRestClient

protected static MultipartRestClient getMultipartRestClient()
                                                     throws IOException,
                                                            ClientSideException

Throws:

IOException

ClientSideException

setNodeLocator

public static void setNodeLocator(NodeLocator nodeLocator)

For testing, we can override the nodeLocator

Parameters:

nodeLocator -

getCN

public static CNode getCN()
                   throws ServiceFailure,
                          NotImplemented

Get the cached CNode object for calling Coordinating Node services. By default returns the production context CN, defined via the property "D1Client.CN_URL". Use of D1Client in other contexts (non-production) requires overriding or changing this property name, or calling the setCN method. See org.dataone.configuration.Settings class for details. Connects using the default session / certificate

Returns:

the cn

Throws:

ServiceFailure

NotImplemented

getCN

@Deprecated
public static CNode getCN(Session session)
                   throws ServiceFailure,
                          NotImplemented

Deprecated. broken functionality, and unused. use getCN() or getCN(baseUrl) instead

Get the cached CNode object for calling Coordinating Node services. By default returns the production context CN, defined via the property "D1Client.CN_URL". Use of D1Client in other contexts (non-production) requires overriding or changing this property name, or calling the setCN method See org.dataone.configuration.Settings class for details.

Parameters:

session - - the client session to be used in connections, null uses default behavior.

Returns:

the cn

Throws:

ServiceFailure

NotImplemented

setCN

public static void setCN(String cnUrl)
                  throws NotImplemented,
                         ServiceFailure

Use this method to set the environment via the baseUrl to the environment's Coordinating Node. Doing so affects future calls using the NodeReferences - only nodes registered in the context of the current CN will be findable by NodeReference.

Parameters:

cnUrl -

Throws:

NotImplemented

ServiceFailure

getMN

public static MNode getMN(String mnBaseUrl)
                   throws ServiceFailure

Returns a Member Node using the base service URL for the node.

Parameters:

mnBaseUrl - the service URL for the Member Node

Returns:

the mn at a particular URL

Throws:

ServiceFailure

getCN

public static CNode getCN(String cnBaseUrl)
                   throws ServiceFailure

Returns a Coordinating Node using the base service URL to look up the node in the existing environment.

Parameters:

cnBaseUrl -

Returns:

Throws:

ServiceFailure

getMN

public static MNode getMN(NodeReference nodeRef)
                   throws ServiceFailure

Return an MNode using the nodeReference for the member node. D1Client's cn instance will look up the member node's baseURL from the passed in nodeReference

Parameters:

nodeRef -

Returns:

Throws:

ServiceFailure