org.dataone.rest.api

Class D1MemberNode

java.lang.Object

org.dataone.rest.api.D1MemberNode

@Component
public class D1MemberNode
extends Object

DataONE Member Node Services.

Author:

Mark Diggory, Lantian Gai, Mini Pillai

Constructor Summary

Constructors

Constructor and Description
D1MemberNode()

Method Summary

Methods

Modifier and Type	Method and Description
org.dataone.service.types.v1.Node	doPing()
org.dataone.service.types.v1.Node	doRootPing()
org.dataone.service.types.v1.Node	doRootV1Ping()
org.dataone.service.types.v1.Node	getCapabilities()
org.dataone.service.types.v1.Checksum	getChecksum(javax.servlet.http.HttpServletRequest request, String pid, String checksumAlgorithm) Represents the value of a computed :term:`checksum` expressed as a hexadecimal formatted version of the message digest.
javax.ws.rs.core.Response	getDescribeObject(javax.servlet.http.HttpServletRequest request, String pid) This method provides a lighter weight mechanism than MNRead.getSystemMetadata() for a client to determine basic properties of the referenced object.
org.dataone.service.types.v1.Log	getLogRecords(String fromDate, String toDate, String event, String pidFilter, Integer start, Integer count) Represents a collection of :class:`Types.LogEntry` elements, used to transfer log information between DataONE components.
javax.ws.rs.core.Response	getObject(javax.servlet.http.HttpServletRequest request, String pid) Lookup DSpaceObject and Return in specific format.
org.dataone.service.types.v1_1.QueryEngineDescription	getQueryEngineDescription(String queryEngine)
javax.ws.rs.core.Response	getReplica(javax.servlet.http.HttpServletRequest request, String pid) Called by a target Member Node to fullfill the replication request originated by a Coordinating Node calling MNReplication.replicate().
org.dataone.service.types.v1.SystemMetadata	getSystemMetadata(javax.servlet.http.HttpServletRequest request, String pid) Describes the object identified by id by returning the associated system metadata object.
boolean	isAuthorized(String pid, String action)
org.dataone.service.types.v1.ObjectList	listObjects(String identifier, String fromDate, String toDate, String formatId, Boolean replicaStatus, Integer start, Integer count) Retrieve the list of objects present on the MN that match the calling parameters.
org.dataone.service.types.v1_1.QueryEngineList	listQueryEngines()
InputStream	query(String queryEngine, String query) Submit a query against the specified queryEngine and return the response as formatted by the queryEngine.
void	setNode(org.dataone.service.types.v1.Node node)
javax.ws.rs.core.Response	synchronizationFailed(javax.servlet.http.HttpServletRequest request, InputStream message) This is a callback method used by a CN to indicate to a MN that it cannot complete synchronization of the science metadata identified by pid.

Methods inherited from class java.lang.Object

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

Constructor Detail

D1MemberNode

public D1MemberNode()

Method Detail

setNode

@Autowired
public void setNode(org.dataone.service.types.v1.Node node)

doRootV1Ping

public org.dataone.service.types.v1.Node doRootV1Ping()
                                               throws org.dataone.service.exceptions.NotImplemented,
                                                      org.dataone.service.exceptions.ServiceFailure,
                                                      org.dataone.service.exceptions.InsufficientResources

Throws:

org.dataone.service.exceptions.NotImplemented

org.dataone.service.exceptions.ServiceFailure

org.dataone.service.exceptions.InsufficientResources

doRootPing

public org.dataone.service.types.v1.Node doRootPing()
                                             throws org.dataone.service.exceptions.NotImplemented,
                                                    org.dataone.service.exceptions.ServiceFailure,
                                                    org.dataone.service.exceptions.InsufficientResources

Throws:

org.dataone.service.exceptions.NotImplemented

org.dataone.service.exceptions.ServiceFailure

org.dataone.service.exceptions.InsufficientResources

doPing

public org.dataone.service.types.v1.Node doPing()
                                         throws org.dataone.service.exceptions.NotImplemented,
                                                org.dataone.service.exceptions.ServiceFailure,
                                                org.dataone.service.exceptions.InsufficientResources

Throws:

org.dataone.service.exceptions.NotImplemented

org.dataone.service.exceptions.ServiceFailure

org.dataone.service.exceptions.InsufficientResources

getCapabilities

public org.dataone.service.types.v1.Node getCapabilities()
                                                  throws org.dataone.service.exceptions.NotImplemented,
                                                         org.dataone.service.exceptions.ServiceFailure

Returns:

Throws:

org.dataone.service.exceptions.NotImplemented

org.dataone.service.exceptions.ServiceFailure

getLogRecords

public org.dataone.service.types.v1.Log getLogRecords(String fromDate,
                                             String toDate,
                                             String event,
                                             String pidFilter,
                                             Integer start,
                                             Integer count)
                                               throws org.dataone.service.exceptions.InvalidRequest,
                                                      org.dataone.service.exceptions.InvalidToken,
                                                      org.dataone.service.exceptions.NotAuthorized,
                                                      org.dataone.service.exceptions.NotImplemented,
                                                      org.dataone.service.exceptions.ServiceFailure

Represents a collection of :class:`Types.LogEntry` elements, used to transfer log information between DataONE components. Schema fragment(s) for this class:

 <xs:complexType xmlns:ns="http://ns.dataone.org/service/types/v1" xmlns:xs="http://www.w3.org/2001/XMLSchema" name="Log">
   <xs:complexContent>
     <xs:extension base="ns:Slice">
       <xs:sequence>
         <xs:element type="ns:LogEntry" name="logEntry" minOccurs="0" maxOccurs="unbounded"/>
       </xs:sequence>
     </xs:extension>
   </xs:complexContent>
 </xs:complexType>
 

A single log entry as reported by a Member Node or Coordinating Node through the :func:`MNCore.getLogRecords` or :func:`CNCore.getLogRecords` methods. Schema fragment(s) for this class:

 <xs:complexType xmlns:ns="http://ns.dataone.org/service/types/v1" xmlns:xs="http://www.w3.org/2001/XMLSchema" name="LogEntry">
   <xs:sequence>
     <xs:element type="xs:string" name="entryId" minOccurs="1" maxOccurs="1"/>
     <xs:element type="ns:Identifier" name="identifier" minOccurs="1" maxOccurs="1"/>
     <xs:element type="xs:string" name="ipAddress" minOccurs="1" maxOccurs="1"/>
     <xs:element type="xs:string" name="userAgent" minOccurs="1" maxOccurs="1"/>
     <xs:element type="ns:Subject" name="subject" minOccurs="1" maxOccurs="1"/>
     <xs:element type="ns:Event" name="event" minOccurs="1" maxOccurs="1"/>
     <xs:element type="xs:dateTime" name="dateLogged" minOccurs="1" maxOccurs="1"/>
     <xs:element type="ns:NodeReference" name="nodeIdentifier" minOccurs="1" maxOccurs="1"/>
   </xs:sequence>
 </xs:complexType>
 

Example Response: 1 MNodeTierTests.201260152556757. 129.24.0.17 null CN=testSubmitter,DC=dataone,DC=org create 2012-02-29T23:25:58.104+00:00 urn:node:DEMO2 Retrieve log information from the Member Node for the specified slice parameters. Log entries will only return PIDs. This method is used primarily by the log aggregator to generate aggregate statistics for nodes, objects, and the methods of access. The response MUST contain only records for which the requestor has permission to read. Note that date time precision is limited to one millisecond. If no timezone information is provided UTC will be assumed. Access control for this method MUST be configured to allow calling by Coordinating Nodes and MAY be configured to allow more general access. Rest URL: GET /log?[fromDate={fromDate}][&toDate={toDate}][&event={event}][&idFilter={idFilter}][&start={start}][&count={count}]

Parameters:

fromDate - fromDate (Types.DateTime) – Records with time stamp greater than or equal to (>=) this value will be returned. Transmitted as a URL query parameter, and so must be escaped accordingly.

toDate - toDate (Types.DateTime) – Records with a time stamp less than (<) this value will be returned. If not specified, then defaults to now. Transmitted as a URL query parameter, and so must be escaped accordingly.

event - event (Types.Event) – Return only log records for the specified type of event. Default is all. Transmitted as a URL query parameter, and so must be escaped accordingly.

pidFilter - pidFilter (string) – Return only log records for identifiers that start with the supplied identifier string. Support for this parameter is optional and MAY be ignored by the Member Node implementation with no warning. Accepts PIDs and SIDs Transmitted as a URL query parameter, and so must be escaped accordingly.

start - start=0 (integer) – Optional zero based offset from the first record in the set of matching log records. Used to assist with paging the response. Transmitted as a URL query parameter, and so must be escaped accordingly.

count - count=1000 (integer) – The maximum number of log records that should be returned in the response. The Member Node may return fewer and the caller should check the total in the response to determine if further pages may be retrieved. Transmitted as a URL query parameter, and so must be escaped accordingly.

Returns:

Types.Log

Throws:

org.dataone.service.exceptions.InvalidRequest - (errorCode=400, detailCode=1480) The request parameters were malformed or an invalid date range was specified.

org.dataone.service.exceptions.InvalidToken - (errorCode=401, detailCode=1470)

org.dataone.service.exceptions.NotAuthorized - (errorCode=401, detailCode=1460) Raised if the user making the request is not authorized to access the log records. This is determined by the policy of the Member Node.

org.dataone.service.exceptions.NotImplemented - (errorCode=501, detailCode=1461)

org.dataone.service.exceptions.ServiceFailure - (errorCode=500, detailCode=1490)

getObject

public javax.ws.rs.core.Response getObject(@Context
                                  javax.servlet.http.HttpServletRequest request,
                                  String pid)
                                    throws org.dataone.service.exceptions.InvalidToken,
                                           org.dataone.service.exceptions.NotAuthorized,
                                           org.dataone.service.exceptions.NotImplemented,
                                           org.dataone.service.exceptions.ServiceFailure,
                                           org.dataone.service.exceptions.NotFound,
                                           org.dataone.service.exceptions.InsufficientResources

Lookup DSpaceObject and Return in specific format. Default format will be used for standard DSpace PID. Alternate Formats may be provided in the future as alternate PID. PID May be any identifier configured in IdentifierService that may be used to resolve the object, examples may include DSpace handle id, CNRI Handles, DOI or other implemented identifiers. Retrieve an object identified by id from the node. Supports both PIDs and SIDs. SID will return HEAD PID. The response MUST contain the bytes of the indicated object, and the checksum of the bytes retrieved SHOULD match the SystemMetadata.checksum recorded in the Types.SystemMetadata when calling with PID. If the object does not exist on the node servicing the request, then Exceptions.NotFound must be raised even if the object exists on another node in the DataONE system. Also implmented by Coordinating Nodes as CNRead.get(). Use Cases: UC01, UC06, UC16 Rest URL: GET /object/nnnbhj{id} hghb bmnb, b,b,bmb

Parameters:

pid - persistent identifier, must be resolve able in IdentifierService. (Types.Identifier) – The identifier for the object to be retrieved. May be a PID or a SID. Transmitted as part of the URL path and must be escaped accordingly.

Returns:

Bytes of the specified object. Types.OctetStream

Throws:

org.dataone.service.exceptions.InvalidToken - (errorCode=401, detailCode=1010)

org.dataone.service.exceptions.NotAuthorized - (errorCode=401, detailCode=1000)

org.dataone.service.exceptions.NotImplemented - (errorCode=501, detailCode=1001)

org.dataone.service.exceptions.ServiceFailure - (errorCode=500, detailCode=1030)

org.dataone.service.exceptions.NotFound - (errorCode=404, detailCode=1020) The object specified by id does not exist at this node. The description should include a reference to the resolve method.

org.dataone.service.exceptions.InsufficientResources - (errorCode=413, detailCode=1002) The node is unable to service the request due to insufficient resources such as CPU, memory, or bandwidth being over utilized.

getSystemMetadata

public org.dataone.service.types.v1.SystemMetadata getSystemMetadata(@Context
                                                            javax.servlet.http.HttpServletRequest request,
                                                            String pid)
                                                              throws org.dataone.service.exceptions.InvalidToken,
                                                                     org.dataone.service.exceptions.NotAuthorized,
                                                                     org.dataone.service.exceptions.NotImplemented,
                                                                     org.dataone.service.exceptions.ServiceFailure,
                                                                     org.dataone.service.exceptions.NotFound

Describes the object identified by id by returning the associated system metadata object. If the object does not exist on the node servicing the request, then Exceptions.NotFound MUST be raised even if the object exists on another node in the DataONE system. Use Cases: UC06, UC37, UC16 Rest URL: GET /meta/{pid} Schema fragment(s) for this class:

 <xs:complexType xmlns:ns="http://ns.dataone.org/service/types/v1" xmlns:xs="http://www.w3.org/2001/XMLSchema" name="SystemMetadata">
   <xs:sequence>
     <xs:element type="xs:long" name="serialVersion" minOccurs="0" maxOccurs="1"/>
     <xs:element type="ns:Identifier" name="identifier"/>
     <xs:element type="ns:ObjectFormatIdentifier" name="formatId"/>
     <xs:element type="xs:long" name="size"/>
     <xs:element type="ns:Checksum" name="checksum"/>
     <xs:element type="ns:Subject" name="submitter" minOccurs="0" maxOccurs="1"/>
     <xs:element type="ns:Subject" name="rightsHolder"/>
     <xs:element type="ns:AccessPolicy" name="accessPolicy" minOccurs="0" maxOccurs="1"/>
     <xs:element type="ns:ReplicationPolicy" name="replicationPolicy" minOccurs="0" maxOccurs="1"/>
     <xs:element type="ns:Identifier" name="obsoletes" minOccurs="0" maxOccurs="1"/>
     <xs:element type="ns:Identifier" name="obsoletedBy" minOccurs="0" maxOccurs="1"/>
     <xs:element type="xs:boolean" name="archived" minOccurs="0" maxOccurs="1"/>
     <xs:element type="xs:dateTime" name="dateUploaded" minOccurs="0" maxOccurs="1"/>
     <xs:element type="xs:dateTime" name="dateSysMetadataModified" minOccurs="0" maxOccurs="1"/>
     <xs:element type="ns:NodeReference" name="originMemberNode" minOccurs="0" maxOccurs="1"/>
     <xs:element type="ns:NodeReference" name="authoritativeMemberNode" minOccurs="0" maxOccurs="1"/>
     <xs:element type="ns:Replica" name="replica" minOccurs="0" maxOccurs="unbounded"/>
   </xs:sequence>
 </xs:complexType>
 

Parameters:

pid - (Types.Identifier) – Identifier for the science data or science metedata object of interest. May be either a PID or a SID. Transmitted as part of the URL path and must be escaped accordingly.

Returns:

Types.SystemMetadata. System metadata object describing the object.

Throws:

org.dataone.service.exceptions.InvalidToken - (errorCode=401, detailCode=1050)

org.dataone.service.exceptions.NotAuthorized - (errorCode=401, detailCode=1040)

org.dataone.service.exceptions.NotImplemented - (errorCode=501, detailCode=1041)

org.dataone.service.exceptions.ServiceFailure - (errorCode=500, detailCode=1090)

org.dataone.service.exceptions.NotFound - (errorCode=404, detailCode=1060) There is no data or science metadata identified by the given pid on the node where the request was serviced. The error message should provide a hint to use the CNRead.resolve() mechanism.

getDescribeObject

public javax.ws.rs.core.Response getDescribeObject(@Context
                                          javax.servlet.http.HttpServletRequest request,
                                          String pid)
                                            throws org.dataone.service.exceptions.InvalidRequest,
                                                   org.dataone.service.exceptions.InvalidToken,
                                                   org.dataone.service.exceptions.NotAuthorized,
                                                   org.dataone.service.exceptions.NotImplemented,
                                                   org.dataone.service.exceptions.ServiceFailure,
                                                   org.dataone.service.exceptions.NotFound

This method provides a lighter weight mechanism than MNRead.getSystemMetadata() for a client to determine basic properties of the referenced object. The response should indicate properties that are typically returned in a HTTP HEAD request: the date late modified, the size of the object, the type of the object (the SystemMetadata.formatId). The principal indicated by token must have read privileges on the object, otherwise Exceptions.NotAuthorized is raised. If the object does not exist on the node servicing the request, then Exceptions.NotFound must be raised even if the object exists on another node in the DataONE system. Note that this method is likely to be called frequently and so efficiency should be taken into consideration during implementation. Use Cases: UC16 Rest URL: HEAD /object/{pid} curl -I http://mn1.dataone.org/mn/v1/object/ABC123 HTTP/1.1 200 OK Last-Modified: Wed, 16 Dec 2009 13:58:34 GMT Content-Length: 10400 Content-Type: application/octet-stream DataONE-formatId: eml://ecoinformatics.org/eml-2.0.1 DataONE-Checksum: SHA-1,2e01e17467891f7c933dbaa00e1459d23db3fe4f DataONE-SerialVersion: 1234

Parameters:

request -

pid - (Types.Identifier) – Identifier for the object in question. May be either a PID or a SID. Transmitted as part of the URL path and must be escaped accordingly.

Returns:

Types.DescribeResponse A set of values providing a basic description of the object.

Throws:

org.dataone.service.exceptions.InvalidRequest

org.dataone.service.exceptions.InvalidToken - (errorCode=401, detailCode=1370)

org.dataone.service.exceptions.NotAuthorized - (errorCode=401, detailCode=1360)

org.dataone.service.exceptions.NotImplemented - (errorCode=501, detailCode=1361)

org.dataone.service.exceptions.ServiceFailure - (errorCode=500, detailCode=1390)

org.dataone.service.exceptions.NotFound - (errorCode=404, detailCode=1380)

getChecksum

public org.dataone.service.types.v1.Checksum getChecksum(@Context
                                                javax.servlet.http.HttpServletRequest request,
                                                String pid,
                                                String checksumAlgorithm)
                                                  throws org.dataone.service.exceptions.InvalidRequest,
                                                         org.dataone.service.exceptions.InvalidToken,
                                                         org.dataone.service.exceptions.NotAuthorized,
                                                         org.dataone.service.exceptions.NotImplemented,
                                                         org.dataone.service.exceptions.ServiceFailure,
                                                         org.dataone.service.exceptions.NotFound

Represents the value of a computed :term:`checksum` expressed as a hexadecimal formatted version of the message digest. Note that these hex values should be treated as case-insensitive strings, in that leading zeros must be preserved, and digests can use a mixture of upper and lower case letters to represent the hex values. Comparison algorithms MUST be able to handle any variant of these representations (e.g., by performing a case-insensitive string match on hex digests from the same algorithm). Rest URL: GET /checksum/{pid}[?checksumAlgorithm={checksumAlgorithm}] Schema fragment(s) for this class:

 <xs:complexType xmlns:ns="http://ns.dataone.org/service/types/v1" xmlns:xs="http://www.w3.org/2001/XMLSchema" name="Checksum">
   <xs:simpleContent>
     <xs:extension base="xs:string">
       <xs:attribute type="xs:string" use="required" name="algorithm"/>
     </xs:extension>
   </xs:simpleContent>
 </xs:complexType>
 

Parameters:

pid - (Types.Identifier) – The identifier of the object the operation is being performed on. Transmitted as part of the URL path and must be escaped accordingly.

checksumAlgorithm - (string) – The name of an algorithm that will be used to compute a checksum of the bytes of the object. This value is drawn from a DataONE controlled list of values as indicted in the Types.SystemMetadata. If not specified, then the system wide default checksum algorithm should be used. Transmitted as a URL query parameter, and so must be escaped accordingly.

Returns:

Returns a Types.Checksum for the specified object using an accepted hashing algorithm. The result is used to determine if two instances referenced by a PID are identical, hence it is necessary that MNs can ensure that the returned checksum is valid for the referenced object either by computing it on the fly or by using a cached value that is certain to be correct.

Throws:

org.dataone.service.exceptions.InvalidRequest - (errorCode=400, detailCode=1402) A supplied parameter was invalid, most likely an unsupported checksum algorithm was specified, in which case the error message should include an enumeration of supported checksum algorithms.

org.dataone.service.exceptions.InvalidToken - (errorCode=401, detailCode=1430)

org.dataone.service.exceptions.NotAuthorized - (errorCode=401, detailCode=1400)

org.dataone.service.exceptions.NotImplemented - (errorCode=501, detailCode=1401)

org.dataone.service.exceptions.ServiceFailure - (errorCode=500, detailCode=1410)

org.dataone.service.exceptions.NotFound - (errorCode=404, detailCode=1420)

listObjects

public org.dataone.service.types.v1.ObjectList listObjects(String identifier,
                                                  String fromDate,
                                                  String toDate,
                                                  String formatId,
                                                  Boolean replicaStatus,
                                                  Integer start,
                                                  Integer count)
                                                    throws org.dataone.service.exceptions.InvalidRequest,
                                                           org.dataone.service.exceptions.InvalidToken,
                                                           org.dataone.service.exceptions.NotAuthorized,
                                                           org.dataone.service.exceptions.NotImplemented,
                                                           org.dataone.service.exceptions.ServiceFailure

Retrieve the list of objects present on the MN that match the calling parameters. This method is required to support the process of Member Node synchronization. At a minimum, this method MUST be able to return a list of objects that match: fromDate < SystemMetadata.dateSysMetadataModified but is expected to also support date range (by also specifying toDate), and should also support slicing of the matching set of records by indicating the starting index of the response (where 0 is the index of the first item) and the count of elements to be returned. Note that date time precision is limited to one millisecond. If no timezone information is provided, the UTC will be assumed. Use Cases: UC06, UC16 Rest URL: GET /object[?fromDate={fromDate}&toDate={toDate}&identifier={identifier}&formatId={formatId}&replicaStatus={replicaStatus} &start={start}&count={count}] Schema fragment(s) for this class:

 <xs:complexType xmlns:ns="http://ns.dataone.org/service/types/v1" xmlns:xs="http://www.w3.org/2001/XMLSchema" name="ObjectInfo">
   <xs:sequence>
     <xs:element type="ns:Identifier" name="identifier" minOccurs="1" maxOccurs="1"/>
     <xs:element type="ns:ObjectFormatIdentifier" name="formatId"/>
     <xs:element type="ns:Checksum" name="checksum" minOccurs="1" maxOccurs="1"/>
     <xs:element type="xs:dateTime" name="dateSysMetadataModified"/>
     <xs:element type="xs:long" name="size"/>
   </xs:sequence>
 </xs:complexType>
 

Parameters:

identifier - (Types.Identifier) – Restrict results to the specified identifier. May be a PID or a SID. In the case of the latter, returns a listing of all PIDs that share the given SID. Transmitted as a URL query parameter, and so must be escaped accordingly.

fromDate - (Types.DateTime) – Entries with SystemMetadata.dateSysMetadataModified greater than (>) fromDate must be returned. Transmitted as a URL query parameter, and so must be escaped accordingly.

toDate - (Types.DateTime) – Entries with SystemMetadata.dateSysMetadataModified less than (<) toDate must be returned. Transmitted as a URL query parameter, and so must be escaped accordingly.

formatId - (Types.ObjectFormatIdentifier) – Restrict results to the specified object format identifier. Transmitted as a URL query parameter, and so must be escaped accordingly.

replicaStatus - TBD

start - start=0 (integer) – The zero-based index of the first value, relative to the first record of the resultset that matches the parameters. Transmitted as a URL query parameter, and so must be escaped accordingly.

count - count=1000 (integer) – The maximum number of entries that should be returned in the response. The Member Node may return fewer and the caller should check the total in the response to determine if further pages may be retrieved. Transmitted as a URL query parameter, and so must be escaped accordingly.

Returns:

Types.ObjectList The list of PIDs that match the query criteria. If none match, an empty list is returned.

Throws:

org.dataone.service.exceptions.InvalidRequest - (errorCode=400, detailCode=1540)

org.dataone.service.exceptions.InvalidToken - (errorCode=401, detailCode=1530)

org.dataone.service.exceptions.NotAuthorized - (errorCode=401, detailCode=1520)

org.dataone.service.exceptions.NotImplemented - (errorCode=501, detailCode=1560) Raised if some functionality requested is not implemented. In the case of an optional request parameter not being supported, the errorCode should be 400. If the requested format (through HTTP Accept headers) is not supported, then the standard HTTP 406 error code should be returned.

org.dataone.service.exceptions.ServiceFailure - (errorCode=500, detailCode=1580)

synchronizationFailed

public javax.ws.rs.core.Response synchronizationFailed(@Context
                                              javax.servlet.http.HttpServletRequest request,
                                              InputStream message)
                                                throws org.dataone.service.exceptions.InvalidToken,
                                                       org.dataone.service.exceptions.NotAuthorized,
                                                       org.dataone.service.exceptions.NotImplemented,
                                                       org.dataone.service.exceptions.ServiceFailure

This is a callback method used by a CN to indicate to a MN that it cannot complete synchronization of the science metadata identified by pid. When called, the MN should take steps to record the problem description and notify an administrator or the data owner of the issue. A successful response is indicated by a HTTP status of 200. An unsuccessful call is indicated by a returned exception and associated HTTP status code. Access control for this method MUST be configured to allow calling by Coordinating Nodes and MAY be configured to allow more general access. Use Cases: UC06 Rest URL: POST /error Optionally raised by the receiving MN, depending on implementation.

Parameters:

message - message (Types.Exception) – An instance of the Exceptions.SynchronizationFailed exception with body appropriately filled. Transmitted as an UTF-8 encoded XML structure for the respective type as defined in the DataONE types schema, as a File part of the MIME multipart/mixed message.

Returns:

Types.Boolean A successful response is indicated by a HTTP 200 status. An unsuccessful call is indicated by returning the appropriate exception.

Throws:

org.dataone.service.exceptions.InvalidToken - (errorCode=401, detailCode=2164)

org.dataone.service.exceptions.NotAuthorized - (errorCode=401, detailCode=2162)

org.dataone.service.exceptions.NotImplemented - (errorCode=501, detailCode=2160)

org.dataone.service.exceptions.ServiceFailure - (errorCode=500, detailCode=2161)

getReplica

public javax.ws.rs.core.Response getReplica(@Context
                                   javax.servlet.http.HttpServletRequest request,
                                   String pid)
                                     throws org.dataone.service.exceptions.InvalidToken,
                                            org.dataone.service.exceptions.NotAuthorized,
                                            org.dataone.service.exceptions.NotImplemented,
                                            org.dataone.service.exceptions.ServiceFailure,
                                            org.dataone.service.exceptions.NotFound,
                                            org.dataone.service.exceptions.InsufficientResources

Called by a target Member Node to fullfill the replication request originated by a Coordinating Node calling MNReplication.replicate(). This is a request to make a replica copy of the object, and differs from a call to GET /object in that it should be logged as a replication event rather than a read event on that object. If the object being retrieved is restricted access, then a Tier 2 or higher Member Node MUST make a call to CNReplication.isNodeAuthorized() to verify that the Subject of the caller is authorized to retrieve the content. A successful operation is indicated by a HTTP status of 200 on the response. Failure of the operation MUST be indicated by returning an appropriate exception. Use Cases: UC09 Rest URL: GET /replica/{pid}

Parameters:

pid - pid (Types.Identifier) – The identifier of the object to get as a replica Transmitted as part of the URL path and must be escaped accordingly.

Returns:

Types.OctetStream Bytes of the specified object.

Throws:

org.dataone.service.exceptions.InvalidToken - (errorCode=401, detailCode=2183)

org.dataone.service.exceptions.NotAuthorized - (errorCode=401, detailCode=2182)

org.dataone.service.exceptions.NotImplemented - (errorCode=501, detailCode=2180)

org.dataone.service.exceptions.ServiceFailure - (errorCode=500, detailCode=2181)

org.dataone.service.exceptions.NotFound - (errorCode=404, detailCode=2185)

org.dataone.service.exceptions.InsufficientResources - (errorCode=413, detailCode=2184) The node is unable to service the request due to insufficient resources such as CPU, memory, or bandwidth being over utilized.

query

public InputStream query(String queryEngine,
                String query)
                  throws org.dataone.service.exceptions.InvalidToken,
                         org.dataone.service.exceptions.ServiceFailure,
                         org.dataone.service.exceptions.NotAuthorized,
                         org.dataone.service.exceptions.InvalidRequest,
                         org.dataone.service.exceptions.NotImplemented,
                         org.dataone.service.exceptions.NotFound

Submit a query against the specified queryEngine and return the response as formatted by the queryEngine. The MNQuery.query() operation may be implemented by more than one type of search engine and the queryEngine parameter indicates which search engine is targeted. The value and form of query is determined by the specific query engine. For example, the SOLR search engine will accept many of the standard parameters of SOLR, including field restrictions and faceting. This method is optional for Member Nodes, but if implemented, both getQueryEngineDescription and listQueryEngines must also be implemented.

Parameters:

queryEngine - specify the engine will be used for this query

query - query string.

Returns:

Jersey Response Object, including the list of objects return from query engine.

Throws:

org.dataone.service.exceptions.InvalidRequest

org.dataone.service.exceptions.InvalidToken

org.dataone.service.exceptions.NotAuthorized

org.dataone.service.exceptions.NotImplemented

org.dataone.service.exceptions.ServiceFailure

org.dataone.service.exceptions.NotFound

getQueryEngineDescription

public org.dataone.service.types.v1_1.QueryEngineDescription getQueryEngineDescription(String queryEngine)
                                                                                throws org.dataone.service.exceptions.InvalidToken,
                                                                                       org.dataone.service.exceptions.ServiceFailure,
                                                                                       org.dataone.service.exceptions.NotAuthorized,
                                                                                       org.dataone.service.exceptions.NotImplemented,
                                                                                       org.dataone.service.exceptions.NotFound

Throws:

org.dataone.service.exceptions.InvalidToken

org.dataone.service.exceptions.ServiceFailure

org.dataone.service.exceptions.NotAuthorized

org.dataone.service.exceptions.NotImplemented

org.dataone.service.exceptions.NotFound

listQueryEngines

public org.dataone.service.types.v1_1.QueryEngineList listQueryEngines()
                                                                throws org.dataone.service.exceptions.InvalidToken,
                                                                       org.dataone.service.exceptions.ServiceFailure,
                                                                       org.dataone.service.exceptions.NotAuthorized,
                                                                       org.dataone.service.exceptions.NotImplemented

Throws:

org.dataone.service.exceptions.InvalidToken

org.dataone.service.exceptions.ServiceFailure

org.dataone.service.exceptions.NotAuthorized

org.dataone.service.exceptions.NotImplemented

isAuthorized

public boolean isAuthorized(String pid,
                   String action)
                     throws org.dataone.service.exceptions.ServiceFailure,
                            org.dataone.service.exceptions.InvalidRequest,
                            org.dataone.service.exceptions.InvalidToken,
                            org.dataone.service.exceptions.NotFound,
                            org.dataone.service.exceptions.NotAuthorized,
                            org.dataone.service.exceptions.NotImplemented

Throws:

org.dataone.service.exceptions.ServiceFailure

org.dataone.service.exceptions.InvalidRequest

org.dataone.service.exceptions.InvalidToken

org.dataone.service.exceptions.NotFound

org.dataone.service.exceptions.NotAuthorized

org.dataone.service.exceptions.NotImplemented