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

Deprecated.

Since DSpace 4 the system use an abstraction layer named Discovery to provide access to different search provider. The legacy system build upon Apache Lucene is likely to be removed in a future version. If you are interested in use Lucene as backend for the DSpace search system please consider to build a Lucene implementation of the Discovery interfaces

@Deprecated
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 implementations. An implementation must provide at least three methods: addBody(), getQuery(), and generateURL(). See the two implementations: 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

Constructors

Constructor and Description
AbstractSearch() Deprecated.

Method Summary

Methods

Modifier and Type	Method and Description
abstract void	addBody(Body body) Deprecated. Build the resulting search DRI document.
protected void	buildScopeList(Select scope) Deprecated. Add options to the search scope field.
protected void	buildSearchControls(Division div) Deprecated.
protected void	buildSearchResultsDivision(Division search) Deprecated. 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) Deprecated. Generate a url to the given search implementation with the associated parameters included.
Serializable	getKey() Deprecated. Generate the unique caching key.
protected int	getParameterEtAl() Deprecated.
protected String	getParameterOrder() Deprecated.
protected int	getParameterPage() Deprecated.
protected int	getParameterRpp() Deprecated.
protected int	getParameterSortBy() Deprecated.
protected abstract String	getQuery() Deprecated. Extract the query string.
protected QueryResults	getQueryResults() Deprecated.
protected DSpaceObject	getScope() Deprecated. Determine the current scope.
org.apache.excalibur.source.SourceValidity	getValidity() Deprecated. Generate the cache validity object.
protected void	logSearch() Deprecated.
protected void	performSearch() Deprecated. Query DSpace for a list of all items / collections / or communities that match the given search query.
void	recycle() Deprecated. Recycle
protected boolean	variableScope() Deprecated. 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()

Deprecated.

Method Detail

getKey

public Serializable getKey()

Deprecated.

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

getValidity

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

Deprecated.

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

Deprecated.

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

Deprecated.

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

Deprecated.

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

Deprecated.

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

Deprecated.

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()

Deprecated.

getParameterRpp

protected int getParameterRpp()

Deprecated.

getParameterSortBy

protected int getParameterSortBy()

Deprecated.

getParameterOrder

protected String getParameterOrder()

Deprecated.

getParameterEtAl

protected int getParameterEtAl()

Deprecated.

getQueryResults

protected QueryResults getQueryResults()

Deprecated.

variableScope

protected boolean variableScope()
                         throws SQLException

Deprecated.

Determine if the scope of the search should fixed or is changeable by the user. The search scope when performed 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

Deprecated.

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

Deprecated.

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()

Deprecated.

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

Deprecated.

Throws:

WingException

logSearch

protected void logSearch()

Deprecated.