org.dspace.embargo

Class DefaultEmbargoSetter

java.lang.Object

org.dspace.embargo.DefaultEmbargoSetter

All Implemented Interfaces:

EmbargoSetter

Direct Known Subclasses:

DayTableEmbargoSetter

public class DefaultEmbargoSetter
extends java.lang.Object
implements EmbargoSetter

Default plugin implementation of the embargo setting function. The parseTerms() provides only very rudimentary terms logic - entry of a configurable string (in terms field) for 'unlimited' embargo, otherwise a standard ISO 8601 (yyyy-mm-dd) date is assumed. Users are encouraged to override this method for enhanced functionality.

Author:

Larry Stone, Richard Rodgers

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String	termsOpen

Constructor Summary

Constructors

Constructor and Description
DefaultEmbargoSetter()

Method Summary

Methods

Modifier and Type	Method and Description
void	checkEmbargo(Context context, Item item) Check that embargo is properly set on Item: no read access to bitstreams.
protected void	generatePolicies(Context context, java.util.Date embargoDate, java.lang.String reason, DSpaceObject dso, Collection owningCollection)
DCDate	parseTerms(Context context, Item item, java.lang.String terms) Parse the terms into a definite date.
void	setEmbargo(Context context, Item item) Enforce embargo by turning off all read access to bitstreams in this Item.

Methods inherited from class java.lang.Object

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

Field Detail

termsOpen

protected java.lang.String termsOpen

Constructor Detail

DefaultEmbargoSetter

public DefaultEmbargoSetter()

Method Detail

parseTerms

public DCDate parseTerms(Context context,
                Item item,
                java.lang.String terms)
                  throws java.sql.SQLException,
                         AuthorizeException,
                         java.io.IOException

Parse the terms into a definite date. Terms are expected to consist of either: a token (value configured in 'embargo.terms.open' property) to indicate indefinite embargo, or a literal lift date formatted in ISO 8601 format (yyyy-mm-dd)

Specified by:

parseTerms in interface EmbargoSetter

Parameters:

context - the DSpace context

item - the item to embargo

terms - the embargo terms

Returns:

parsed date in DCDate format

Throws:

java.sql.SQLException

AuthorizeException

java.io.IOException

setEmbargo

public void setEmbargo(Context context,
              Item item)
                throws java.sql.SQLException,
                       AuthorizeException,
                       java.io.IOException

Enforce embargo by turning off all read access to bitstreams in this Item.

Specified by:

setEmbargo in interface EmbargoSetter

Parameters:

context - the DSpace context

item - the item to embargo

Throws:

java.sql.SQLException

AuthorizeException

java.io.IOException

generatePolicies

protected void generatePolicies(Context context,
                    java.util.Date embargoDate,
                    java.lang.String reason,
                    DSpaceObject dso,
                    Collection owningCollection)
                         throws java.sql.SQLException,
                                AuthorizeException

Throws:

java.sql.SQLException

AuthorizeException

checkEmbargo

public void checkEmbargo(Context context,
                Item item)
                  throws java.sql.SQLException,
                         AuthorizeException,
                         java.io.IOException

Check that embargo is properly set on Item: no read access to bitstreams.

Specified by:

checkEmbargo in interface EmbargoSetter

Parameters:

context - the DSpace context

item - the item to embargo

Throws:

java.sql.SQLException

AuthorizeException

java.io.IOException