org.apache.commons.scaffold.util
Interface ScrollerBean

All Known Implementing Classes:

ScrollerBeanBase

public interface ScrollerBean

Base class for scrolling searches.

Version:

$Revision: 1.8 $ $Date: 2004/03/21 21:10:10 $

Method Summary

java.lang.String	commandKey() Returns the String to use to retrieve the appropriate query for this search.
java.lang.String	countKey() Returns the String to use to retrieve the appropriate query to count the entries matching this search.
int	entryCount() The total number of entries in search list.
boolean	failsOnEmpty() Whether to branch to "failure" if list returns zero entries.
java.lang.Integer	getScrollFrom() The relative position of the first entry in this set.
boolean	hasParameter() Returns whether this search takes a parameter (eg primary key) [false].
boolean	isLike() Returns whether this search uses the LIKE operator so that other methods know to wrap searchValue in a call to like [false].
void	listLegend(ResultList list) Setup the legend for the result list.
Scroller	newScroller(int entries) Return new scroller using the current starting point (getScrollFrom), the default limit (set.SCROLL_ROWS), and current count from Access (countCurrent).
java.util.Collection	result(java.lang.Object target, java.lang.Object parameter) Returns the collection representing the result of the Search [null].
java.lang.Object[]	scrollerParams(java.lang.String parameter) Return the array of parameters needed to select the entries for this set.
ProcessResult	scrollerSearch() Invoke business logic; return result.
java.lang.Integer	scrollOffset() The number of entries before the first entry in the set (One less than scrollFrom) [0].
int	scrollRows() The number of entries to return [Scroller.SCROLL_ROWS].
java.lang.String	searchLabel() Returns a label to the property being searched.
java.lang.String	searchProperty() Returns the name of the property being matched with the searchValue.
java.lang.Object	searchValue() Returns the value used in the search [null].
void	setScrollFrom(java.lang.Integer scrollFrom)
java.lang.String	tokenEmptyDispatch() Returns the dispatch token for an empty result [Tokens.FAILURE].
java.lang.String	tokenEmptyMessage() Returns the message token for an empty result [Tokens.DATA_ACCESS_EMPTY].

Method Detail

getScrollFrom

public java.lang.Integer getScrollFrom()

The relative position of the first entry in this set.

Returns:

the position to start this set

setScrollFrom

public void setScrollFrom(java.lang.Integer scrollFrom)

scrollOffset

public java.lang.Integer scrollOffset()

The number of entries before the first entry in the set (One less than scrollFrom) [0].

Returns:

Offset to next entry

scrollRows

public int scrollRows()

The number of entries to return [Scroller.SCROLL_ROWS].

Returns:

Entries per page.

countKey

public java.lang.String countKey()

Returns the String to use to retrieve the appropriate query to count the entries matching this search. Must be overridden or provide functionality.

Returns:

Value of count key

hasParameter

public boolean hasParameter()

Returns whether this search takes a parameter (eg primary key) [false]. Override this method to return true and getParameter to return the required parameter.

Returns:

True if this search uses a parameter

searchValue

public java.lang.Object searchValue()

Returns the value used in the search [null]. This can be the literal value used in the query or (if hasParameter==false) a description of what the search returns. Must be overridden or provide functionality.

Returns:

Value of search parameter

isLike

public boolean isLike()

Returns whether this search uses the LIKE operator so that other methods know to wrap searchValue in a call to like [false].

Returns:

True if this search uses the LIKE operator

entryCount

public int entryCount()
               throws ResourceException

The total number of entries in search list. The default behavior returns a "like" search count of entries matching the searchKey. Override to provide functionality.

Returns:

total entries

Throws:

May - throw an exception on data access error

ResourceException

commandKey

public java.lang.String commandKey()

Returns the String to use to retrieve the appropriate query for this search. Must be overridden or provide functionality.

Returns:

Value of command key

searchProperty

public java.lang.String searchProperty()

Returns the name of the property being matched with the searchValue. Default method returns null. Must be overridden or provide functionality.

Returns:

The search property

searchLabel

public java.lang.String searchLabel()

Returns a label to the property being searched. This can be the property name or a more descriptive legend. Default method returns searchProperty. Must be overridden or provide functionality.

Returns:

The label for the search property

failsOnEmpty

public boolean failsOnEmpty()

Whether to branch to "failure" if list returns zero entries.

tokenEmptyMessage

public java.lang.String tokenEmptyMessage()

Returns the message token for an empty result [Tokens.DATA_ACCESS_EMPTY]. May be used when isFailOnEmpty is true.

Returns:

Message token for an empty result.

tokenEmptyDispatch

public java.lang.String tokenEmptyDispatch()

Returns the dispatch token for an empty result [Tokens.FAILURE]. May be used when isFailOnEmpty is true.

Returns:

Message token for an empty result.

scrollerParams

public java.lang.Object[] scrollerParams(java.lang.String parameter)

Return the array of parameters needed to select the entries for this set.

Parameters:

parameter - The additional parameter needed to select this set, if any.

result

public java.util.Collection result(java.lang.Object target,
                                   java.lang.Object parameter)
                            throws ResourceException

Returns the collection representing the result of the Search [null]. The default behavior performs a "like" search for the parameter Override for an other search type. Subclasses may ignor parameter argument when isParameter is false.

Parameters:

target - Bean to use for entries

parameter - Value to use to match entries

Returns:

Collection with the result of the search

Throws:

ResourceException

newScroller

public Scroller newScroller(int entries)
                     throws ResourceException

Return new scroller using the current starting point (getScrollFrom), the default limit (set.SCROLL_ROWS), and current count from Access (countCurrent).

Returns:

new Scroller using current and default settings.

Throws:

ResourceException - on data access error

listLegend

public void listLegend(ResultList list)

Setup the legend for the result list. Default behavior is to use the searchLabel and searchValue (if any).

scrollerSearch

public ProcessResult scrollerSearch()
                             throws java.lang.Exception

Invoke business logic; return result.

Throws:

java.lang.Exception