org.dspace.curate

Class Curator

java.lang.Object

org.dspace.curate.Curator

public class Curator
extends java.lang.Object

Curator orchestrates and manages the application of a one or more curation tasks to a DSpace object. It provides common services and runtime environment to the tasks.

Author:

richardrodgers

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Curator.Invoked
static class	Curator.TxScope

Field Summary

Fields

Modifier and Type	Field and Description
static int	CURATE_ERROR task encountered a error in processing
static int	CURATE_FAIL task failed
static int	CURATE_NOTASK Curator unable to find requested task
static int	CURATE_SKIP task was not applicable to passed object
static int	CURATE_SUCCESS task completed successfully
static int	CURATE_UNSET no assigned status code - typically because task not yet performed

Constructor Summary

Constructors

Constructor and Description
Curator() No-arg constructor

Method Summary

Methods

Modifier and Type	Method and Description
Curator	addTask(java.lang.String taskName) Add a task to the set to be performed.
void	clear() Removes all configured tasks from the Curator.
void	curate(Context c, java.lang.String id) Performs all configured tasks upon object identified by id.
void	curate(DSpaceObject dso) Performs all configured tasks upon DSpace object (Community, Collection or Item).
static Context	curationContext() Returns the context object used in the current curation thread.
java.lang.String	getResult(java.lang.String taskName) Returns the result string for the latest performance of the named task.
int	getStatus(java.lang.String taskName) Returns the status code for the latest performance of the named task.
boolean	hasTask(java.lang.String taskName) Returns whether this curator has the specified task
static boolean	isContainer(DSpaceObject dso) Returns whether a given DSO is a 'container' - collection or community
void	queue(Context c, java.lang.String id, java.lang.String queueId) Places a curation request for the object identified by id on a managed queue named by the queueId.
Curator	removeTask(java.lang.String taskName) Removes a task from the set to be performed.
void	report(java.lang.String message) Adds a message to the configured reporting stream.
Curator	setCacheLimit(int limit) Sets an upper limit for the number of objects in the context cache used in a curation, if context accessible.
Curator	setInvoked(Curator.Invoked mode) Assigns invocation mode.
Curator	setReporter(java.lang.String reporter) Sets the reporting stream for this curator.
void	setResult(java.lang.String taskName, java.lang.String result) Assigns a result to the performance of the named task.
Curator	setTransactionScope(Curator.TxScope scope) Defines the transactional scope of curator executions.

Methods inherited from class java.lang.Object

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

Field Detail

CURATE_NOTASK

public static final int CURATE_NOTASK

Curator unable to find requested task

See Also:

Constant Field Values

CURATE_UNSET

public static final int CURATE_UNSET

no assigned status code - typically because task not yet performed

See Also:

Constant Field Values

CURATE_ERROR

public static final int CURATE_ERROR

task encountered a error in processing

See Also:

Constant Field Values

CURATE_SUCCESS

public static final int CURATE_SUCCESS

task completed successfully

See Also:

Constant Field Values

CURATE_FAIL

public static final int CURATE_FAIL

task failed

See Also:

Constant Field Values

CURATE_SKIP

public static final int CURATE_SKIP

task was not applicable to passed object

See Also:

Constant Field Values

Constructor Detail

Curator

public Curator()

No-arg constructor

Method Detail

addTask

public Curator addTask(java.lang.String taskName)

Add a task to the set to be performed. Caller should make no assumptions on execution ordering.

Parameters:

taskName - - logical name of task

Returns:

this curator - to support concatenating invocation style

hasTask

public boolean hasTask(java.lang.String taskName)

Returns whether this curator has the specified task

Parameters:

taskName - - logical name of the task

Returns:

true if task has been configured, else false

removeTask

public Curator removeTask(java.lang.String taskName)

Removes a task from the set to be performed.

Parameters:

taskName - - logical name of the task

Returns:

this curator - to support concatenating invocation style

setInvoked

public Curator setInvoked(Curator.Invoked mode)

Assigns invocation mode.

Parameters:

mode - one of INTERACTIVE, BATCH, ANY

Returns:

the Curator instance.

setReporter

public Curator setReporter(java.lang.String reporter)

Sets the reporting stream for this curator.

Parameters:

reporter - name of reporting stream. The name '-' causes reporting to standard out.

Returns:

the Curator instance

setCacheLimit

public Curator setCacheLimit(int limit)

Sets an upper limit for the number of objects in the context cache used in a curation, if context accessible. Note that for many forms of invocation, the context is not accessible. If limit is reached, context cache will be emptied. The default is no limit.

setTransactionScope

public Curator setTransactionScope(Curator.TxScope scope)

Defines the transactional scope of curator executions. The default is 'open' meaning that no commits are performed by the framework during curation. A scope of 'curation' means that a single commit will occur after the entire performance is complete, and a scope of 'object' will commit for each object (e.g. item) encountered in a given execution.

curate

public void curate(Context c,
          java.lang.String id)
            throws java.io.IOException

Performs all configured tasks upon object identified by id. If the object can be resolved as a handle, the DSO will be the target object.

Parameters:

c - a Dpace context

id - an object identifier

Throws:

java.io.IOException

curate

public void curate(DSpaceObject dso)
            throws java.io.IOException

Performs all configured tasks upon DSpace object (Community, Collection or Item).

Note: Site-wide tasks will default to running as an Anonymous User unless you call the Site-wide task via the 'curate(Context,String)' method with an authenticated Context object.

Parameters:

dso - the DSpace object

Throws:

java.io.IOException

queue

public void queue(Context c,
         java.lang.String id,
         java.lang.String queueId)
           throws java.io.IOException

Places a curation request for the object identified by id on a managed queue named by the queueId.

Parameters:

c - A DSpace context

id - an object Id

queueId - name of a queue. If queue does not exist, it will be created automatically.

Throws:

java.io.IOException

clear

public void clear()

Removes all configured tasks from the Curator.

report

public void report(java.lang.String message)

Adds a message to the configured reporting stream.

Parameters:

message - the message to output to the reporting stream.

getStatus

public int getStatus(java.lang.String taskName)

Returns the status code for the latest performance of the named task.

Parameters:

taskName - the task name

Returns:

the status code - one of CURATE_ values

getResult

public java.lang.String getResult(java.lang.String taskName)

Returns the result string for the latest performance of the named task.

Parameters:

taskName - the task name

Returns:

the result string, or null if task has not set it.

setResult

public void setResult(java.lang.String taskName,
             java.lang.String result)

Assigns a result to the performance of the named task.

Parameters:

taskName - the task name

result - a string indicating results of performing task.

curationContext

public static Context curationContext()
                               throws java.sql.SQLException

Returns the context object used in the current curation thread. This is primarily a utility method to allow tasks access to the context when necessary.

If the context is null or not set, then this just returns a brand new Context object representing an Anonymous User.

Returns:

curation thread's Context object (or a new, anonymous Context if no curation Context exists)

Throws:

java.sql.SQLException

isContainer

public static boolean isContainer(DSpaceObject dso)

Returns whether a given DSO is a 'container' - collection or community

Parameters:

dso - a DSpace object

Returns:

true if a container, false otherwise