de.must.wuic

Class SearchElement

java.lang.Object

de.must.wuic.SearchElement

public class SearchElement
extends java.lang.Object

A combination of GUI elements to allow the user to choose column names, comparison and enter values to build where conditions without knowledge about the database and SQL

Constructor Summary

Constructors

Constructor and Description
SearchElement(SearchItem[] searchItems, MessageReceiver messageReceiver, DataObjectWrapper dataObjectWrapper) Constructs a new search element.
SearchElement(SearchItem[] searchItems, MessageReceiver messageReceiver, DataObjectWrapper dataObjectWrapper, int defaultColumnIndex) Constructs a new search element.

Method Summary

Modifier and Type	Method and Description
void	addTo(AttributeList attributeList) Adds all components of this search element to the specified attribute list.
void	extend(WhereCondition whereCondition) Builds the part of the where condition represented by user input and adds it to the specified where condition.
static void	extend(WhereCondition whereCondition, java.util.Vector<SearchElement> searchElements, boolean combineOr) Extends a where condition with multiple where conditions of several search items.
protected java.lang.String	getTranslation(java.lang.String resourceKey) Returns a text in the corresponding language according to the locale specific resource bundle of the package.
MustTextField	getValueField() Returns the text field containing the search value.
boolean	isInputAccepted() Returns true if user input is accepted.
boolean	isOr() Returns true if the selected combination request is 'or'.
void	register(InquiryHistory inquiryHistory) Registers all GUI elements to the specified inquiry history.
void	reset() Resets all GUI elements to the first state
void	setSelectedIndex(int index) Selects the item at index index.

Methods inherited from class java.lang.Object

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

Constructor Detail

SearchElement

public SearchElement(SearchItem[] searchItems,
                     MessageReceiver messageReceiver,
                     DataObjectWrapper dataObjectWrapper)

Constructs a new search element.

Parameters:

searchItems - the search items to be offered in this search element

messageReceiver - the receiver of messages produced by this element

dataObject - the data object to format date condition

SearchElement

public SearchElement(SearchItem[] searchItems,
                     MessageReceiver messageReceiver,
                     DataObjectWrapper dataObjectWrapper,
                     int defaultColumnIndex)

Constructs a new search element.

Parameters:

searchItems - the search items to be offered in this search element

messageReceiver - the receiver of messages produced by this element

dataObject - the data object to format date condition

defaultColumnIndex - the default column index

Method Detail

extend

public static void extend(WhereCondition whereCondition,
                          java.util.Vector<SearchElement> searchElements,
                          boolean combineOr)

Extends a where condition with multiple where conditions of several search items.

Parameters:

whereCondition - the where condition to extend

searchElements - the search elements which shall extend the condition

combineOr - whether or not or conditions should be treated in advance

addTo

public void addTo(AttributeList attributeList)

Adds all components of this search element to the specified attribute list.

Parameters:

attributeList - the attribute list to add the components to

register

public void register(InquiryHistory inquiryHistory)

Registers all GUI elements to the specified inquiry history.

Parameters:

inquiryHistory - the inquiry history manager

getValueField

public MustTextField getValueField()

Returns the text field containing the search value.

Returns:

the text field containing the search value

setSelectedIndex

public void setSelectedIndex(int index)

Selects the item at index index.

Parameters:

anIndex - an integer specifying the list item to select, where 0 specifies the first item in the list and -1 indicates no selection

Throws:

java.lang.IllegalArgumentException - if anIndex < -1 or anIndex is greater than or equal to size

reset

public void reset()

Resets all GUI elements to the first state

isOr

public boolean isOr()

Returns true if the selected combination request is 'or'.

Returns:

true if the selected combination request is 'or'

isInputAccepted

public boolean isInputAccepted()

Returns true if user input is accepted.

Returns:

true if user input is accepted.

getTranslation

protected java.lang.String getTranslation(java.lang.String resourceKey)

Returns a text in the corresponding language according to the locale specific resource bundle of the package.

Parameters:

resourceKey - the key of the resource to retrieve

Returns:

the resource

extend

public void extend(WhereCondition whereCondition)

Builds the part of the where condition represented by user input and adds it to the specified where condition.

Parameters:

whereCondition - the where condition which should be extended by current users choice