org.dspace.app.xmlui.objectmanager

Class AbstractAdapter

java.lang.Object

org.dspace.app.xmlui.objectmanager.AbstractAdapter

Direct Known Subclasses:

ContainerAdapter, ItemAdapter, RepositoryAdapter

public abstract class AbstractAdapter
extends java.lang.Object

This is the abstract adapter containing all the common elements between the three types of adapters: item, container, and repository. Each adapter translate a given type of DSpace object into a METS document for rendering into the DRI document. This class provides the chassis for those unique parts of the document to be built upon. There are seven rendering methods that may be overridden for each section of the METS document. Header Descriptive Section Administrative Section File Section Structure Map Structural Link Behavioral Section

Author:

Scott Phillips

Field Summary

Fields

Modifier and Type	Field and Description
protected org.xml.sax.ContentHandler	contentHandler The SAX handlers for content and lexical events.
protected java.lang.String	contextPath The contextPath of this web application, used for generating URLs.
static Namespace	DIM
static java.lang.String	DIM_URI
protected org.xml.sax.ext.LexicalHandler	lexicalHandler
static Namespace	METS
static java.lang.String[]	METS_DEFINED_TYPES The METS defined types of Metadata, if a format is not listed here then it should use the string "OTHER" and provide additional attributes describing the metadata type
static java.lang.String	METS_URI Namespace declaration for METS & XLINK
protected org.xml.sax.helpers.NamespaceSupport	namespaces
static Namespace	XLINK
static java.lang.String	XLINK_URI
static Namespace	XSI
static java.lang.String	XSI_URI

Constructor Summary

Constructors

Constructor and Description
AbstractAdapter(java.lang.String contextPath) Construct a new adapter, implementers must call this method so the appropriate internal values are ensured to be set correctly.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	endElement(Namespace namespace, java.lang.String name) Send the SAX events to end this element.
DisseminationCrosswalk	getDisseminationCrosswalk(java.lang.String crosswalkName) Return a dissemination crosswalk for the given name.
protected java.lang.String	getGenericID(java.lang.String prefix) Generate a unique METS id.
protected abstract java.lang.String	getMETSID()
protected abstract java.lang.String	getMETSLabel()
protected abstract java.lang.String	getMETSOBJEDIT()
protected abstract java.lang.String	getMETSOBJID()
protected abstract java.lang.String	getMETSProfile()
boolean	isDefinedMETStype(java.lang.String metadataType) Determine if the provided metadata type is a standard METS defined type.
protected void	renderAdministrativeSection()
protected void	renderBehavioralSection()
protected void	renderDescriptiveSection()
protected void	renderExtraSections()
protected void	renderFile(Item item, Bitstream bitstream, java.lang.String fileID, java.lang.String groupID) Generate a METS file element for a given bitstream.
protected void	renderFile(Item item, Bitstream bitstream, java.lang.String fileID, java.lang.String groupID, java.lang.String admID) Generate a METS file element for a given bitstream.
protected void	renderFileSection()
protected void	renderHeader() Each of the METS sections
void	renderMETS(org.xml.sax.ContentHandler contentHandler, org.xml.sax.ext.LexicalHandler lexicalHandler) Render the complete METS document.
protected void	renderStructuralLink()
protected void	renderStructureMap()
protected void	sendCharacters(java.lang.String characters) Send the SAX event for these plain characters, not wrapped in any elements.
void	setAmdTypes(java.lang.String amdSec, java.lang.String mdTypes) Store information about what will be rendered in the METS administrative metadata section.
void	setDigiProvMDTypes(java.lang.String digiprovMDTypes) A comma-separated list of METS digital provenance metadata formats to render.
void	setDmdTypes(java.lang.String dmdTypes) A comma-separated list of METS descriptive metadata formats to render.
void	setFileGrpTypes(java.lang.String fileGrpTypes) A comma-separated list of METS fileGrps to render.
void	setRightsMDTypes(java.lang.String rightsMDTypes) A comma-separated list of METS intellectual property rights metadata formats to render.
void	setSections(java.lang.String sections) A comma-separated list of METS sections to render.
void	setSourceMDTypes(java.lang.String sourceMDTypes) A comma-separated list of METS source metadata formats to render.
void	setStructTypes(java.lang.String structTypes) A comma-separated list of METS structural types to render.
void	setTechMDTypes(java.lang.String techMDTypes) A comma-separated list of METS technical metadata formats to render.
protected void	startElement(Namespace namespace, java.lang.String name, AttributeMap... attributes) Send the SAX events to start this element.

Methods inherited from class java.lang.Object

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

Field Detail

METS_URI

public static final java.lang.String METS_URI

Namespace declaration for METS & XLINK

See Also:

Constant Field Values

METS

public static final Namespace METS

XLINK_URI

public static final java.lang.String XLINK_URI

See Also:

Constant Field Values

XLINK

public static final Namespace XLINK

XSI_URI

public static final java.lang.String XSI_URI

See Also:

Constant Field Values

XSI

public static final Namespace XSI

DIM_URI

public static final java.lang.String DIM_URI

See Also:

Constant Field Values

DIM

public static final Namespace DIM

contextPath

protected java.lang.String contextPath

The contextPath of this web application, used for generating URLs.

contentHandler

protected org.xml.sax.ContentHandler contentHandler

The SAX handlers for content and lexical events. Also the support element for namespaces which knows the prefixes for each declared namespace.

lexicalHandler

protected org.xml.sax.ext.LexicalHandler lexicalHandler

namespaces

protected org.xml.sax.helpers.NamespaceSupport namespaces

METS_DEFINED_TYPES

public static final java.lang.String[] METS_DEFINED_TYPES

The METS defined types of Metadata, if a format is not listed here then it should use the string "OTHER" and provide additional attributes describing the metadata type

Constructor Detail

AbstractAdapter

public AbstractAdapter(java.lang.String contextPath)

Construct a new adapter, implementers must call this method so the appropriate internal values are ensured to be set correctly.

Parameters:

contextPath - The contextPath of this web application.

Method Detail

setSections

public final void setSections(java.lang.String sections)

A comma-separated list of METS sections to render. If no value is provided then all METS sections are rendered.

Parameters:

sections - Comma separated list of METS sections.

setDmdTypes

public final void setDmdTypes(java.lang.String dmdTypes)

A comma-separated list of METS descriptive metadata formats to render. If no value is provided then only the DIM format is used.

Parameters:

dmdTypes - Comma separated list of METS metadata types.

setAmdTypes

public final void setAmdTypes(java.lang.String amdSec,
               java.lang.String mdTypes)

Store information about what will be rendered in the METS administrative metadata section. HashMap format: keys = amdSec, value = List of mdTypes

Parameters:

amdSec - Section of where this administrative metadata will be rendered

mdTypes - Comma-separated list of METS metadata types.

setTechMDTypes

public final void setTechMDTypes(java.lang.String techMDTypes)

A comma-separated list of METS technical metadata formats to render.

Parameters:

techMDTypes - Comma-separated list of METS metadata types.

setRightsMDTypes

public final void setRightsMDTypes(java.lang.String rightsMDTypes)

A comma-separated list of METS intellectual property rights metadata formats to render.

Parameters:

rightsMDTypes - Comma-separated list of METS metadata types.

setSourceMDTypes

public final void setSourceMDTypes(java.lang.String sourceMDTypes)

A comma-separated list of METS source metadata formats to render.

Parameters:

sourceMDTypes - Comma-separated list of METS metadata types.

setDigiProvMDTypes

public final void setDigiProvMDTypes(java.lang.String digiprovMDTypes)

A comma-separated list of METS digital provenance metadata formats to render.

Parameters:

digiprovMDTypes - Comma-separated list of METS metadata types.

setFileGrpTypes

public final void setFileGrpTypes(java.lang.String fileGrpTypes)

A comma-separated list of METS fileGrps to render. If no value is provided then all groups are rendered.

Parameters:

fileGrpTypes - Comma-separated list of METS file groups.

setStructTypes

public final void setStructTypes(java.lang.String structTypes)

A comma-separated list of METS structural types to render. If no value is provided then only the DIM format is used.

Parameters:

structTypes - Comma-separated list of METS structure types.

getMETSOBJID

protected abstract java.lang.String getMETSOBJID()
                                          throws WingException

Returns:

the URL for this item in the interface

Throws:

WingException

getMETSOBJEDIT

protected abstract java.lang.String getMETSOBJEDIT()

Returns:

the URL for editing this item

getMETSID

protected abstract java.lang.String getMETSID()
                                       throws WingException

Returns:

the METS ID of the mets document.

Throws:

WingException

getMETSProfile

protected abstract java.lang.String getMETSProfile()
                                            throws WingException

Returns:

The Profile this METS document conforms to.

Throws:

WingException

getMETSLabel

protected abstract java.lang.String getMETSLabel()
                                          throws WingException

Returns:

The label of this METS document.

Throws:

WingException

renderMETS

public final void renderMETS(org.xml.sax.ContentHandler contentHandler,
              org.xml.sax.ext.LexicalHandler lexicalHandler)
                      throws WingException,
                             org.xml.sax.SAXException,
                             CrosswalkException,
                             java.io.IOException,
                             java.sql.SQLException

Render the complete METS document.

Throws:

WingException

org.xml.sax.SAXException

CrosswalkException

java.io.IOException

java.sql.SQLException

renderHeader

protected void renderHeader()
                     throws WingException,
                            org.xml.sax.SAXException,
                            CrosswalkException,
                            java.io.IOException,
                            java.sql.SQLException

Each of the METS sections

Throws:

WingException

org.xml.sax.SAXException

CrosswalkException

java.io.IOException

java.sql.SQLException

renderDescriptiveSection

protected void renderDescriptiveSection()
                                 throws WingException,
                                        org.xml.sax.SAXException,
                                        CrosswalkException,
                                        java.io.IOException,
                                        java.sql.SQLException

Throws:

WingException

org.xml.sax.SAXException

CrosswalkException

java.io.IOException

java.sql.SQLException

renderAdministrativeSection

protected void renderAdministrativeSection()
                                    throws WingException,
                                           org.xml.sax.SAXException,
                                           CrosswalkException,
                                           java.io.IOException,
                                           java.sql.SQLException

Throws:

WingException

org.xml.sax.SAXException

CrosswalkException

java.io.IOException

java.sql.SQLException

renderFileSection

protected void renderFileSection()
                          throws WingException,
                                 org.xml.sax.SAXException,
                                 CrosswalkException,
                                 java.io.IOException,
                                 java.sql.SQLException

Throws:

WingException

org.xml.sax.SAXException

CrosswalkException

java.io.IOException

java.sql.SQLException

renderStructureMap

protected void renderStructureMap()
                           throws WingException,
                                  org.xml.sax.SAXException,
                                  CrosswalkException,
                                  java.io.IOException,
                                  java.sql.SQLException

Throws:

WingException

org.xml.sax.SAXException

CrosswalkException

java.io.IOException

java.sql.SQLException

renderStructuralLink

protected void renderStructuralLink()
                             throws WingException,
                                    org.xml.sax.SAXException,
                                    CrosswalkException,
                                    java.io.IOException,
                                    java.sql.SQLException

Throws:

WingException

org.xml.sax.SAXException

CrosswalkException

java.io.IOException

java.sql.SQLException

renderBehavioralSection

protected void renderBehavioralSection()
                                throws WingException,
                                       org.xml.sax.SAXException,
                                       CrosswalkException,
                                       java.io.IOException,
                                       java.sql.SQLException

Throws:

WingException

org.xml.sax.SAXException

CrosswalkException

java.io.IOException

java.sql.SQLException

renderExtraSections

protected void renderExtraSections()
                            throws WingException,
                                   org.xml.sax.SAXException,
                                   CrosswalkException,
                                   java.sql.SQLException,
                                   java.io.IOException

Throws:

WingException

org.xml.sax.SAXException

CrosswalkException

java.sql.SQLException

java.io.IOException

renderFile

protected final void renderFile(Item item,
              Bitstream bitstream,
              java.lang.String fileID,
              java.lang.String groupID)
                         throws org.xml.sax.SAXException

Generate a METS file element for a given bitstream.

Parameters:

item - If the bitstream is associated with an item provide the item otherwise leave null.

bitstream - The bitstream to build a file element for.

fileID - The unique file id for this file.

groupID - The group id for this file, if it is derived from another file then they should share the same groupID.

Throws:

org.xml.sax.SAXException

renderFile

protected final void renderFile(Item item,
              Bitstream bitstream,
              java.lang.String fileID,
              java.lang.String groupID,
              java.lang.String admID)
                         throws org.xml.sax.SAXException

Generate a METS file element for a given bitstream.

Parameters:

item - If the bitstream is associated with an item, provide the item, otherwise leave null.

bitstream - The bitstream to build a file element for.

fileID - The unique file id for this file.

groupID - The group id for this file, if it is derived from another file then they should share the same groupID.

admID - The IDs of the administrative metadata sections which pertain to this file

Throws:

org.xml.sax.SAXException

getGenericID

protected final java.lang.String getGenericID(java.lang.String prefix)

Generate a unique METS id. For consistency, all prefixes should probably end in an underscore, "_".

Parameters:

prefix - Prefix to prepend to the id for readability.

Returns:

A unique METS id.

getDisseminationCrosswalk

public final DisseminationCrosswalk getDisseminationCrosswalk(java.lang.String crosswalkName)
                                                       throws WingException

Return a dissemination crosswalk for the given name.

Parameters:

crosswalkName -

Returns:

The crosswalk or throw an exception if not found.

Throws:

WingException

isDefinedMETStype

public final boolean isDefinedMETStype(java.lang.String metadataType)

Determine if the provided metadata type is a standard METS defined type. If it is not, use the other string.

Parameters:

metadataType - type name

Returns:

True if METS defined

startElement

protected final void startElement(Namespace namespace,
                java.lang.String name,
                AttributeMap... attributes)
                           throws org.xml.sax.SAXException

Send the SAX events to start this element.

Parameters:

namespace - (Required) The namespace of this element.

name - (Required) The local name of this element.

attributes - (May be null) Attributes for this element

Throws:

org.xml.sax.SAXException

sendCharacters

protected final void sendCharacters(java.lang.String characters)
                             throws org.xml.sax.SAXException

Send the SAX event for these plain characters, not wrapped in any elements.

Parameters:

characters - (May be null) Characters to send.

Throws:

org.xml.sax.SAXException

endElement

protected final void endElement(Namespace namespace,
              java.lang.String name)
                         throws org.xml.sax.SAXException

Send the SAX events to end this element.

Parameters:

namespace - (Required) The namespace of this element.

name - (Required) The local name of this element.

Throws:

org.xml.sax.SAXException