org.dataone.client

Class D1Client

java.lang.Object

org.dataone.client.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.

Constructor Summary

Constructors

Constructor and Description
D1Client()

Method Summary

Methods

Modifier and Type	Method and Description
static Identifier	archive(Session session, D1Object d1object) Perform an archive on an object in DataONE with the given D1Object on the authoritativeMemberNode contained in its systemMetadata.
static Identifier	create(Session session, D1Object d1object) Attempts to create the given D1Object on the originMemberNode contained in its SystemMetadata.
static CNode	getCN() Get the client instance of the Coordinating Node object for calling Coordinating Node services.
static CNode	getCN(Session session) Get the client instance of the Coordinating Node object for calling Coordinating Node services.
static MNode	getMN(NodeReference nodeRef) Construct and return a Member Node using the nodeReference for the member node.
static MNode	getMN(String mnBaseUrl) Construct and return a Member Node using the base service URL for the node.
static ObsoletesChain	listUpdateHistory(Identifier pid) Return the full ObsoletesChain for the given Identifier.
static Identifier	update(Session session, D1Object d1object) Perform an update an object in DataONE with the given D1Object on the originMemberNode contained in its systemMetadata.

Methods inherited from class java.lang.Object

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

Constructor Detail

D1Client

public D1Client()

Method Detail

getCN

public static CNode getCN(Session session)
                   throws ServiceFailure

Get the client instance of the Coordinating Node 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. 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

getCN

public static CNode getCN()
                   throws ServiceFailure

Get the client instance of the Coordinating Node 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. See org.dataone.configuration.Settings class for details. Connects using the default session / certificate

Returns:

the cn

Throws:

ServiceFailure

getMN

public static MNode getMN(String mnBaseUrl)

Construct and return 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

getMN

public static MNode getMN(NodeReference nodeRef)
                   throws ServiceFailure

Construct and return a Member Node 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

create

public static Identifier create(Session session,
                D1Object d1object)
                         throws InvalidToken,
                                ServiceFailure,
                                NotAuthorized,
                                IdentifierNotUnique,
                                UnsupportedType,
                                InsufficientResources,
                                InvalidSystemMetadata,
                                NotImplemented,
                                InvalidRequest

Attempts to create the given D1Object on the originMemberNode contained in its SystemMetadata. Does not perform any identifier reservation checks or make any reservations.

Parameters:

session -

d1object - - the d1object representing both the data bytes and systemMetadata

Returns:

the Identifier returned from the mn.create call

Throws:

InvalidToken

ServiceFailure

NotAuthorized

IdentifierNotUnique

UnsupportedType

InsufficientResources

InvalidSystemMetadata

NotImplemented

InvalidRequest

update

public static Identifier update(Session session,
                D1Object d1object)
                         throws InvalidToken,
                                ServiceFailure,
                                NotAuthorized,
                                IdentifierNotUnique,
                                UnsupportedType,
                                InsufficientResources,
                                InvalidSystemMetadata,
                                NotImplemented,
                                InvalidRequest,
                                NotFound

Perform an update an object in DataONE with the given D1Object on the originMemberNode contained in its systemMetadata. For this operation to work, the D1Object's systemMetadata needs have the obsoletes field set with the object to be updated, and the originMemberNode needs to match the authoritativeMemberNode of the object being updated. As with D1Client.create(), this method does not perform any identifier reservation checks or make any reservations.

Parameters:

session -

d1object - - the d1object representing both the data bytes and systemMetadata

Returns:

the Identifier returned from the mn.create call

Throws:

InvalidToken

ServiceFailure

NotAuthorized

IdentifierNotUnique

UnsupportedType

InsufficientResources

InvalidSystemMetadata

NotImplemented

InvalidRequest

NotFound

Since:

v1.2

archive

public static Identifier archive(Session session,
                 D1Object d1object)
                          throws InvalidToken,
                                 ServiceFailure,
                                 NotAuthorized,
                                 NotFound,
                                 NotImplemented,
                                 InvalidRequest

Perform an archive on an object in DataONE with the given D1Object on the authoritativeMemberNode contained in its systemMetadata.

Parameters:

session -

d1object - - the d1object representing both the data bytes and systemMetadata

Returns:

the Identifier returned from the mn.archive call

Throws:

InvalidToken

ServiceFailure

NotAuthorized

NotImplemented

InvalidRequest

NotFound

Since:

v1.2

listUpdateHistory

public static ObsoletesChain listUpdateHistory(Identifier pid)
                                        throws InvalidToken,
                                               ServiceFailure,
                                               NotAuthorized,
                                               NotFound,
                                               NotImplemented

Return the full ObsoletesChain for the given Identifier. Includes predecessors and antecedents.

Parameters:

pid -

Returns:

a complete ObsoletesChain

Throws:

InvalidToken

ServiceFailure

NotAuthorized

NotFound

NotImplemented

Since:

v1.2