org.dspace.app.xmlui.aspect.artifactbrowser
Class AbstractSearch

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
                          org.dspace.app.xmlui.aspect.artifactbrowser.AbstractSearch

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:

AdvancedSearch, SimpleSearch

public abstract class AbstractSearch
extends AbstractDSpaceTransformer

This is an abstract search page. It is a collection of search methods that are common between different search implementation. An implementer must implement at least three methods: addBody(), getQuery(), and generateURL(). See the two implementors: SimpleSearch and AdvancedSearch.

Author:

Scott Phillips

Field Summary

Fields inherited from class org.dspace.app.xmlui.cocoon.AbstractDSpaceTransformer

context, contextPath, eperson, knot, objectModel, parameters, servletPath, sitemapURI, 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

AbstractSearch()

Method Summary

abstract void	addBody(Body body) Build the resulting search DRI document.
protected void	buildScopeList(Select scope) Add options to the search scope field.
protected void	buildSearchControls(Division div)
protected void	buildSearchResultsDivision(Division search) Attach a division to the given search division named "search-results" which contains results for this search query.
protected abstract String	generateURL(Map<String,String> parameters) Generate a url to the given search implementation with the associated parameters included.
Serializable	getKey() Generate the unique caching key.
protected int	getParameterEtAl()
protected String	getParameterOrder()
protected int	getParameterPage()
protected int	getParameterRpp()
protected int	getParameterSortBy()
protected abstract String	getQuery() Extract the query string.
protected QueryResults	getQueryResults()
protected DSpaceObject	getScope() Determine the current scope.
org.apache.excalibur.source.SourceValidity	getValidity() Generate the cache validity object.
protected void	logSearch()
protected void	performSearch() Query DSpace for a list of all items / collections / or communities that match the given search query.
void	recycle() Recycle
protected boolean	variableScope() Determine if the scope of the search should fixed or is changeable by the user.

Methods inherited from class org.dspace.app.xmlui.cocoon.AbstractDSpaceTransformer

addOptions, addPageMeta, addUserMeta, decodeFromURL, dispose, encodeForURL, generateURL, getComponentName, getObjectManager, handleException, setup

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

Constructor Detail

AbstractSearch

public AbstractSearch()

Method Detail

getKey

public Serializable getKey()

Generate the unique caching key. This key must be unique inside the space of this component.

getValidity

public org.apache.excalibur.source.SourceValidity getValidity()

Generate the cache validity object. This validity object should never "over cache" because it will perform the search, and serialize the results using the DSpaceValidity object.

addBody

public abstract void addBody(Body body)
                      throws SAXException,
                             WingException,
                             UIException,
                             SQLException,
                             IOException,
                             AuthorizeException

Build the resulting search DRI document.

Specified by:

addBody in interface DSpaceTransformer

Specified by:

addBody in interface WingTransformer

Overrides:

addBody in class AbstractDSpaceTransformer

Throws:

SAXException

WingException

UIException

SQLException

IOException

AuthorizeException

buildSearchResultsDivision

protected void buildSearchResultsDivision(Division search)
                                   throws IOException,
                                          SQLException,
                                          WingException

Attach a division to the given search division named "search-results" which contains results for this search query.

Parameters:

search - The search division to contain the search-results division.

Throws:

IOException

SQLException

WingException

buildScopeList

protected void buildScopeList(Select scope)
                       throws SQLException,
                              WingException

Add options to the search scope field. This field determines in what communities or collections to search for the query. The scope list will depend upon the current search scope. There are three cases: No current scope: All top level communities are listed. The current scope is a community: All collections contained within the community are listed. The current scope is a collection: All parent communities are listed.

Parameters:

scope - The current scope field.

Throws:

SQLException

WingException

performSearch

protected void performSearch()
                      throws SQLException,
                             IOException,
                             UIException

Query DSpace for a list of all items / collections / or communities that match the given search query.

Throws:

SQLException

IOException

UIException

getScope

protected DSpaceObject getScope()
                         throws SQLException

Determine the current scope. This may be derived from the current url handle if present or the scope parameter is given. If no scope is specified then null is returned.

Returns:

The current scope.

Throws:

SQLException

getParameterPage

protected int getParameterPage()

getParameterRpp

protected int getParameterRpp()

getParameterSortBy

protected int getParameterSortBy()

getParameterOrder

protected String getParameterOrder()

getParameterEtAl

protected int getParameterEtAl()

getQueryResults

protected QueryResults getQueryResults()

variableScope

protected boolean variableScope()
                         throws SQLException

Determine if the scope of the search should fixed or is changeable by the user. The search scope when preformed by url, i.e. they are at the url handle/xxxx/xx/search then it is fixed. However at the global level the search is variable.

Returns:

true if the scope is variable, false otherwise.

Throws:

SQLException

getQuery

protected abstract String getQuery()
                            throws UIException

Extract the query string. Under most implementations this will be derived from the url parameters.

Returns:

The query string.

Throws:

UIException

generateURL

protected abstract String generateURL(Map<String,String> parameters)
                               throws UIException

Generate a url to the given search implementation with the associated parameters included.

Parameters:

parameters -

Returns:

The post URL

Throws:

UIException

recycle

public void recycle()

Recycle

Specified by:

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

Overrides:

recycle in class AbstractDSpaceTransformer

buildSearchControls

protected void buildSearchControls(Division div)
                            throws WingException

Throws:

WingException

logSearch

protected void logSearch()