org.dspace.license.service

Interface CreativeCommonsService

All Known Implementing Classes:

CreativeCommonsServiceImpl

public interface CreativeCommonsService

Service interface class for the Creative commons licensing. The implementation of this class is responsible for all business logic calls for the Creative commons licensing and is autowired by spring

Author:

kevinvandevelde at atmire.com

Field Summary

Fields

Modifier and Type	Field and Description
static String	CC_BUNDLE_NAME

Method Summary

Methods

Modifier and Type	Method and Description
String	fetchLicenseRDF(org.jdom.Document license) Apply same transformation on the document to retrieve only the most relevant part of the document passed as parameter.
LicenseMetadataValue	getCCField(String fieldId) Get a few license-specific properties.
String	getLicenseRDF(Context context, Item item)
Bitstream	getLicenseRdfBitstream(Item item) Get Creative Commons license RDF, returning Bitstream object.
Bitstream	getLicenseTextBitstream(Item item) Deprecated. to make uniform JSPUI and XMLUI approach the bitstream with the license in the textual format it is no longer stored (see https://jira.duraspace.org/browse/DS-2604)
String	getLicenseURL(Context context, Item item)
boolean	hasLicense(Context context, Item item)
boolean	isEnabled() Simple accessor for enabling of CC
void	removeLicense(Context context, Item item)
void	removeLicense(Context context, LicenseMetadataValue uriField, LicenseMetadataValue nameField, Item item) Remove license information, delete also the bitstream
void	setLicense(Context context, Item item, InputStream licenseStm, String mimeType) Used by DSpaceMetsIngester
void	setLicenseRDF(Context context, Item item, String licenseRdf) setLicenseRDF CC Web Service method for setting the RDF bitstream

Field Detail

CC_BUNDLE_NAME

static final String CC_BUNDLE_NAME

See Also:

Constant Field Values

Method Detail

isEnabled

boolean isEnabled()

Simple accessor for enabling of CC

setLicenseRDF

void setLicenseRDF(Context context,
                 Item item,
                 String licenseRdf)
                   throws SQLException,
                          IOException,
                          AuthorizeException

setLicenseRDF CC Web Service method for setting the RDF bitstream

Throws:

SQLException

IOException

AuthorizeException

setLicense

void setLicense(Context context,
              Item item,
              InputStream licenseStm,
              String mimeType)
                throws SQLException,
                       IOException,
                       AuthorizeException

Used by DSpaceMetsIngester

Parameters:

context -

item -

licenseStm -

mimeType -

Throws:

SQLException - if database error

IOException - if IO error

AuthorizeException - if authorization error * // PATCHED 12/01 FROM JIRA re: mimetypes for CCLicense and License RDF wjb

removeLicense

void removeLicense(Context context,
                 Item item)
                   throws SQLException,
                          IOException,
                          AuthorizeException

Throws:

SQLException

IOException

AuthorizeException

hasLicense

boolean hasLicense(Context context,
                 Item item)
                   throws SQLException,
                          IOException

Throws:

SQLException

IOException

getLicenseURL

String getLicenseURL(Context context,
                   Item item)
                     throws SQLException,
                            IOException,
                            AuthorizeException

Throws:

SQLException

IOException

AuthorizeException

getLicenseRDF

String getLicenseRDF(Context context,
                   Item item)
                     throws SQLException,
                            IOException,
                            AuthorizeException

Throws:

SQLException

IOException

AuthorizeException

getLicenseRdfBitstream

Bitstream getLicenseRdfBitstream(Item item)
                                 throws SQLException,
                                        IOException,
                                        AuthorizeException

Get Creative Commons license RDF, returning Bitstream object.

Returns:

bitstream or null.

Throws:

SQLException

IOException

AuthorizeException

getLicenseTextBitstream

Bitstream getLicenseTextBitstream(Item item)
                                  throws SQLException,
                                         IOException,
                                         AuthorizeException

Deprecated. to make uniform JSPUI and XMLUI approach the bitstream with the license in the textual format it is no longer stored (see https://jira.duraspace.org/browse/DS-2604)

Get Creative Commons license Text, returning Bitstream object.

Returns:

bitstream or null.

Throws:

SQLException

IOException

AuthorizeException

getCCField

LicenseMetadataValue getCCField(String fieldId)

Get a few license-specific properties. We expect these to be cached at least per server run.

fetchLicenseRDF

String fetchLicenseRDF(org.jdom.Document license)

Apply same transformation on the document to retrieve only the most relevant part of the document passed as parameter. If no transformation is needed then take in consideration to empty the CreativeCommons.xml

Parameters:

license - - an element that could be contains as part of your content the license rdf

Returns:

the document license in textual format after the transformation

removeLicense

void removeLicense(Context context,
                 LicenseMetadataValue uriField,
                 LicenseMetadataValue nameField,
                 Item item)
                   throws AuthorizeException,
                          IOException,
                          SQLException

Remove license information, delete also the bitstream

Parameters:

context - - DSpace Context

uriField - - the metadata field for license uri

nameField - - the metadata field for license name

item - - the item

Throws:

AuthorizeException

IOException

SQLException