MNode (DataONE Java Client Library 1.3.0-SNAPSHOT API)

java.lang.Object
- org.dataone.client.D1Node
- - org.dataone.client.MNode

All Implemented Interfaces:

MNCore, MNRead, MNAuthorization, MNStorage, MNReplication, MNQuery
```
public class MNode
extends D1Node
implements MNCore, MNRead, MNAuthorization, MNStorage, MNReplication, MNQuery
```
MNode represents a MemberNode, and exposes the services associated with a DataONE Member Node, allowing calling clients to call the services associated with the node. By necessity, behavior for null values differs slightly from the REST api. Except where noted, null values in method parameters will: 1. throw a NotFound or InvalidRequest exception if the parameter is mapped to the URL path segment 2. omit the url query parameter if the parameter is mapped to a URL query segment 3. throw an InvalidRequest exception if the parameter is mapped to the message body Session objects get passed to the underlying D1RestClient class, but be passed to the httpClient request, as they are pulled from the underlying filesystem of the local machine. Java implementation of the following types: Types.OctectStream - java.io.InputStream unsignedlong - we use long to keep to a native type, although only half capacity of unsigned Types.DateTime - java.util.Date Various methods may set their own timeouts by use of Settings.Configuration properties or by calling setDefaultSoTimeout. Settings.Configuration properties override any value of the DefaultSoTimeout. Timeouts are always represented in milliseconds timeout properties recognized: D1Client.MNode.create.timeout D1Client.MNode.update.timeout D1Client.MNode.replicate.timeout D1Client.MNode.getReplica.timeout D1Client.D1Node.listObjects.timeout D1Client.D1Node.getLogRecords.timeout D1Client.D1Node.get.timeout D1Client.D1Node.getSystemMetadata.timeout

Author:

Rob Nahf

Field Summary

Fields
Modifier and Type Field and Description

protected static org.apache.commons.logging.Log log
- Fields inherited from class org.dataone.client.D1Node
  session
- Fields inherited from interface org.dataone.service.mn.tier1.v1.MNCore
  SERVICE_VERSION

Fields
Modifier and Type	Field and Description
`protected static org.apache.commons.logging.Log`	`log`

Constructor Summary

Constructors
Constructor and Description
`MNode(String nodeBaseServiceUrl)` Construct a new client-side MNode (Member Node) object, passing in the base url of the member node for calling its services.
`MNode(String nodeBaseServiceUrl, Session session)` Construct a new client-side MNode (Member Node) object, passing in the base url of the member node for calling its services, and the Session to use for connections to that node.

Method Summary

Methods
Modifier and Type	Method and Description
`Identifier`	`archive(Identifier pid)` see DataONE API Reference
`Identifier`	`archive(Session session, Identifier pid)` see DataONE API Reference
`Identifier`	`create(Identifier pid, InputStream object, SystemMetadata sysmeta)` see DataONE API Reference
`Identifier`	`create(Session session, Identifier pid, InputStream object, SystemMetadata sysmeta)` see DataONE API Reference
`Identifier`	`delete(Identifier pid)` see DataONE API Reference
`Identifier`	`delete(Session session, Identifier pid)` see DataONE API Reference
`DescribeResponse`	`describe(Identifier pid)` see DataONE API Reference
`DescribeResponse`	`describe(Session session, Identifier pid)` see DataONE API Reference
`Identifier`	`generateIdentifier(Session session, String scheme, String fragment)` see DataONE API Reference
`Identifier`	`generateIdentifier(String scheme, String fragment)` see DataONE API Reference
`InputStream`	`get(Identifier pid)` Get the resource with the specified pid.
`InputStream`	`get(Session session, Identifier pid)` Get the resource with the specified pid.
`Node`	`getCapabilities()` see DataONE API Reference
`Checksum`	`getChecksum(Identifier pid, String checksumAlgorithm)` see DataONE API Reference
`Checksum`	`getChecksum(Session session, Identifier pid, String checksumAlgorithm)` see DataONE API Reference
`Log`	`getLogRecords()` see DataONE API Reference
`Log`	`getLogRecords(Date fromDate, Date toDate, Event event, String pidFilter, Integer start, Integer count)` see DataONE API Reference
`Log`	`getLogRecords(Session session)` see DataONE API Reference
`Log`	`getLogRecords(Session session, Date fromDate, Date toDate, Event event, String pidFilter, Integer start, Integer count)` see DataONE API Reference
`String`	`getNodeBaseServiceUrl()` Retrieve the service URL for this node.
`QueryEngineDescription`	`getQueryEngineDescription(String queryEngine)` see DataONE API Reference
`InputStream`	`getReplica(Identifier pid)` see DataONE API Reference
`InputStream`	`getReplica(Session session, Identifier pid)` see DataONE API Reference
`SystemMetadata`	`getSystemMetadata(Identifier pid)` Get the system metadata from a resource with the specified guid.
`SystemMetadata`	`getSystemMetadata(Session session, Identifier pid)` Get the system metadata from a resource with the specified guid.
`boolean`	`isAuthorized(Identifier pid, Permission action)` see DataONE API Reference
`boolean`	`isAuthorized(Session session, Identifier pid, Permission action)` see DataONE API Reference
`ObjectList`	`listObjects()` see DataONE API Reference
`ObjectList`	`listObjects(Date fromDate, Date toDate, ObjectFormatIdentifier formatid, Boolean replicaStatus, Integer start, Integer count)` see DataONE API Reference
`ObjectList`	`listObjects(Session session)` see DataONE API Reference
`ObjectList`	`listObjects(Session session, Date fromDate, Date toDate, ObjectFormatIdentifier formatid, Boolean replicaStatus, Integer start, Integer count)` see DataONE API Reference
`QueryEngineList`	`listQueryEngines()` see DataONE API Reference
`Date`	`ping()` see DataONE API Reference
`InputStream`	`query(String queryEngine, String query)` see DataONE API Reference
`boolean`	`replicate(Session session, SystemMetadata sysmeta, NodeReference sourceNode)` see DataONE API Reference
`boolean`	`replicate(SystemMetadata sysmeta, NodeReference sourceNode)` see DataONE API Reference
`boolean`	`synchronizationFailed(Session session, SynchronizationFailed message)` see DataONE API Reference
`boolean`	`synchronizationFailed(SynchronizationFailed message)` see DataONE API Reference
`boolean`	`systemMetadataChanged(Identifier pid, long serialVersion, Date dateSystemMetadataLastModified)` see DataONE API Reference
`boolean`	`systemMetadataChanged(Session session, Identifier pid, long serialVersion, Date dateSystemMetadataLastModified)` see DataONE API Reference
`Identifier`	`update(Identifier pid, InputStream object, Identifier newPid, SystemMetadata sysmeta)` see DataONE API Reference
`Identifier`	`update(Session session, Identifier pid, InputStream object, Identifier newPid, SystemMetadata sysmeta)` see DataONE API Reference

Methods inherited from class org.dataone.client.D1Node
deserializeServiceType, getDefaultSoTimeout, getLatestRequestUrl, getNodeId, getSystemMetadata, getSystemMetadata, query, recastClientSideExceptionToServiceFailure, recastDataONEExceptionToServiceFailure, setDefaultSoTimeout, setLatestRequestUrl, setNodeBaseServiceUrl, setNodeId

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

log

protected static org.apache.commons.logging.Log log

Constructor Detail
- MNode
```
public MNode(String nodeBaseServiceUrl)
```
  Construct a new client-side MNode (Member Node) object, passing in the base url of the member node for calling its services.
  
  Parameters:
  nodeBaseServiceUrl - base url for constructing service endpoints.
- MNode
```
public MNode(String nodeBaseServiceUrl,
     Session session)
```
  Construct a new client-side MNode (Member Node) object, passing in the base url of the member node for calling its services, and the Session to use for connections to that node.
  
  Parameters:
  nodeBaseServiceUrl - base url for constructing service endpoints.
  session - - the Session object passed to the CertificateManager to be used for establishing connections

Method Detail

getNodeBaseServiceUrl
```
public String getNodeBaseServiceUrl()
```
Description copied from class: D1Node

Retrieve the service URL for this node. The service URL can be used with knowledge of the DataONE REST API to construct endpoints for each of the DataONE REST services that are available on the node.

Overrides:

getNodeBaseServiceUrl in class D1Node

Returns:
String representing the service URL

ping
```
public Date ping()
          throws NotImplemented,
                 ServiceFailure,
                 InsufficientResources
```
see DataONE API Reference

Specified by:

ping in interface MNCore

Overrides:

ping in class D1Node

Throws:

NotImplemented

ServiceFailure

InsufficientResources
See Also:
http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_core.ping

getLogRecords

public Log getLogRecords()
                  throws InvalidRequest,
                         InvalidToken,
                         NotAuthorized,
                         NotImplemented,
                         ServiceFailure

see DataONE API Reference

Overrides:: getLogRecords in class D1Node
Throws:: InvalidRequest; InvalidToken; NotAuthorized; NotImplemented; ServiceFailure

getLogRecords

public Log getLogRecords(Session session)
                  throws InvalidRequest,
                         InvalidToken,
                         NotAuthorized,
                         NotImplemented,
                         ServiceFailure

see DataONE API Reference

Overrides:: getLogRecords in class D1Node
Throws:: InvalidRequest; InvalidToken; NotAuthorized; NotImplemented; ServiceFailure

getLogRecords

public Log getLogRecords(Date fromDate,
                Date toDate,
                Event event,
                String pidFilter,
                Integer start,
                Integer count)
                  throws InvalidRequest,
                         InvalidToken,
                         NotAuthorized,
                         NotImplemented,
                         ServiceFailure

see DataONE API Reference

Specified by:: getLogRecords in interface MNCore
Overrides:: getLogRecords in class D1Node
Throws:: InvalidRequest; InvalidToken; NotAuthorized; NotImplemented; ServiceFailure
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_core.getLogRecords

getLogRecords

public Log getLogRecords(Session session,
                Date fromDate,
                Date toDate,
                Event event,
                String pidFilter,
                Integer start,
                Integer count)
                  throws InvalidRequest,
                         InvalidToken,
                         NotAuthorized,
                         NotImplemented,
                         ServiceFailure

see DataONE API Reference

Specified by:: getLogRecords in interface MNCore
Overrides:: getLogRecords in class D1Node
Throws:: InvalidRequest; InvalidToken; NotAuthorized; NotImplemented; ServiceFailure
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_core.getLogRecords

listObjects

public ObjectList listObjects()
                       throws InvalidRequest,
                              InvalidToken,
                              NotAuthorized,
                              NotImplemented,
                              ServiceFailure

see DataONE API Reference

Overrides:: listObjects in class D1Node
Throws:: InvalidRequest; InvalidToken; NotAuthorized; NotImplemented; ServiceFailure

listObjects

public ObjectList listObjects(Session session)
                       throws InvalidRequest,
                              InvalidToken,
                              NotAuthorized,
                              NotImplemented,
                              ServiceFailure

see DataONE API Reference

Overrides:: listObjects in class D1Node
Throws:: InvalidRequest; InvalidToken; NotAuthorized; NotImplemented; ServiceFailure

listObjects

public ObjectList listObjects(Date fromDate,
                     Date toDate,
                     ObjectFormatIdentifier formatid,
                     Boolean replicaStatus,
                     Integer start,
                     Integer count)
                       throws InvalidRequest,
                              InvalidToken,
                              NotAuthorized,
                              NotImplemented,
                              ServiceFailure

see DataONE API Reference

Specified by:: listObjects in interface MNRead
Overrides:: listObjects in class D1Node
Throws:: InvalidRequest; InvalidToken; NotAuthorized; NotImplemented; ServiceFailure
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_read.listObjects

listObjects

public ObjectList listObjects(Session session,
                     Date fromDate,
                     Date toDate,
                     ObjectFormatIdentifier formatid,
                     Boolean replicaStatus,
                     Integer start,
                     Integer count)
                       throws InvalidRequest,
                              InvalidToken,
                              NotAuthorized,
                              NotImplemented,
                              ServiceFailure

see DataONE API Reference

Specified by:: listObjects in interface MNRead
Overrides:: listObjects in class D1Node
Throws:: InvalidRequest; InvalidToken; NotAuthorized; NotImplemented; ServiceFailure
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_read.listObjects

getCapabilities
```
public Node getCapabilities()
                     throws NotImplemented,
                            ServiceFailure
```
see DataONE API Reference

Specified by:

getCapabilities in interface MNCore

Throws:

NotImplemented

ServiceFailure
See Also:
http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_core.getCapabilities

get
```
public InputStream get(Identifier pid)
                throws InvalidToken,
                       NotAuthorized,
                       NotImplemented,
                       ServiceFailure,
                       NotFound,
                       InsufficientResources
```
Description copied from class: D1Node

Get the resource with the specified pid. Used by both the CNode and MNode subclasses. A LocalCache is used to cache objects in memory and in a local disk cache if the "D1Client.useLocalCache" configuration property was set to true when the D1Node was created. Otherwise InputStream is the Java native version of D1's OctetStream

Specified by:

get in interface MNRead

Overrides:

get in class D1Node

Throws:

InvalidToken

NotAuthorized

NotImplemented

ServiceFailure

NotFound

InsufficientResources
See Also:
see DataONE API Reference (MemberNode API), see DataONE API Reference (CoordinatingNode API)

get
```
public InputStream get(Session session,
              Identifier pid)
                throws InvalidToken,
                       NotAuthorized,
                       NotImplemented,
                       ServiceFailure,
                       NotFound,
                       InsufficientResources
```
Description copied from class: D1Node

Get the resource with the specified pid. Used by both the CNode and MNode subclasses. A LocalCache is used to cache objects in memory and in a local disk cache if the "D1Client.useLocalCache" configuration property was set to true when the D1Node was created. Otherwise InputStream is the Java native version of D1's OctetStream

Specified by:

get in interface MNRead

Overrides:

get in class D1Node

Throws:

InvalidToken

NotAuthorized

NotImplemented

ServiceFailure

NotFound

InsufficientResources
See Also:
see DataONE API Reference (MemberNode API), see DataONE API Reference (CoordinatingNode API)

getSystemMetadata
```
public SystemMetadata getSystemMetadata(Identifier pid)
                                 throws InvalidToken,
                                        NotAuthorized,
                                        NotImplemented,
                                        ServiceFailure,
                                        NotFound
```
Description copied from class: D1Node

Get the system metadata from a resource with the specified guid. Used by both the CNode and MNode implementations. Note that this method defaults to not using the local system metadata cache provided by the client, as SystemMetadata is mutable and so caching can lead to issues. In specific cases where a client wants to utilize the same system metadata in rapid succession, it may make sense to temporarily use the local cache by calling @see #getSystemMetadata(Session, Identifier, boolean).

Specified by:

getSystemMetadata in interface MNRead

Overrides:

getSystemMetadata in class D1Node

Throws:

InvalidToken

NotAuthorized

NotImplemented

ServiceFailure

NotFound
See Also:
DataONE API Reference (MemberNode API), DataONE API Reference (CoordinatingNode API)

getSystemMetadata
```
public SystemMetadata getSystemMetadata(Session session,
                               Identifier pid)
                                 throws InvalidToken,
                                        NotAuthorized,
                                        NotImplemented,
                                        ServiceFailure,
                                        NotFound
```
Description copied from class: D1Node

Get the system metadata from a resource with the specified guid. Used by both the CNode and MNode implementations. Note that this method defaults to not using the local system metadata cache provided by the client, as SystemMetadata is mutable and so caching can lead to issues. In specific cases where a client wants to utilize the same system metadata in rapid succession, it may make sense to temporarily use the local cache by calling @see #getSystemMetadata(Session, Identifier, boolean).

Specified by:

getSystemMetadata in interface MNRead

Overrides:

getSystemMetadata in class D1Node

Throws:

InvalidToken

NotAuthorized

NotImplemented

ServiceFailure

NotFound
See Also:
DataONE API Reference (MemberNode API), DataONE API Reference (CoordinatingNode API)

describe

public DescribeResponse describe(Identifier pid)
                          throws InvalidToken,
                                 NotAuthorized,
                                 NotImplemented,
                                 ServiceFailure,
                                 NotFound

see DataONE API Reference

Specified by:: describe in interface MNRead
Overrides:: describe in class D1Node
Throws:: InvalidToken; NotAuthorized; NotImplemented; ServiceFailure; NotFound
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_read.describe

describe

public DescribeResponse describe(Session session,
                        Identifier pid)
                          throws InvalidToken,
                                 NotAuthorized,
                                 NotImplemented,
                                 ServiceFailure,
                                 NotFound

see DataONE API Reference

Specified by:: describe in interface MNRead
Overrides:: describe in class D1Node
Throws:: InvalidToken; NotAuthorized; NotImplemented; ServiceFailure; NotFound
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_read.describe

getChecksum

public Checksum getChecksum(Identifier pid,
                   String checksumAlgorithm)
                     throws InvalidRequest,
                            InvalidToken,
                            NotAuthorized,
                            NotImplemented,
                            ServiceFailure,
                            NotFound

see DataONE API Reference

Specified by:: getChecksum in interface MNRead
Overrides:: getChecksum in class D1Node
Throws:: InvalidRequest; InvalidToken; NotAuthorized; NotImplemented; ServiceFailure; NotFound
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_read.getChecksum

getChecksum

public Checksum getChecksum(Session session,
                   Identifier pid,
                   String checksumAlgorithm)
                     throws InvalidRequest,
                            InvalidToken,
                            NotAuthorized,
                            NotImplemented,
                            ServiceFailure,
                            NotFound

see DataONE API Reference

Specified by:: getChecksum in interface MNRead
Overrides:: getChecksum in class D1Node; checksumAlgorithm - - for MN implementations only
Throws:: InvalidRequest - - for MN implementations only; InvalidToken; NotAuthorized; NotImplemented; ServiceFailure; NotFound
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_read.getChecksum

synchronizationFailed

public boolean synchronizationFailed(SynchronizationFailed message)
                              throws InvalidToken,
                                     NotAuthorized,
                                     NotImplemented,
                                     ServiceFailure

see DataONE API Reference

Specified by:: synchronizationFailed in interface MNRead
Throws:: InvalidToken; NotAuthorized; NotImplemented; ServiceFailure
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_read.synchronizationFailed

synchronizationFailed

public boolean synchronizationFailed(Session session,
                            SynchronizationFailed message)
                              throws InvalidToken,
                                     NotAuthorized,
                                     NotImplemented,
                                     ServiceFailure

see DataONE API Reference

Specified by:: synchronizationFailed in interface MNRead
Throws:: InvalidToken; NotAuthorized; NotImplemented; ServiceFailure
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_read.synchronizationFailed

isAuthorized

public boolean isAuthorized(Identifier pid,
                   Permission action)
                     throws ServiceFailure,
                            InvalidRequest,
                            InvalidToken,
                            NotFound,
                            NotAuthorized,
                            NotImplemented

see DataONE API Reference

Specified by:: isAuthorized in interface MNAuthorization
Overrides:: isAuthorized in class D1Node
Throws:: ServiceFailure; InvalidRequest; InvalidToken; NotFound; NotAuthorized; NotImplemented
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_auth.isAuthorized

isAuthorized

public boolean isAuthorized(Session session,
                   Identifier pid,
                   Permission action)
                     throws ServiceFailure,
                            InvalidRequest,
                            InvalidToken,
                            NotFound,
                            NotAuthorized,
                            NotImplemented

see DataONE API Reference

Specified by:: isAuthorized in interface MNAuthorization
Overrides:: isAuthorized in class D1Node
Throws:: ServiceFailure; InvalidRequest; InvalidToken; NotFound; NotAuthorized; NotImplemented
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_auth.isAuthorized

generateIdentifier

public Identifier generateIdentifier(String scheme,
                            String fragment)
                              throws InvalidToken,
                                     ServiceFailure,
                                     NotAuthorized,
                                     NotImplemented,
                                     InvalidRequest

see DataONE API Reference

Specified by:: generateIdentifier in interface MNStorage
Overrides:: generateIdentifier in class D1Node
Throws:: InvalidToken; ServiceFailure; NotAuthorized; NotImplemented; InvalidRequest
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MNStorage.generateIdentifier

generateIdentifier

public Identifier generateIdentifier(Session session,
                            String scheme,
                            String fragment)
                              throws InvalidToken,
                                     ServiceFailure,
                                     NotAuthorized,
                                     NotImplemented,
                                     InvalidRequest

see DataONE API Reference

Specified by:: generateIdentifier in interface MNStorage
Overrides:: generateIdentifier in class D1Node
Throws:: InvalidToken; ServiceFailure; NotAuthorized; NotImplemented; InvalidRequest
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MNStorage.generateIdentifier

create

public Identifier create(Identifier pid,
                InputStream object,
                SystemMetadata sysmeta)
                  throws IdentifierNotUnique,
                         InsufficientResources,
                         InvalidRequest,
                         InvalidSystemMetadata,
                         InvalidToken,
                         NotAuthorized,
                         NotImplemented,
                         ServiceFailure,
                         UnsupportedType

see DataONE API Reference

Specified by:: create in interface MNStorage
Throws:: IdentifierNotUnique; InsufficientResources; InvalidRequest; InvalidSystemMetadata; InvalidToken; NotAuthorized; NotImplemented; ServiceFailure; UnsupportedType
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_storage.create

create

public Identifier create(Session session,
                Identifier pid,
                InputStream object,
                SystemMetadata sysmeta)
                  throws IdentifierNotUnique,
                         InsufficientResources,
                         InvalidRequest,
                         InvalidSystemMetadata,
                         InvalidToken,
                         NotAuthorized,
                         NotImplemented,
                         ServiceFailure,
                         UnsupportedType

see DataONE API Reference

Specified by:: create in interface MNStorage
Throws:: IdentifierNotUnique; InsufficientResources; InvalidRequest; InvalidSystemMetadata; InvalidToken; NotAuthorized; NotImplemented; ServiceFailure; UnsupportedType
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_storage.create

update

public Identifier update(Identifier pid,
                InputStream object,
                Identifier newPid,
                SystemMetadata sysmeta)
                  throws IdentifierNotUnique,
                         InsufficientResources,
                         InvalidRequest,
                         InvalidSystemMetadata,
                         InvalidToken,
                         NotAuthorized,
                         NotImplemented,
                         ServiceFailure,
                         UnsupportedType,
                         NotFound

see DataONE API Reference

Specified by:: update in interface MNStorage
Throws:: IdentifierNotUnique; InsufficientResources; InvalidRequest; InvalidSystemMetadata; InvalidToken; NotAuthorized; NotImplemented; ServiceFailure; UnsupportedType; NotFound
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_storage.update

update

public Identifier update(Session session,
                Identifier pid,
                InputStream object,
                Identifier newPid,
                SystemMetadata sysmeta)
                  throws IdentifierNotUnique,
                         InsufficientResources,
                         InvalidRequest,
                         InvalidSystemMetadata,
                         InvalidToken,
                         NotAuthorized,
                         NotImplemented,
                         ServiceFailure,
                         UnsupportedType,
                         NotFound

see DataONE API Reference

Specified by:: update in interface MNStorage
Throws:: IdentifierNotUnique; InsufficientResources; InvalidRequest; InvalidSystemMetadata; InvalidToken; NotAuthorized; NotImplemented; ServiceFailure; UnsupportedType; NotFound
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_storage.update

delete

public Identifier delete(Identifier pid)
                  throws InvalidToken,
                         ServiceFailure,
                         NotAuthorized,
                         NotFound,
                         NotImplemented

see DataONE API Reference

Specified by:: delete in interface MNStorage
Overrides:: delete in class D1Node
Throws:: InvalidToken; ServiceFailure; NotAuthorized; NotFound; NotImplemented
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_storage.delete

delete

public Identifier delete(Session session,
                Identifier pid)
                  throws InvalidToken,
                         ServiceFailure,
                         NotAuthorized,
                         NotFound,
                         NotImplemented

see DataONE API Reference

Specified by:: delete in interface MNStorage
Overrides:: delete in class D1Node
Throws:: InvalidToken; ServiceFailure; NotAuthorized; NotFound; NotImplemented
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_storage.delete

systemMetadataChanged

public boolean systemMetadataChanged(Identifier pid,
                            long serialVersion,
                            Date dateSystemMetadataLastModified)
                              throws InvalidToken,
                                     ServiceFailure,
                                     NotAuthorized,
                                     NotImplemented,
                                     InvalidRequest

see DataONE API Reference

Specified by:: systemMetadataChanged in interface MNAuthorization
Throws:: InvalidToken; ServiceFailure; NotAuthorized; NotImplemented; InvalidRequest
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_auth.systemMetadataChanged

systemMetadataChanged

public boolean systemMetadataChanged(Session session,
                            Identifier pid,
                            long serialVersion,
                            Date dateSystemMetadataLastModified)
                              throws InvalidToken,
                                     ServiceFailure,
                                     NotAuthorized,
                                     NotImplemented,
                                     InvalidRequest

see DataONE API Reference

Specified by:: systemMetadataChanged in interface MNAuthorization
Throws:: InvalidToken; ServiceFailure; NotAuthorized; NotImplemented; InvalidRequest
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_auth.systemMetadataChanged

replicate

public boolean replicate(SystemMetadata sysmeta,
                NodeReference sourceNode)
                  throws NotImplemented,
                         ServiceFailure,
                         NotAuthorized,
                         InvalidRequest,
                         InvalidToken,
                         InsufficientResources,
                         UnsupportedType

see DataONE API Reference

Specified by:: replicate in interface MNReplication
Throws:: NotImplemented; ServiceFailure; NotAuthorized; InvalidRequest; InvalidToken; InsufficientResources; UnsupportedType
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_replication.replicate

replicate

public boolean replicate(Session session,
                SystemMetadata sysmeta,
                NodeReference sourceNode)
                  throws NotImplemented,
                         ServiceFailure,
                         NotAuthorized,
                         InvalidRequest,
                         InvalidToken,
                         InsufficientResources,
                         UnsupportedType

see DataONE API Reference

Specified by:: replicate in interface MNReplication
Throws:: NotImplemented; ServiceFailure; NotAuthorized; InvalidRequest; InvalidToken; InsufficientResources; UnsupportedType
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MN_replication.replicate

getReplica

public InputStream getReplica(Identifier pid)
                       throws InvalidToken,
                              NotAuthorized,
                              NotImplemented,
                              ServiceFailure,
                              NotFound,
                              InsufficientResources

see DataONE API Reference

Specified by:: getReplica in interface MNRead
Throws:: InvalidToken; NotAuthorized; NotImplemented; ServiceFailure; NotFound; InsufficientResources
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MNRead.getReplica

getReplica

public InputStream getReplica(Session session,
                     Identifier pid)
                       throws InvalidToken,
                              NotAuthorized,
                              NotImplemented,
                              ServiceFailure,
                              NotFound,
                              InsufficientResources

see DataONE API Reference

Specified by:: getReplica in interface MNRead
Throws:: InvalidToken; NotAuthorized; NotImplemented; ServiceFailure; NotFound; InsufficientResources
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MNRead.getReplica

query

public InputStream query(String queryEngine,
                String query)
                  throws InvalidToken,
                         ServiceFailure,
                         NotAuthorized,
                         InvalidRequest,
                         NotImplemented,
                         NotFound

see DataONE API Reference

Specified by:: query in interface MNQuery
Overrides:: query in class D1Node
Throws:: InvalidToken; ServiceFailure; NotAuthorized; InvalidRequest; NotImplemented; NotFound
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MNQuery.query

getQueryEngineDescription

public QueryEngineDescription getQueryEngineDescription(String queryEngine)
                                                 throws InvalidToken,
                                                        ServiceFailure,
                                                        NotAuthorized,
                                                        NotImplemented,
                                                        NotFound

see DataONE API Reference

Specified by:: getQueryEngineDescription in interface MNQuery
Overrides:: getQueryEngineDescription in class D1Node
Throws:: InvalidToken; ServiceFailure; NotAuthorized; NotImplemented; NotFound
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MNQuery.getQueryEngineDescription

listQueryEngines

public QueryEngineList listQueryEngines()
                                 throws InvalidToken,
                                        ServiceFailure,
                                        NotAuthorized,
                                        NotImplemented

see DataONE API Reference

Specified by:: listQueryEngines in interface MNQuery
Overrides:: listQueryEngines in class D1Node
Throws:: InvalidToken; ServiceFailure; NotAuthorized; NotImplemented
See Also:: http://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MNQuery.listQueryEngines

Class MNode

Field Summary

Fields inherited from class org.dataone.client.D1Node

Fields inherited from interface org.dataone.service.mn.tier1.v1.MNCore

Constructor Summary

Method Summary

Methods inherited from class org.dataone.client.D1Node

Methods inherited from class java.lang.Object

Field Detail

log

Constructor Detail

MNode

MNode

Method Detail

getNodeBaseServiceUrl

ping

getLogRecords

getLogRecords

getLogRecords

getLogRecords

listObjects

listObjects

listObjects

listObjects

getCapabilities

get

get

getSystemMetadata

getSystemMetadata

describe

describe

getChecksum

getChecksum

synchronizationFailed

synchronizationFailed

isAuthorized

isAuthorized

generateIdentifier

generateIdentifier

create

create

update

update

archive

archive

delete

delete

systemMetadataChanged

systemMetadataChanged

replicate

replicate

getReplica

getReplica

query

getQueryEngineDescription

listQueryEngines