org.dspace.content.packager

Class DSpaceMETSDisseminator

java.lang.Object

org.dspace.content.packager.AbstractPackageDisseminator

org.dspace.content.packager.AbstractMETSDisseminator

org.dspace.content.packager.DSpaceMETSDisseminator

All Implemented Interfaces:

PackageDisseminator

public class DSpaceMETSDisseminator
extends AbstractMETSDisseminator

Packager plugin to produce a METS (Metadata Encoding and Transmission Standard) package that is accepted as a DSpace METS SIP (Submission Information Package). See http://www.loc.gov/standards/mets/ for more information on METS.

This class does not produce a true DSpace DIP, because there was no DIP standard when it was implemented. It does contain some features beyond the requirements of a SIP (e.g. deposit licenses), anticipating the DIP specification.

DSpaceMETSDisseminator was intended to be an useful example of a packager plugin, and a way to create packages acceptable to the METS SIP importer.

Version:

$Revision$

Author:

Larry Stone

Nested Class Summary

Nested classes/interfaces inherited from class org.dspace.content.packager.AbstractMETSDisseminator

AbstractMETSDisseminator.MdStreamCache

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	CREATIVE_COMMONS_RDF_MDTYPE
protected static String	CREATIVE_COMMONS_TEXT_MDTYPE
protected static String	DSPACE_DEPOSIT_LICENSE_MDTYPE
protected static String	PROFILE_LABEL Identifier for the package we produce, i.e.

Fields inherited from class org.dspace.content.packager.AbstractMETSDisseminator

authorizeService, bitstreamService, configurationService, creativeCommonsService, DEFAULT_MODIFIED_DATE, idCounter, outputter, siteService, TEMPLATE_TYPE_SUFFIX

Fields inherited from class org.dspace.content.packager.AbstractPackageDisseminator

communityService, itemService

Constructor Summary

Constructors

Constructor and Description
DSpaceMETSDisseminator()

Method Summary

Methods

Modifier and Type	Method and Description
void	addStructMap(Context context, DSpaceObject dso, PackageParameters params, edu.harvard.hul.ois.mets.Mets mets) Add any additional structMap elements to the METS document, as required by this subclass.
String	bundleToFileGrp(String bname) Returns name of METS fileGrp corresponding to a DSpace bundle name.
String[]	getDigiprovMdTypes(Context context, DSpaceObject dso, PackageParameters params) Get the type string of the "digiprov" (digital provenance) metadata to create for each object and each Bitstream in an Item.
String[]	getDmdTypes(Context context, DSpaceObject dso, PackageParameters params) Get DMD choice for Item.
String	getParameterHelp() Returns a user help string which should describe the additional valid command-line options that this packager implementation will accept when using the -o or --option flags with the Packager script.
String	getProfile() Return identifier string for the profile this produces.
String[]	getRightsMdTypes(Context context, DSpaceObject dso, PackageParameters params) Add rights MD (licenses) for DSpace item.
String[]	getSourceMdTypes(Context context, DSpaceObject dso, PackageParameters params) Get the type string of the source metadata to create for each object and each Bitstream in an Item.
String[]	getTechMdTypes(Context context, DSpaceObject dso, PackageParameters params) Get name of technical metadata crosswalk for Bitstreams.
boolean	includeBundle(Bundle bundle)
edu.harvard.hul.ois.mets.MetsHdr	makeMetsHdr(Context context, DSpaceObject dso, PackageParameters params) Create metsHdr element - separate so subclasses can override.

Methods inherited from class org.dspace.content.packager.AbstractMETSDisseminator

addAmdSec, addBitstreamsToZip, addLogoBitstream, addToAmdSec, crosswalkToMetsElement, disseminate, findOriginalBitstream, gensym, getHandleURN, getMIMEType, getObjectTypeString, linkLicenseRefsToBitstreams, makeBitstreamURL, makeChildDiv, makeFileDiv, makeManifest, makeMdSec, makePersistentID, resetCounter, setMdType, setMdType, writeZipPackage

Methods inherited from class org.dspace.content.packager.AbstractPackageDisseminator

addToPackageList, disseminateAll, getPackageList

Methods inherited from class java.lang.Object

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

Field Detail

PROFILE_LABEL

protected static final String PROFILE_LABEL

Identifier for the package we produce, i.e. DSpace METS SIP Profile. Though not strictly true, there is no DIP standard yet so it's the most meaningful label we can apply.

See Also:

Constant Field Values

DSPACE_DEPOSIT_LICENSE_MDTYPE

protected static final String DSPACE_DEPOSIT_LICENSE_MDTYPE

See Also:

Constant Field Values

CREATIVE_COMMONS_RDF_MDTYPE

protected static final String CREATIVE_COMMONS_RDF_MDTYPE

See Also:

Constant Field Values

CREATIVE_COMMONS_TEXT_MDTYPE

protected static final String CREATIVE_COMMONS_TEXT_MDTYPE

See Also:

Constant Field Values

Constructor Detail

DSpaceMETSDisseminator

public DSpaceMETSDisseminator()

Method Detail

getProfile

public String getProfile()

Return identifier string for the profile this produces.

Specified by:

getProfile in class AbstractMETSDisseminator

Returns:

string name of profile.

bundleToFileGrp

public String bundleToFileGrp(String bname)

Returns name of METS fileGrp corresponding to a DSpace bundle name. They are mostly the same except for bundle "ORIGINAL" maps to "CONTENT". Don't worry about the metadata bundles since they are not packaged as fileGrps, but in *mdSecs.

Specified by:

bundleToFileGrp in class AbstractMETSDisseminator

Parameters:

bname - name of DSpace bundle.

Returns:

string name of fileGrp

makeMetsHdr

public edu.harvard.hul.ois.mets.MetsHdr makeMetsHdr(Context context,
                                           DSpaceObject dso,
                                           PackageParameters params)

Create metsHdr element - separate so subclasses can override.

Specified by:

makeMetsHdr in class AbstractMETSDisseminator

Parameters:

context - context

dso - DSpaceObject

params - packaging params

Returns:

mets header

getDmdTypes

public String[] getDmdTypes(Context context,
                   DSpaceObject dso,
                   PackageParameters params)
                     throws SQLException,
                            IOException,
                            AuthorizeException

Get DMD choice for Item. It defaults to MODS, but is overridden by the package parameters if they contain any "dmd" keys. The params may contain one or more values for "dmd"; each of those is the name of a crosswalk plugin, optionally followed by colon and its METS MDTYPE name.

Specified by:

getDmdTypes in class AbstractMETSDisseminator

Parameters:

context - context

dso - DSpaceObject

params - the PackageParameters passed to the disseminator.

Returns:

array of DMD types

Throws:

IOException - if IO error

SQLException - if database error

AuthorizeException - if authorization error

getTechMdTypes

public String[] getTechMdTypes(Context context,
                      DSpaceObject dso,
                      PackageParameters params)
                        throws SQLException,
                               IOException,
                               AuthorizeException

Get name of technical metadata crosswalk for Bitstreams. Default is PREMIS. This is both the name of the crosswalk plugin and the METS MDTYPE.

Specified by:

getTechMdTypes in class AbstractMETSDisseminator

Parameters:

context - context

dso - DSpaceObject

params - the PackageParameters passed to the disseminator.

Returns:

array of TechMD types

Throws:

IOException - if IO error

SQLException - if database error

AuthorizeException - if authorization error

getSourceMdTypes

public String[] getSourceMdTypes(Context context,
                        DSpaceObject dso,
                        PackageParameters params)
                          throws SQLException,
                                 IOException,
                                 AuthorizeException

Description copied from class: AbstractMETSDisseminator

Get the type string of the source metadata to create for each object and each Bitstream in an Item. The type string may be a simple name or colon-separated compound as specified for getDmdTypes() above.

Specified by:

getSourceMdTypes in class AbstractMETSDisseminator

Parameters:

context - context

dso - DSpaceObject

params - the PackageParameters passed to the disseminator.

Returns:

array of metadata type strings, never null.

Throws:

SQLException - if database error

IOException - if IO error

AuthorizeException - if authorization error

getDigiprovMdTypes

public String[] getDigiprovMdTypes(Context context,
                          DSpaceObject dso,
                          PackageParameters params)
                            throws SQLException,
                                   IOException,
                                   AuthorizeException

Description copied from class: AbstractMETSDisseminator

Get the type string of the "digiprov" (digital provenance) metadata to create for each object and each Bitstream in an Item. The type string may be a simple name or colon-separated compound as specified for getDmdTypes() above.

Specified by:

getDigiprovMdTypes in class AbstractMETSDisseminator

Parameters:

context - context

dso - DSpaceObject

params - the PackageParameters passed to the disseminator.

Returns:

array of metadata type strings, never null.

Throws:

SQLException - if database error

IOException - if IO error

AuthorizeException - if authorization error

getRightsMdTypes

public String[] getRightsMdTypes(Context context,
                        DSpaceObject dso,
                        PackageParameters params)
                          throws SQLException,
                                 IOException,
                                 AuthorizeException

Add rights MD (licenses) for DSpace item. These may include a deposit license, and Creative Commons.

Specified by:

getRightsMdTypes in class AbstractMETSDisseminator

Parameters:

context - context

dso - DSpaceObject

params - the PackageParameters passed to the disseminator.

Returns:

array of RightsMD types

Throws:

IOException - if IO error

SQLException - if database error

AuthorizeException - if authorization error

addStructMap

public void addStructMap(Context context,
                DSpaceObject dso,
                PackageParameters params,
                edu.harvard.hul.ois.mets.Mets mets)
                  throws SQLException,
                         IOException,
                         AuthorizeException,
                         edu.harvard.hul.ois.mets.helper.MetsException

Description copied from class: AbstractMETSDisseminator

Add any additional structMap elements to the METS document, as required by this subclass. A simple default structure map which fulfills the minimal DSpace METS DIP/SIP requirements is already present, so this does not need to do anything.

Specified by:

addStructMap in class AbstractMETSDisseminator

Parameters:

context - context

dso - DSpaceObject

params - the PackageParameters passed to the disseminator.

mets - the METS document to which to add structMaps

Throws:

SQLException - if database error

IOException - if IO error

AuthorizeException - if authorization error

edu.harvard.hul.ois.mets.helper.MetsException - if METS error

includeBundle

public boolean includeBundle(Bundle bundle)

Specified by:

includeBundle in class AbstractMETSDisseminator

Parameters:

bundle - bundle

Returns:

true when this bundle should be included as "content" in the package.. e.g. DSpace SIP does not include metadata bundles.

getParameterHelp

public String getParameterHelp()

Returns a user help string which should describe the additional valid command-line options that this packager implementation will accept when using the -o or --option flags with the Packager script.

Specified by:

getParameterHelp in interface PackageDisseminator

Overrides:

getParameterHelp in class AbstractMETSDisseminator

Returns:

a string describing additional command-line options available with this packager