Package edu.ucsb.nceas.metacat.restservice.v1

Class MNResourceHandler

java.lang.Object

edu.ucsb.nceas.metacat.restservice.D1ResourceHandler

edu.ucsb.nceas.metacat.restservice.v1.MNResourceHandler

public class MNResourceHandler
extends D1ResourceHandler

MN REST service implementation handler ****************** MNCore -- ping() - GET /d1/mn/monitor/ping log() - GET /d1/mn/log **getObjectStatistics() - GET /d1/mn/monitor/object getOperationsStatistics - GET /d1/mn/monitor/event **getStatus - GET /d1/mn/monitor/status getCapabilities() - GET /d1/mn/ and /d1/mn/node MNRead -- get() - GET /d1/mn/object/PID getSystemMetadata() - GET /d1/mn/meta/PID describe() - HEAD /d1/mn/object/PID getChecksum() - GET /d1/mn/checksum/PID listObjects() - GET /d1/mn/object synchronizationFailed() - POST /d1/mn/error MNAuthorization -- isAuthorized() - GET /d1/mn/isAuthorized/PID setAccessPolicy() - PUT /d1/mn/accessRules/PID MNStorage - create() - POST /d1/mn/object/PID update() - PUT /d1/mn/object/PID delete() - DELETE /d1/mn/object/PID archive() - PUT /d1/mn/archive/PID systemMetadataChanged() - POST /dirtySystemMetadata/PID MNReplication replicate() - POST /d1/mn/replicate getReplica() - GET /d1/mn/replica ******************

Author:

leinfelder

Field Summary

Fields

Modifier and Type	Field	Description
protected static final String	RESOURCE_ERROR
protected static final String	RESOURCE_GENERATE_ID
protected static final String	RESOURCE_META_CHANGED
protected static final String	RESOURCE_MONITOR
protected static final String	RESOURCE_NODE
protected static final String	RESOURCE_PACKAGE
protected static final String	RESOURCE_PUBLISH
protected static final String	RESOURCE_REPLICAS
protected static final String	RESOURCE_REPLICATE
protected static final String	RESOURCE_TOKEN
protected static final String	RESOURCE_VIEWS

Fields inherited from class edu.ucsb.nceas.metacat.restservice.D1ResourceHandler

ATTACHMENT, auth, authCacheSize, DELETE, enableAppendLdapGroups, enableSessionFromHeader, FUNCTION_NAME_INSERT, FUNCTION_NAME_UPDATE, GET, HEAD, MAX_UPLOAD_SIZE, multipartparams, params, POST, proxyKey, PUT, request, RESOURCE_ACCESS_RULES, RESOURCE_BASE_URL, RESOURCE_IS_AUTHORIZED, RESOURCE_LOG, RESOURCE_META, RESOURCE_OBJECTS, RESOURCE_QUERY, response, session

Constructor Summary

Constructors

Constructor	Description
MNResourceHandler(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)	Initializes new instance by setting servlet context,request and response

Method Summary

Modifier and Type	Method	Description
protected org.dataone.service.exceptions.SynchronizationFailed	collectSynchronizationFailed()
protected void	getObject(String pid)	Implements REST version of DataONE CRUD API --> get
protected void	getPackage(String pid)	Retrieve data package as Bagit zip
protected void	getSystemMetadataObject(String pid)	Retrieve System Metadata
void	handle(byte httpVerb)	This function is called from REST API servlet and handles each request to the servlet
protected boolean	isD1Enabled()	subclasses should provide a more useful implementation
protected void	publish(String pid)
protected void	putObject(String trailingPid, String action)	Inserts or updates the object

Methods inherited from class edu.ucsb.nceas.metacat.restservice.D1ResourceHandler

collectMultipartFiles, collectMultipartParams, collectObjectFiles, decode, getSessionFromHeader, getTempDirectory, initMultipartParams, initParams, parseTrailing, printError, serializeException

Methods inherited from class java.lang.Object

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

Field Details

RESOURCE_MONITOR

protected static final String RESOURCE_MONITOR

See Also:

• Constant Field Values

RESOURCE_REPLICATE

protected static final String RESOURCE_REPLICATE

See Also:

• Constant Field Values

RESOURCE_REPLICAS

protected static final String RESOURCE_REPLICAS

See Also:

• Constant Field Values

RESOURCE_NODE

protected static final String RESOURCE_NODE

See Also:

• Constant Field Values

RESOURCE_ERROR

protected static final String RESOURCE_ERROR

See Also:

• Constant Field Values

RESOURCE_META_CHANGED

protected static final String RESOURCE_META_CHANGED

See Also:

• Constant Field Values

RESOURCE_GENERATE_ID

protected static final String RESOURCE_GENERATE_ID

See Also:

• Constant Field Values

RESOURCE_PUBLISH

protected static final String RESOURCE_PUBLISH

See Also:

• Constant Field Values

RESOURCE_PACKAGE

protected static final String RESOURCE_PACKAGE

See Also:

• Constant Field Values

RESOURCE_VIEWS

protected static final String RESOURCE_VIEWS

See Also:

• Constant Field Values

RESOURCE_TOKEN

protected static final String RESOURCE_TOKEN

See Also:

• Constant Field Values

Constructor Details

MNResourceHandler

public MNResourceHandler(javax.servlet.http.HttpServletRequest request,
 javax.servlet.http.HttpServletResponse response)

Initializes new instance by setting servlet context,request and response

Parameters:

request - the request that the handler will handle

response - the response that the handler will send back

Method Details

isD1Enabled

protected boolean isD1Enabled()

Description copied from class: D1ResourceHandler

subclasses should provide a more useful implementation

Overrides:

isD1Enabled in class D1ResourceHandler

Returns:

handle

public void handle(byte httpVerb)

This function is called from REST API servlet and handles each request to the servlet

Overrides:

handle in class D1ResourceHandler

Parameters:

httpVerb - (GET, POST, PUT or DELETE)

getObject

protected void getObject(String pid)
                  throws org.dataone.service.exceptions.InvalidToken,
org.dataone.service.exceptions.ServiceFailure,
org.dataone.service.exceptions.NotAuthorized,
org.dataone.service.exceptions.NotFound,
org.dataone.service.exceptions.InvalidRequest,
org.dataone.service.exceptions.NotImplemented,
IOException,
org.dataone.exceptions.MarshallingException,
org.dataone.service.exceptions.InsufficientResources

Implements REST version of DataONE CRUD API --> get

Parameters:

pid - ID of data object to be read

Throws:

org.dataone.service.exceptions.NotImplemented

org.dataone.service.exceptions.InvalidRequest

org.dataone.service.exceptions.NotFound

org.dataone.service.exceptions.NotAuthorized

org.dataone.service.exceptions.ServiceFailure

org.dataone.service.exceptions.InvalidToken

IOException

org.dataone.exceptions.MarshallingException

org.dataone.service.exceptions.InsufficientResources

getPackage

protected void getPackage(String pid)
                   throws org.dataone.service.exceptions.InvalidToken,
org.dataone.service.exceptions.ServiceFailure,
org.dataone.service.exceptions.NotAuthorized,
org.dataone.service.exceptions.NotFound,
org.dataone.service.exceptions.NotImplemented,
IOException,
org.dataone.service.exceptions.InvalidRequest

Retrieve data package as Bagit zip

Parameters:

pid -

Throws:

org.dataone.service.exceptions.NotImplemented

org.dataone.service.exceptions.NotFound

org.dataone.service.exceptions.NotAuthorized

org.dataone.service.exceptions.ServiceFailure

org.dataone.service.exceptions.InvalidToken

IOException

org.dataone.service.exceptions.InvalidRequest

publish

protected void publish(String pid)
                throws org.dataone.service.exceptions.InvalidToken,
org.dataone.service.exceptions.ServiceFailure,
org.dataone.service.exceptions.NotAuthorized,
org.dataone.service.exceptions.NotFound,
org.dataone.service.exceptions.NotImplemented,
IOException,
org.dataone.exceptions.MarshallingException,
org.dataone.service.exceptions.InvalidRequest,
org.dataone.service.exceptions.IdentifierNotUnique,
org.dataone.service.exceptions.UnsupportedType,
org.dataone.service.exceptions.InsufficientResources,
org.dataone.service.exceptions.InvalidSystemMetadata

Throws:

org.dataone.service.exceptions.InvalidToken

org.dataone.service.exceptions.ServiceFailure

org.dataone.service.exceptions.NotAuthorized

org.dataone.service.exceptions.NotFound

org.dataone.service.exceptions.NotImplemented

IOException

org.dataone.exceptions.MarshallingException

org.dataone.service.exceptions.InvalidRequest

org.dataone.service.exceptions.IdentifierNotUnique

org.dataone.service.exceptions.UnsupportedType

org.dataone.service.exceptions.InsufficientResources

org.dataone.service.exceptions.InvalidSystemMetadata

getSystemMetadataObject

protected void getSystemMetadataObject(String pid)
                                throws org.dataone.service.exceptions.InvalidToken,
org.dataone.service.exceptions.ServiceFailure,
org.dataone.service.exceptions.NotAuthorized,
org.dataone.service.exceptions.NotFound,
org.dataone.service.exceptions.InvalidRequest,
org.dataone.service.exceptions.NotImplemented,
IOException,
org.dataone.exceptions.MarshallingException

Retrieve System Metadata

Parameters:

pid -

Throws:

org.dataone.service.exceptions.InvalidToken

org.dataone.service.exceptions.ServiceFailure

org.dataone.service.exceptions.NotAuthorized

org.dataone.service.exceptions.NotFound

org.dataone.service.exceptions.InvalidRequest

org.dataone.service.exceptions.NotImplemented

IOException

org.dataone.exceptions.MarshallingException

putObject

protected void putObject(String trailingPid,
 String action)
                  throws org.dataone.service.exceptions.ServiceFailure,
org.dataone.service.exceptions.InvalidRequest,
org.dataone.exceptions.MarshallingException,
org.dataone.service.exceptions.InvalidToken,
org.dataone.service.exceptions.NotAuthorized,
org.dataone.service.exceptions.IdentifierNotUnique,
org.dataone.service.exceptions.UnsupportedType,
org.dataone.service.exceptions.InsufficientResources,
org.dataone.service.exceptions.InvalidSystemMetadata,
org.dataone.service.exceptions.NotImplemented,
org.dataone.service.exceptions.NotFound,
IOException,
InterruptedException,
InstantiationException,
IllegalAccessException,
NoSuchAlgorithmException,
org.apache.commons.fileupload.FileUploadException,
InvocationTargetException

Inserts or updates the object

Parameters:

pid - - ID of data object to be inserted or updated. If action is update, the pid is the existing pid. If insert, the pid is the new one

Throws:

org.dataone.service.exceptions.InvalidRequest

org.dataone.service.exceptions.ServiceFailure

org.dataone.exceptions.MarshallingException

org.dataone.service.exceptions.NotImplemented

org.dataone.service.exceptions.InvalidSystemMetadata

org.dataone.service.exceptions.InsufficientResources

org.dataone.service.exceptions.UnsupportedType

org.dataone.service.exceptions.IdentifierNotUnique

org.dataone.service.exceptions.NotAuthorized

org.dataone.service.exceptions.InvalidToken

org.dataone.service.exceptions.NotFound

IOException

IllegalAccessException

InstantiationException

org.apache.commons.fileupload.FileUploadException

NoSuchAlgorithmException

InterruptedException

InvocationTargetException

collectSynchronizationFailed

protected org.dataone.service.exceptions.SynchronizationFailed collectSynchronizationFailed()
                                                                                     throws IOException,
org.dataone.service.exceptions.ServiceFailure,
org.dataone.service.exceptions.InvalidRequest,
org.dataone.exceptions.MarshallingException,
InstantiationException,
IllegalAccessException,
ParserConfigurationException,
SAXException

Throws:

IOException

org.dataone.service.exceptions.ServiceFailure

org.dataone.service.exceptions.InvalidRequest

org.dataone.exceptions.MarshallingException

InstantiationException

IllegalAccessException

ParserConfigurationException

SAXException