org.dspace.rest

Class Resource

java.lang.Object

org.dspace.rest.Resource

Direct Known Subclasses:

BitstreamResource, CollectionsResource, CommunitiesResource, FilteredCollectionsResource, FilteredItemsResource, HandleResource, HierarchyResource, ItemsResource, MetadataRegistryResource

public class Resource
extends Object

Superclass of all resource classes in REST API. It has methods for creating context, write statistics, processsing exceptions, splitting a key of metadata, string representation of action and method for getting the logged in user from the token in request header.

Author:

Rostislav Novak (Computing and Information Centre, CTU in Prague)

Field Summary

Fields

Modifier and Type	Field and Description
javax.servlet.ServletContext	servletContext

Constructor Summary

Constructors

Constructor and Description
Resource()

Method Summary

Modifier and Type	Method and Description
protected static Context	createContext() Create context to work with DSpace database.
protected String	getActionString(int action) Return string representation of values org.dspace.core.Constants.{READ,WRITE,DELETE}.
protected String[]	mySplit(String key) Split string with regex ".".
protected static void	processException(String message, Context context) Process exception, print message to logger error stream and abort DSpace context.
protected void	processFinally(Context context) Process finally statement.
protected void	writeStats(DSpaceObject dspaceObject, UsageEvent.Action action, String user_ip, String user_agent, String xforwardedfor, javax.ws.rs.core.HttpHeaders headers, javax.servlet.http.HttpServletRequest request, Context context) Records a statistics event about an object used via REST API.

Methods inherited from class java.lang.Object

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

Field Detail

servletContext

@Context
public javax.servlet.ServletContext servletContext

Constructor Detail

Resource

public Resource()

Method Detail

createContext

protected static Context createContext()
                                throws ContextException,
                                       SQLException

Create context to work with DSpace database. It can create context with or without a logged in user (retrieved from SecurityContextHolder). Throws WebApplicationException caused by: SQLException if there was a problem with reading from database. Throws AuthorizeException if there was a problem with authorization to read from the database. Throws Exception if there was a problem creating context.

Returns:

Newly created context with the logged in user unless the specified user was null. If user is null, create the context without a logged in user.

Throws:

ContextException - Thrown in case of a problem creating context. Can be caused by SQLException error in creating context or finding the user to log in. Can be caused by AuthorizeException if there was a problem authorizing the found user.

SQLException

writeStats

protected void writeStats(DSpaceObject dspaceObject,
                          UsageEvent.Action action,
                          String user_ip,
                          String user_agent,
                          String xforwardedfor,
                          javax.ws.rs.core.HttpHeaders headers,
                          javax.servlet.http.HttpServletRequest request,
                          Context context)

Records a statistics event about an object used via REST API.

Parameters:

dspaceObject - DSpace object on which a request was performed.

action - Action that was performed.

user_ip -

user_agent -

xforwardedfor -

headers -

request -

context -

processException

protected static void processException(String message,
                                       Context context)
                                throws javax.ws.rs.WebApplicationException

Process exception, print message to logger error stream and abort DSpace context.

Parameters:

message - Message, which will be printed to error stream.

context - Context which must be aborted.

Throws:

javax.ws.rs.WebApplicationException - This exception is throw for user of REST api.

processFinally

protected void processFinally(Context context)
                       throws javax.ws.rs.WebApplicationException

Process finally statement. It will print message to logger error stream and abort DSpace context, if was not properly ended.

Parameters:

context - Context which must be aborted.

Throws:

javax.ws.rs.WebApplicationException - This exception is throw for user of REST api.

mySplit

protected String[] mySplit(String key)

Split string with regex ".".

Parameters:

key - String which will be splitted.

Returns:

String array filed with separated string.

getActionString

protected String getActionString(int action)

Return string representation of values org.dspace.core.Constants.{READ,WRITE,DELETE}.

Parameters:

action - Constant from org.dspace.core.Constants.*

Returns:

String representation. read or write or delete.