AbstractMETSDisseminator (DSpace Kernel :: API and Implementation 5.0-rc3 API)

java.lang.Object
- org.dspace.content.packager.AbstractPackageDisseminator
- - org.dspace.content.packager.AbstractMETSDisseminator

All Implemented Interfaces:

PackageDisseminator

Direct Known Subclasses:

DSpaceAIPDisseminator, DSpaceMETSDisseminator
```
public abstract class AbstractMETSDisseminator
extends AbstractPackageDisseminator
```
Base class for disseminator of METS (Metadata Encoding & Transmission Standard) Package.
See http://www.loc.gov/standards/mets/
This is a generic packager framework intended to be subclassed to create packagers for more specific METS "profiles". METS is an abstract and flexible framework that can encompass many different kinds of metadata and inner package structures.
Package Parameters:
- manifestOnly -- if true, generate a standalone XML document of the METS manifest instead of a complete package. Any other metadata (such as licenses) will be encoded inline. Default is false.
- unauthorized -- this determines what is done when the packager encounters a Bundle or Bitstream it is not authorized to read. By default, it just quits with an AuthorizeException. If this option is present, it must be one of the following values:
  - skip -- simply exclude unreadable content from package.
  - zero -- include unreadable bitstreams as 0-length files; unreadable Bundles will still cause authorize errors.
Version:

$Revision$

Author:

Larry Stone, Robert Tansley, Tim Donohue

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected static class`	`AbstractMETSDisseminator.MdStreamCache` Wrapper for a table of streams to add to the package, such as mdRef'd metadata.

Field Summary

Fields
Modifier and Type Field and Description

protected static String TEMPLATE_TYPE_SUFFIX
Suffix for Template objects (e.g.

Fields
Modifier and Type	Field and Description
`protected static String`	`TEMPLATE_TYPE_SUFFIX` Suffix for Template objects (e.g.

Constructor Summary

Constructors
Constructor and Description

AbstractMETSDisseminator()

Constructors
Constructor and Description
`AbstractMETSDisseminator()`

Method Summary

Methods
Modifier and Type	Method and Description
`protected String`	`addAmdSec(Context context, DSpaceObject dso, PackageParameters params, edu.harvard.hul.ois.mets.Mets mets, AbstractMETSDisseminator.MdStreamCache extraStreams)`
`protected void`	`addBitstreamsToZip(Context context, DSpaceObject dso, PackageParameters params, ZipOutputStream zip)` Add Bitstreams associated with a given DSpace Object into an existing ZipOutputStream
`protected void`	`addLogoBitstream(Bitstream logoBs, edu.harvard.hul.ois.mets.FileSec fileSec, edu.harvard.hul.ois.mets.Div div0, PackageParameters params)`
`abstract 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.
`protected void`	`addToAmdSec(edu.harvard.hul.ois.mets.AmdSec fAmdSec, String[] mdTypes, Class mdSecClass, Context context, DSpaceObject dso, PackageParameters params, AbstractMETSDisseminator.MdStreamCache extraStreams)`
`abstract String`	`bundleToFileGrp(String bname)` Returns fileGrp's USE attribute value corresponding to a DSpace bundle name.
`void`	`disseminate(Context context, DSpaceObject dso, PackageParameters params, File pkgFile)` Export the object (Item, Collection, or Community) as a "package" on the indicated OutputStream.
`protected static Bitstream`	`findOriginalBitstream(Item item, Bitstream derived)` For a bitstream that's a thumbnail or extracted text, find the corresponding bitstream it was derived from, in the ORIGINAL bundle.
`protected String`	`gensym(String prefix)` Make a new unique ID symbol with specified prefix.
`abstract 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.
`abstract String[]`	`getDmdTypes(Context context, DSpaceObject dso, PackageParameters params)` Get the types of Item-wide DMD to include in package.
`protected String`	`getHandleURN(String handle)`
`String`	`getMIMEType(PackageParameters params)` Identifies the MIME-type of this package, e.g.
`String`	`getObjectTypeString(DSpaceObject dso)` Build a string which will be used as the "Type" of this object in the METS manifest.
`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.
`abstract String`	`getProfile()` Returns name of METS profile to which this package conforms, e.g.
`abstract String[]`	`getRightsMdTypes(Context context, DSpaceObject dso, PackageParameters params)` Get the type string of the "rights" (permission and/or license) metadata to create for each object and each Bitstream in an Item.
`abstract 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.
`abstract String[]`	`getTechMdTypes(Context context, DSpaceObject dso, PackageParameters params)` Get the type string of the technical metadata to create for each object and each Bitstream in an Item.
`abstract boolean`	`includeBundle(Bundle bundle)`
`protected void`	`linkLicenseRefsToBitstreams(Context context, PackageParameters params, DSpaceObject dso, edu.harvard.hul.ois.mets.MdRef mdRef)` Cleanup our license file reference links, as Deposit Licenses & CC Licenses can be added two ways (and we only want to add them to zip package once): (1) Added as a normal Bitstream (assuming LICENSE and CC_LICENSE bundles will be included in pkg) (2) Added via a 'rightsMD' crosswalk (as they are rights information/metadata on an Item)
`String`	`makeBitstreamURL(Bitstream bitstream, PackageParameters params)` Get the URL by which the METS manifest refers to a Bitstream member within the same package.
`protected edu.harvard.hul.ois.mets.Div`	`makeChildDiv(String type, DSpaceObject dso, PackageParameters params)` Create a element with which references a child object via its handle (and via a local file name, when recursively disseminating all child objects).
`protected edu.harvard.hul.ois.mets.Div`	`makeFileDiv(String fileID, String type)`
`protected edu.harvard.hul.ois.mets.Mets`	`makeManifest(Context context, DSpaceObject dso, PackageParameters params, AbstractMETSDisseminator.MdStreamCache extraStreams)` Write out a METS manifest.
`protected edu.harvard.hul.ois.mets.helper.MdSec`	`makeMdSec(Context context, DSpaceObject dso, Class mdSecClass, String typeSpec, PackageParameters params, AbstractMETSDisseminator.MdStreamCache extraStreams)` Create an element wrapped around a metadata reference (either mdWrap or mdRef); i.e.
`abstract edu.harvard.hul.ois.mets.MetsHdr`	`makeMetsHdr(Context context, DSpaceObject dso, PackageParameters params)` Create metsHdr element - separate so subclasses can override.
`protected String`	`makePersistentID(DSpaceObject dso)`
`protected void`	`resetCounter()` Resets the unique ID counter used by gensym() method to determine the @ID values of METS tags.
`protected void`	`setMdType(edu.harvard.hul.ois.mets.MdRef mdRef, String mdtype)`
`protected void`	`setMdType(edu.harvard.hul.ois.mets.MdWrap mdWrap, String mdtype)`
`protected void`	`writeZipPackage(Context context, DSpaceObject dso, PackageParameters params, OutputStream pkg)` Make a Zipped up METS package for the given DSpace Object

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
- TEMPLATE_TYPE_SUFFIX
```
protected static final String TEMPLATE_TYPE_SUFFIX
```
  Suffix for Template objects (e.g. Item Templates)
  
  See Also:
  Constant Field Values

Constructor Detail
- AbstractMETSDisseminator
```
public AbstractMETSDisseminator()
```

Method Detail

gensym
```
protected String gensym(String prefix)
```
Make a new unique ID symbol with specified prefix.

Parameters:
prefix - the prefix of the identifier, constrained to XML ID schema

Returns:
a new string identifier unique in this session (instance).

resetCounter
```
protected void resetCounter()
```
Resets the unique ID counter used by gensym() method to determine the @ID values of METS tags.

getMIMEType
```
public String getMIMEType(PackageParameters params)
```
Description copied from interface: PackageDisseminator

Identifies the MIME-type of this package, e.g. "application/zip". Required when sending the package via HTTP, to provide the Content-Type header.

Returns:
the MIME type (content-type header) of the package to be returned

disseminate
```
public void disseminate(Context context,
               DSpaceObject dso,
               PackageParameters params,
               File pkgFile)
                 throws PackageValidationException,
                        CrosswalkException,
                        AuthorizeException,
                        SQLException,
                        IOException
```
Export the object (Item, Collection, or Community) as a "package" on the indicated OutputStream. Package is any serialized representation of the item, at the discretion of the implementing class. It does not have to include content bitstreams.
Use the params parameter list to adjust the way the package is made, e.g. including a "metadataOnly" parameter might make the package a bare manifest in XML instead of a Zip file including manifest and contents.
Throws an exception of the chosen object is not acceptable or there is a failure creating the package.

Parameters:
context - DSpace context.
dso - DSpace object (item, collection, etc)
params - Properties-style list of options specific to this packager
pkgFile - File where export package should be written

Throws:

PackageValidationException - if package cannot be created or there is a fatal error in creating it.

CrosswalkException

AuthorizeException

SQLException

IOException

writeZipPackage

protected void writeZipPackage(Context context,
                   DSpaceObject dso,
                   PackageParameters params,
                   OutputStream pkg)
                        throws PackageValidationException,
                               CrosswalkException,
                               edu.harvard.hul.ois.mets.helper.MetsException,
                               AuthorizeException,
                               SQLException,
                               IOException

Make a Zipped up METS package for the given DSpace Object

Parameters:: context - DSpace Context; dso - The DSpace Object; params - Parameters to the Packager script; pkg - Package output stream
Throws:: PackageValidationException; AuthorizeException; SQLException; IOException; CrosswalkException; edu.harvard.hul.ois.mets.helper.MetsException

addBitstreamsToZip

protected void addBitstreamsToZip(Context context,
                      DSpaceObject dso,
                      PackageParameters params,
                      ZipOutputStream zip)
                           throws PackageValidationException,
                                  AuthorizeException,
                                  SQLException,
                                  IOException

Add Bitstreams associated with a given DSpace Object into an existing ZipOutputStream

Parameters:: context - DSpace Context; dso - The DSpace Object; params - Parameters to the Packager script; zip - Zip output
Throws:: PackageValidationException; AuthorizeException; SQLException; IOException

setMdType

protected void setMdType(edu.harvard.hul.ois.mets.MdWrap mdWrap,
             String mdtype)

setMdType

protected void setMdType(edu.harvard.hul.ois.mets.MdRef mdRef,
             String mdtype)

makeMdSec

protected edu.harvard.hul.ois.mets.helper.MdSec makeMdSec(Context context,
                                              DSpaceObject dso,
                                              Class mdSecClass,
                                              String typeSpec,
                                              PackageParameters params,
                                              AbstractMETSDisseminator.MdStreamCache extraStreams)
                                                   throws SQLException,
                                                          PackageValidationException,
                                                          CrosswalkException,
                                                          IOException,
                                                          AuthorizeException

Create an element wrapped around a metadata reference (either mdWrap or mdRef); i.e. dmdSec, techMd, sourceMd, etc. Checks for XML-DOM oriented crosswalk first, then if not found looks for stream crosswalk of the same name.

Parameters:: context - DSpace Context; dso - DSpace Object we are generating METS manifest for; mdSecClass - class of mdSec (TechMD, RightsMD, DigiProvMD, etc); typeSpec - Type of metadata going into this mdSec (e.g. MODS, DC, PREMIS, etc); params - the PackageParameters; extraStreams - list of extra files which need to be added to final dissemination package
Returns:: mdSec element or null if xwalk returns empty results.
Throws:: SQLException; PackageValidationException; CrosswalkException; IOException; AuthorizeException

addToAmdSec

protected void addToAmdSec(edu.harvard.hul.ois.mets.AmdSec fAmdSec,
               String[] mdTypes,
               Class mdSecClass,
               Context context,
               DSpaceObject dso,
               PackageParameters params,
               AbstractMETSDisseminator.MdStreamCache extraStreams)
                    throws SQLException,
                           PackageValidationException,
                           CrosswalkException,
                           IOException,
                           AuthorizeException

Throws:: SQLException; PackageValidationException; CrosswalkException; IOException; AuthorizeException

addAmdSec

protected String addAmdSec(Context context,
               DSpaceObject dso,
               PackageParameters params,
               edu.harvard.hul.ois.mets.Mets mets,
               AbstractMETSDisseminator.MdStreamCache extraStreams)
                    throws SQLException,
                           PackageValidationException,
                           CrosswalkException,
                           IOException,
                           AuthorizeException

Throws:: SQLException; PackageValidationException; CrosswalkException; IOException; AuthorizeException

makePersistentID

protected String makePersistentID(DSpaceObject dso)

makeManifest

protected edu.harvard.hul.ois.mets.Mets makeManifest(Context context,
                                         DSpaceObject dso,
                                         PackageParameters params,
                                         AbstractMETSDisseminator.MdStreamCache extraStreams)
                                              throws edu.harvard.hul.ois.mets.helper.MetsException,
                                                     PackageValidationException,
                                                     CrosswalkException,
                                                     AuthorizeException,
                                                     SQLException,
                                                     IOException

Write out a METS manifest. Mostly lifted from Rob Tansley's METS exporter.

Throws:: edu.harvard.hul.ois.mets.helper.MetsException; PackageValidationException; CrosswalkException; AuthorizeException; SQLException; IOException

addLogoBitstream

protected void addLogoBitstream(Bitstream logoBs,
                    edu.harvard.hul.ois.mets.FileSec fileSec,
                    edu.harvard.hul.ois.mets.Div div0,
                    PackageParameters params)

makeFileDiv

protected edu.harvard.hul.ois.mets.Div makeFileDiv(String fileID,
                                       String type)

makeChildDiv

protected edu.harvard.hul.ois.mets.Div makeChildDiv(String type,
                                        DSpaceObject dso,
                                        PackageParameters params)

Create a

element with which references a child object via its handle (and via a local file name, when recursively disseminating all child objects).

Parameters:: type - - type attr value for the; dso - - object for which to create the div; params -
Returns:: a new Div with dso as child.

getHandleURN

protected String getHandleURN(String handle)

findOriginalBitstream
```
protected static Bitstream findOriginalBitstream(Item item,
                              Bitstream derived)
                                          throws SQLException
```
For a bitstream that's a thumbnail or extracted text, find the corresponding bitstream it was derived from, in the ORIGINAL bundle.

Parameters:
item - the item we're dealing with
derived - the derived bitstream

Returns:
the corresponding original bitstream (or null)

Throws:

SQLException

linkLicenseRefsToBitstreams
```
protected void linkLicenseRefsToBitstreams(Context context,
                               PackageParameters params,
                               DSpaceObject dso,
                               edu.harvard.hul.ois.mets.MdRef mdRef)
                                    throws SQLException,
                                           IOException,
                                           AuthorizeException
```
Cleanup our license file reference links, as Deposit Licenses & CC Licenses can be added two ways (and we only want to add them to zip package *once*): (1) Added as a normal Bitstream (assuming LICENSE and CC_LICENSE bundles will be included in pkg) (2) Added via a 'rightsMD' crosswalk (as they are rights information/metadata on an Item)
So, if they are being added by *both*, then we want to just link the rightsMD entry so that it points to the Bitstream location. This implementation is a bit 'hackish', but it's the best we can do, as the Harvard METS API doesn't allow us to go back and crawl an entire METS file to look for these inconsistencies/duplications.

Parameters:
context - current DSpace Context
params - current Packager Parameters
dso - current DSpace Object
mdRef - the rightsMD element

Throws:

SQLException

IOException

AuthorizeException

getObjectTypeString
```
public String getObjectTypeString(DSpaceObject dso)
```
Build a string which will be used as the "Type" of this object in the METS manifest.
Default format is "DSpace [Type-as-string]".

Parameters:
dso - DSpaceObject to create type-string for

Returns:
a string which will represent this object Type in METS
See Also:
Constants

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.

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

makeBitstreamURL
```
public String makeBitstreamURL(Bitstream bitstream,
                      PackageParameters params)
```
Get the URL by which the METS manifest refers to a Bitstream member within the same package. In other words, this is generally a relative path link to where the Bitstream file is within the Zipped up package.
For a manifest-only METS, this is a reference to an HTTP URL where the bitstream should be able to be downloaded from.

Parameters:
bitstream - the Bitstream
params - Packager Parameters

Returns:
String in URL format naming path to bitstream.

makeMetsHdr

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

Create metsHdr element - separate so subclasses can override.

getProfile
```
public abstract String getProfile()
```
Returns name of METS profile to which this package conforms, e.g. "DSpace METS DIP Profile 1.0"

Returns:
string name of profile.

bundleToFileGrp
```
public abstract String bundleToFileGrp(String bname)
```
Returns fileGrp's USE attribute value corresponding to a DSpace bundle name.

Parameters:
bname - name of DSpace bundle.

Returns:
string name of fileGrp

getDmdTypes
```
public abstract String[] getDmdTypes(Context context,
                   DSpaceObject dso,
                   PackageParameters params)
                              throws SQLException,
                                     IOException,
                                     AuthorizeException
```
Get the types of Item-wide DMD to include in package. Each element of the returned array is a String, which MAY be just a simple name, naming both the Crosswalk Plugin and the METS "MDTYPE", or a colon-separated pair consisting of the METS name followed by a colon and the Crosswalk Plugin name. E.g. the type string "DC:qualifiedDublinCore" tells it to create a METS section with MDTYPE="DC" and use the plugin named "qualifiedDublinCore" to obtain the data.

Parameters:
params - the PackageParameters passed to the disseminator.

Returns:
array of metadata type strings, never null.

Throws:

SQLException

IOException

AuthorizeException

getTechMdTypes

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

Get the type string of the technical 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.

Parameters:: params - the PackageParameters passed to the disseminator.
Returns:: array of metadata type strings, never null.
Throws:: SQLException; IOException; AuthorizeException

getSourceMdTypes

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

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.

Parameters:: params - the PackageParameters passed to the disseminator.
Returns:: array of metadata type strings, never null.
Throws:: SQLException; IOException; AuthorizeException

getDigiprovMdTypes

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

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.

Parameters:: params - the PackageParameters passed to the disseminator.
Returns:: array of metadata type strings, never null.
Throws:: SQLException; IOException; AuthorizeException

getRightsMdTypes

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

Get the type string of the "rights" (permission and/or license) 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.

Parameters:: params - the PackageParameters passed to the disseminator.
Returns:: array of metadata type strings, never null.
Throws:: SQLException; IOException; AuthorizeException

addStructMap

public abstract 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

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.

Parameters:: mets - the METS document to which to add structMaps
Throws:: SQLException; IOException; AuthorizeException; edu.harvard.hul.ois.mets.helper.MetsException

includeBundle
```
public abstract boolean includeBundle(Bundle bundle)
```
Returns:
true when this bundle should be included as "content" in the package.. e.g. DSpace SIP does not include metadata bundles.

Class AbstractMETSDisseminator

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

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

Methods inherited from class java.lang.Object

Field Detail

TEMPLATE_TYPE_SUFFIX

Constructor Detail

AbstractMETSDisseminator

Method Detail

gensym

resetCounter

getMIMEType

disseminate

writeZipPackage

addBitstreamsToZip

setMdType

setMdType

makeMdSec

addToAmdSec

addAmdSec

makePersistentID

makeManifest

addLogoBitstream

makeFileDiv

makeChildDiv

getHandleURN

findOriginalBitstream

linkLicenseRefsToBitstreams

getObjectTypeString

getParameterHelp

makeBitstreamURL

makeMetsHdr

getProfile

bundleToFileGrp

getDmdTypes

getTechMdTypes

getSourceMdTypes

getDigiprovMdTypes

getRightsMdTypes

addStructMap

includeBundle