org.dspace.license

Class CreativeCommonsServiceImpl

java.lang.Object

org.dspace.license.CreativeCommonsServiceImpl

All Implemented Interfaces:

CreativeCommonsService, org.springframework.beans.factory.InitializingBean

public class CreativeCommonsServiceImpl
extends Object
implements CreativeCommonsService, org.springframework.beans.factory.InitializingBean

Field Summary

Fields

Modifier and Type	Field and Description
protected BitstreamFormatService	bitstreamFormatService
protected BitstreamService	bitstreamService
protected static String	BSN_LICENSE_RDF
protected static String	BSN_LICENSE_TEXT
protected static String	BSN_LICENSE_URL Some BitStream Names (BSN)
protected BundleService	bundleService
protected static String	CC_BS_SOURCE The Bundle Name
protected ItemService	itemService
protected Templates	templates

Fields inherited from interface org.dspace.license.service.CreativeCommonsService

CC_BUNDLE_NAME

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CreativeCommonsServiceImpl()

Method Summary

Methods

Modifier and Type	Method and Description
void	afterPropertiesSet()
String	fetchLicenseRdf(String ccResult)
String	fetchLicenseRDF(String license_url)
String	fetchLicenseText(String license_url) Get a few license-specific properties.
protected byte[]	fetchURL(String url_string) Fetch the contents of a URL
protected Bitstream	getBitstream(Item item, String bitstream_name) This helper method retrieves the bytes of a bitstream for an item under the CC bundle, with the given bitstream name
protected byte[]	getBytesFromBitstream(Context context, Item item, String bitstream_name)
protected Bundle	getCcBundle(Context context, Item item)
LicenseMetadataValue	getCCField(String fieldId) Returns a metadata field handle for given field Id
String	getLicenseRDF(Context context, Item item)
Bitstream	getLicenseRdfBitstream(Item item) Get Creative Commons license RDF, returning Bitstream object.
String	getLicenseText(Context context, Item item)
Bitstream	getLicenseTextBitstream(Item item) Get Creative Commons license Text, returning Bitstream object.
String	getLicenseURL(Context context, Item item)
protected String	getStringFromBitstream(Context context, Item item, String bitstream_name) This helper method wraps a String around a byte array returned from the bitstream method further down
boolean	hasLicense(Context context, Item item)
boolean	isEnabled() Simple accessor for enabling of CC
void	removeLicense(Context context, Item item)
protected void	setBitstreamFromBytes(Context context, Item item, Bundle bundle, String bitstream_name, BitstreamFormat format, byte[] bytes) This helper method takes some bytes and stores them as a bitstream for an item, under the CC bundle, with the given bitstream name
void	setLicense(Context context, Item item, InputStream licenseStm, String mimeType) Used by DSpaceMetsIngester
void	setLicense(Context context, Item item, String cc_license_url) This is a bit of the "do-the-right-thing" method for CC stuff in an item
void	setLicenseRDF(Context context, Item item, String licenseRdf) setLicenseRDF CC Web Service method for setting the RDF bitstream

Methods inherited from class java.lang.Object

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

Field Detail

CC_BS_SOURCE

protected static final String CC_BS_SOURCE

The Bundle Name

See Also:

Constant Field Values

BSN_LICENSE_URL

protected static final String BSN_LICENSE_URL

Some BitStream Names (BSN)

See Also:

Constant Field Values

BSN_LICENSE_TEXT

protected static final String BSN_LICENSE_TEXT

See Also:

Constant Field Values

BSN_LICENSE_RDF

protected static final String BSN_LICENSE_RDF

See Also:

Constant Field Values

templates

protected Templates templates

bitstreamService

@Autowired(required=true)
protected BitstreamService bitstreamService

bitstreamFormatService

@Autowired(required=true)
protected BitstreamFormatService bitstreamFormatService

bundleService

@Autowired(required=true)
protected BundleService bundleService

itemService

@Autowired(required=true)
protected ItemService itemService

Constructor Detail

CreativeCommonsServiceImpl

protected CreativeCommonsServiceImpl()

Method Detail

afterPropertiesSet

public void afterPropertiesSet()
                        throws Exception

Specified by:

afterPropertiesSet in interface org.springframework.beans.factory.InitializingBean

Throws:

Exception

isEnabled

public boolean isEnabled()

Description copied from interface: CreativeCommonsService

Simple accessor for enabling of CC

Specified by:

isEnabled in interface CreativeCommonsService

getCcBundle

protected Bundle getCcBundle(Context context,
                 Item item)
                      throws SQLException,
                             AuthorizeException,
                             IOException

Throws:

SQLException

AuthorizeException

IOException

setLicenseRDF

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

Description copied from interface: CreativeCommonsService

setLicenseRDF CC Web Service method for setting the RDF bitstream

Specified by:

setLicenseRDF in interface CreativeCommonsService

Throws:

SQLException

IOException

AuthorizeException

setLicense

public void setLicense(Context context,
              Item item,
              String cc_license_url)
                throws SQLException,
                       IOException,
                       AuthorizeException

Description copied from interface: CreativeCommonsService

This is a bit of the "do-the-right-thing" method for CC stuff in an item

Specified by:

setLicense in interface CreativeCommonsService

Throws:

SQLException

IOException

AuthorizeException

setLicense

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

Description copied from interface: CreativeCommonsService

Used by DSpaceMetsIngester

Specified by:

setLicense in interface CreativeCommonsService

Throws:

SQLException

IOException

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

removeLicense

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

Specified by:

removeLicense in interface CreativeCommonsService

Throws:

SQLException

IOException

AuthorizeException

hasLicense

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

Specified by:

hasLicense in interface CreativeCommonsService

Throws:

SQLException

IOException

getLicenseURL

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

Specified by:

getLicenseURL in interface CreativeCommonsService

Throws:

SQLException

IOException

AuthorizeException

getLicenseText

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

Specified by:

getLicenseText in interface CreativeCommonsService

Throws:

SQLException

IOException

AuthorizeException

getLicenseRDF

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

Specified by:

getLicenseRDF in interface CreativeCommonsService

Throws:

SQLException

IOException

AuthorizeException

getLicenseRdfBitstream

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

Description copied from interface: CreativeCommonsService

Get Creative Commons license RDF, returning Bitstream object.

Specified by:

getLicenseRdfBitstream in interface CreativeCommonsService

Returns:

bitstream or null.

Throws:

SQLException

IOException

AuthorizeException

getLicenseTextBitstream

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

Description copied from interface: CreativeCommonsService

Get Creative Commons license Text, returning Bitstream object.

Specified by:

getLicenseTextBitstream in interface CreativeCommonsService

Returns:

bitstream or null.

Throws:

SQLException

IOException

AuthorizeException

fetchLicenseRdf

public String fetchLicenseRdf(String ccResult)

Specified by:

fetchLicenseRdf in interface CreativeCommonsService

fetchLicenseText

public String fetchLicenseText(String license_url)

Description copied from interface: CreativeCommonsService

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

Specified by:

fetchLicenseText in interface CreativeCommonsService

fetchLicenseRDF

public String fetchLicenseRDF(String license_url)

Specified by:

fetchLicenseRDF in interface CreativeCommonsService

setBitstreamFromBytes

protected void setBitstreamFromBytes(Context context,
                         Item item,
                         Bundle bundle,
                         String bitstream_name,
                         BitstreamFormat format,
                         byte[] bytes)
                              throws SQLException,
                                     IOException,
                                     AuthorizeException

This helper method takes some bytes and stores them as a bitstream for an item, under the CC bundle, with the given bitstream name

Throws:

SQLException

IOException

AuthorizeException

getStringFromBitstream

protected String getStringFromBitstream(Context context,
                            Item item,
                            String bitstream_name)
                                 throws SQLException,
                                        IOException,
                                        AuthorizeException

This helper method wraps a String around a byte array returned from the bitstream method further down

Throws:

SQLException

IOException

AuthorizeException

getBitstream

protected Bitstream getBitstream(Item item,
                     String bitstream_name)
                          throws SQLException,
                                 IOException,
                                 AuthorizeException

This helper method retrieves the bytes of a bitstream for an item under the CC bundle, with the given bitstream name

Throws:

SQLException

IOException

AuthorizeException

getBytesFromBitstream

protected byte[] getBytesFromBitstream(Context context,
                           Item item,
                           String bitstream_name)
                                throws SQLException,
                                       IOException,
                                       AuthorizeException

Throws:

SQLException

IOException

AuthorizeException

fetchURL

protected byte[] fetchURL(String url_string)

Fetch the contents of a URL

getCCField

public LicenseMetadataValue getCCField(String fieldId)

Returns a metadata field handle for given field Id

Specified by:

getCCField in interface CreativeCommonsService