org.dspace.app.xmlui.cocoon

Class AbstractDSpaceTransformer

java.lang.Object

org.apache.cocoon.util.AbstractLogEnabled

org.apache.cocoon.xml.AbstractXMLProducer

org.apache.cocoon.xml.AbstractXMLPipe

org.apache.cocoon.transformation.AbstractTransformer

org.dspace.app.xmlui.wing.AbstractWingTransformer

org.dspace.app.xmlui.cocoon.AbstractDSpaceTransformer

All Implemented Interfaces:

org.apache.avalon.excalibur.pool.Poolable, org.apache.avalon.excalibur.pool.Recyclable, org.apache.cocoon.sitemap.SitemapModelComponent, org.apache.cocoon.transformation.Transformer, org.apache.cocoon.xml.XMLPipe, org.apache.cocoon.xml.XMLProducer, org.apache.excalibur.xml.sax.XMLConsumer, DSpaceTransformer, WingTransformer, ContentHandler, LexicalHandler

Direct Known Subclasses:

AbstractControlPanelTab, AbstractRecentSubmissionTransformer, AbstractSearch, AbstractStatisticsDataTransformer, AbstractStep, AbstractXMLUIAction, AccessStepUtil, AddBitstreamForm, AddEPersonForm, AdvacedAuthorizationsForm, AdvancedFormTest, AssignCollectionRoles, AssignCommunityRoles, AuthorizationMain, BasicFormTest, BatchImportConfirm, BatchImportMain, BatchImportUpload, BrowseFacet, BrowseItemForm, CannotRegister, ChoiceLookupTransformer, CollectionBrowse, CollectionSearch, CollectionViewer, CollectionViewer, CommunityBrowse, CommunityBrowser, CommunitySearch, CommunityViewer, ConfigurableBrowse, ConfirmItemForm, Contact, ControlledVocabularyTransformer, ControlPanel, CreateCollectionForm, CreateCommunityForm, CSVExportDiscoveryNavigation, CurateCollectionForm, CurateCommunityForm, CurateForm, CurateItemForm, DeleteBitstreamFormatsConfirm, DeleteBitstreamsConfirm, DeleteCollectionConfirm, DeleteCollectionRoleConfirm, DeleteCommunityConfirm, DeleteCommunityRoleConfirm, DeleteEPeopleConfirm, DeleteGroupsConfirm, DeleteMetadataFieldsConfirm, DeleteMetadataSchemaConfirm, DeletePoliciesConfirm, DeleteVersionsConfirm, EditBitstreamForm, EditBitstreamFormat, EditCollectionHarvestingForm, EditCollectionMetadataForm, EditCommunityMetadataForm, EditContainerPolicies, EditEPersonForm, EditGroupForm, EditItemBitstreamsForm, EditItemMetadataForm, EditItemPolicies, EditItemStatusForm, EditMetadataSchema, EditPolicyForm, EditProfile, ElasticSearchStatsViewer, FailedAuthentication, FeedbackForm, FeedbackSent, FindItemForm, ForgotPasswordFinished, FormatRegistryMain, FrontPageFeeds, HTMLTest, InlineFormTest, InvalidToken, ItemExport, ItemRequestChangeStatusForm, ItemRequestContactAuthor, ItemRequestContactRequester, ItemRequestForm, ItemRequestResponseDecisionForm, ItemRequestResponseFalseForm, ItemRequestResponseSent, ItemRequestResponseTrueForm, ItemRequestSent, ItemRequestStatusChanged, ItemViewer, LDAPLogin, LoginChooser, ManageEPeopleMain, ManageGroupsMain, MapperMain, MetadataImportConfirm, MetadataImportMain, MetadataImportUpload, MetadataRegistryMain, MoveItemForm, MoveMetadataFields, Navigation, Navigation, Navigation, Navigation, Navigation, Navigation, Navigation, Navigation, Navigation, Navigation, Navigation, Navigation, Navigation, NotAuthorized, NoticeTransformer, PageNotFoundTransformer, PasswordLogin, PrivateItems, ProfileUpdated, RecentSubmissionTransformer, RegistrationFinished, RelatedItems, ResetPassword, RestoreVersionForm, RestrictedItem, RobotsNoIndexTransformer, SearchFacetFilter, SearchItemForm, SelectCollectionTransformer, SelectPackagingTransformer, SelectTargetTransformer, SetupCollectionHarvestingForm, SidebarFacetsTransformer, SiteViewer, StartForgotPassword, StartRegistration, StaticPage, StatisticsGoogleAnalyticsTransformer, StatisticsTransformer, StatisticsViewer, StepTransformer, StructureTest, Submissions, Submissions, Submissions, SwordResponseTransformer, SystemwideAlerts, ToggleCollectionHarvestingForm, VerifyEmail, VersionHistoryForm, VersionItemForm, VersionNoticeTransformer, VersionUpdateForm, ViewItem, WithdrawnItems, WorkflowExceptionTransformer, WorkflowItemTransformer, WorkflowOverviewTransformer, WorkflowTransformer

public abstract class AbstractDSpaceTransformer
extends AbstractWingTransformer
implements DSpaceTransformer

Author:

Scott Phillips

Field Summary

Fields

Modifier and Type	Field and Description
protected Context	context
protected String	contextPath
protected EPerson	eperson
protected org.apache.cocoon.components.flow.WebContinuation	knot
protected Map	objectModel
protected org.apache.avalon.framework.parameters.Parameters	parameters
protected String	servletPath
protected String	sitemapURI
protected String	url

Fields inherited from class org.apache.cocoon.xml.AbstractXMLProducer

contentHandler, EMPTY_CONTENT_HANDLER, lexicalHandler, xmlConsumer

Fields inherited from interface org.apache.cocoon.transformation.Transformer

ROLE

Constructor Summary

Constructors

Constructor and Description
AbstractDSpaceTransformer()

Method Summary

Methods

Modifier and Type	Method and Description
void	addBody(Body body) Abstract implementations of WingTransformer.
void	addOptions(Options options) Abstract implementation of WingTransformer.
void	addPageMeta(PageMeta pageMeta) Abstract implementation of WingTransformer.
void	addUserMeta(UserMeta userMeta) Abstract implementation of WingTransformer.
static String	decodeFromURL(String encodedString) Decode the given string from URL transmission.
void	dispose() Dispose.
static String	encodeForURL(String unencodedString) Encode the given string for URL transmission.
static String	generateURL(String baseURL, Map<String,String> parameters) Generate a URL for the given base URL with the given parameters.
String	getComponentName() Return the name of this component.
ObjectManager	getObjectManager() Return the ObjectManager associated with this component.
protected void	handleException(Exception e) Handle exceptions that occurred during the document's creation.
void	recycle() Recycle.
void	setup(org.apache.cocoon.environment.SourceResolver resolver, Map objectModel, String src, org.apache.avalon.framework.parameters.Parameters parameters)

Methods inherited from class org.dspace.app.xmlui.wing.AbstractWingTransformer

createWingDocument, endDocument, endElement, endPrefixMapping, getDefaultMessageCatalogue, message, message, setupWing, startDocument, startElement, startPrefixMapping

Methods inherited from class org.apache.cocoon.xml.AbstractXMLPipe

characters, comment, endCDATA, endDTD, endEntity, ignorableWhitespace, processingInstruction, setDocumentLocator, skippedEntity, startCDATA, startDTD, startEntity

Methods inherited from class org.apache.cocoon.xml.AbstractXMLProducer

setConsumer, setContentHandler, setLexicalHandler

Methods inherited from class org.apache.cocoon.util.AbstractLogEnabled

getLogger, setLogger

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.xml.sax.ContentHandler

characters, ignorableWhitespace, processingInstruction, setDocumentLocator, skippedEntity

Methods inherited from interface org.xml.sax.ext.LexicalHandler

comment, endCDATA, endDTD, endEntity, startCDATA, startDTD, startEntity

Methods inherited from interface org.apache.cocoon.xml.XMLProducer

setConsumer

Field Detail

objectModel

protected Map objectModel

context

protected Context context

contextPath

protected String contextPath

servletPath

protected String servletPath

sitemapURI

protected String sitemapURI

url

protected String url

parameters

protected org.apache.avalon.framework.parameters.Parameters parameters

eperson

protected EPerson eperson

knot

protected org.apache.cocoon.components.flow.WebContinuation knot

Constructor Detail

AbstractDSpaceTransformer

public AbstractDSpaceTransformer()

Method Detail

setup

public void setup(org.apache.cocoon.environment.SourceResolver resolver,
         Map objectModel,
         String src,
         org.apache.avalon.framework.parameters.Parameters parameters)
           throws org.apache.cocoon.ProcessingException,
                  SAXException,
                  IOException

Specified by:

setup in interface org.apache.cocoon.sitemap.SitemapModelComponent

Throws:

org.apache.cocoon.ProcessingException

SAXException

IOException

handleException

protected void handleException(Exception e)
                        throws SAXException

Description copied from class: AbstractWingTransformer

Handle exceptions that occurred during the document's creation. When errors occur a SAX event is being processed it will be sent through this method. This allows implementing classes to override this method for specific error handling hooks.

Overrides:

handleException in class AbstractWingTransformer

Parameters:

e - The thrown exception

Throws:

SAXException - unconditionally.

addBody

public void addBody(Body body)
             throws SAXException,
                    WingException,
                    UIException,
                    SQLException,
                    IOException,
                    AuthorizeException,
                    org.apache.cocoon.ProcessingException

Description copied from class: AbstractWingTransformer

Abstract implementations of WingTransformer.

Specified by:

addBody in interface DSpaceTransformer

Specified by:

addBody in interface WingTransformer

Overrides:

addBody in class AbstractWingTransformer

Parameters:

body - to be added.

Throws:

SAXException - whenever.

WingException - whenever.

UIException - whenever.

SQLException - whenever.

IOException - whenever.

AuthorizeException - whenever.

org.apache.cocoon.ProcessingException - whenever.

addOptions

public void addOptions(Options options)
                throws SAXException,
                       WingException,
                       UIException,
                       SQLException,
                       IOException,
                       AuthorizeException

Description copied from class: AbstractWingTransformer

Abstract implementation of WingTransformer.

Specified by:

addOptions in interface DSpaceTransformer

Specified by:

addOptions in interface WingTransformer

Overrides:

addOptions in class AbstractWingTransformer

Parameters:

options - to be added.

Throws:

SAXException - whenever.

WingException - whenever.

UIException - whenever.

SQLException - whenever.

IOException - whenever.

AuthorizeException - whenever.

addUserMeta

public void addUserMeta(UserMeta userMeta)
                 throws SAXException,
                        WingException,
                        UIException,
                        SQLException,
                        IOException,
                        AuthorizeException

Description copied from class: AbstractWingTransformer

Abstract implementation of WingTransformer.

Specified by:

addUserMeta in interface DSpaceTransformer

Specified by:

addUserMeta in interface WingTransformer

Overrides:

addUserMeta in class AbstractWingTransformer

Parameters:

userMeta - to be added.

Throws:

SAXException - whenever.

WingException - whenever.

UIException - whenever.

SQLException - whenever.

IOException - whenever.

AuthorizeException - whenever.

addPageMeta

public void addPageMeta(PageMeta pageMeta)
                 throws SAXException,
                        WingException,
                        UIException,
                        SQLException,
                        IOException,
                        AuthorizeException

Description copied from class: AbstractWingTransformer

Abstract implementation of WingTransformer.

Specified by:

addPageMeta in interface DSpaceTransformer

Specified by:

addPageMeta in interface WingTransformer

Overrides:

addPageMeta in class AbstractWingTransformer

Parameters:

pageMeta - to be added.

Throws:

SAXException - whenever.

WingException - whenever.

UIException - whenever.

SQLException - whenever.

IOException - whenever.

AuthorizeException - whenever.

getObjectManager

public ObjectManager getObjectManager()

Description copied from class: AbstractWingTransformer

Return the ObjectManager associated with this component. If no objectManager needed then return null.

Overrides:

getObjectManager in class AbstractWingTransformer

Returns:

the ObjectManager, or null.

getComponentName

public String getComponentName()

Description copied from class: AbstractWingTransformer

Return the name of this component. Typically the name is just the class name of the component.

Specified by:

getComponentName in interface DSpaceTransformer

Specified by:

getComponentName in interface WingTransformer

Overrides:

getComponentName in class AbstractWingTransformer

Returns:

the name.

encodeForURL

public static String encodeForURL(String unencodedString)
                           throws UIException

Encode the given string for URL transmission.

Parameters:

unencodedString - The unencoded string.

Returns:

The encoded string

Throws:

UIException - if the encoding is unsupported.

decodeFromURL

public static String decodeFromURL(String encodedString)
                            throws UIException

Decode the given string from URL transmission.

Parameters:

encodedString - The encoded string.

Returns:

The unencoded string

Throws:

UIException - if the encoding is unsupported.

generateURL

public static String generateURL(String baseURL,
                 Map<String,String> parameters)

Generate a URL for the given base URL with the given parameters. This is a convenience method to make it easier to generate URL references with parameters.

Example:

Map<String,String> parameters = new Map<String,String>();
 parameters.put("arg1","value1");
 parameters.put("arg2","value2");
 parameters.put("arg3","value3");
 String url = genrateURL("/my/url",parameters);
 

would result in the string:

url == "/my/url?arg1=value1&arg2=value2&arg3=value3"

Parameters:

baseURL - The baseURL without any parameters.

parameters - The parameters to be encoded on in the URL.

Returns:

The parameterized Post URL.

recycle

public void recycle()

Description copied from class: AbstractWingTransformer

Recycle.

Specified by:

recycle in interface org.apache.avalon.excalibur.pool.Recyclable

Overrides:

recycle in class AbstractWingTransformer

dispose

public void dispose()

Description copied from class: AbstractWingTransformer

Dispose.

Overrides:

dispose in class AbstractWingTransformer