de.must.markup

Class HalfDataComboBox

java.lang.Object

de.must.markup.MustInputField

de.must.markup.HalfDataComboBox

All Implemented Interfaces:

Markupable, ValueFetcher, Exemptible

Direct Known Subclasses:

DataComboBox

public class HalfDataComboBox
extends MustInputField
implements Exemptible

ComboBox field with data from table.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String	additionalTagFragments
protected DataObject	contentDataObject
protected boolean	enabled
protected IdentifierTextTable	identifierTable
protected java.lang.String	label
protected boolean	required
protected java.lang.String	selected
protected java.lang.String	visibleColumnName
protected java.lang.String	whereCondition

Fields inherited from class de.must.markup.MustInputField

comment, focus, name, placeholder, toolTipText

Constructor Summary

Constructors

Constructor and Description
HalfDataComboBox(SessionData sessionData, DataObject contentDataObject, java.lang.String visibleColumnName) Creates a dynamically data filled combo box.
HalfDataComboBox(SessionData sessionData, DataObject contentDataObject, java.lang.String visibleColumnName, java.lang.String orderByColumnName, java.lang.String nameForNoChoice) Creates a dynamically data filled combo box.
HalfDataComboBox(SessionData sessionData, java.lang.String name, DataObject contentDataObject, java.lang.String visibleColumnName) Creates a dynamically data filled combo box.
HalfDataComboBox(SessionData sessionData, java.lang.String name, DataObject contentDataObject, java.lang.String visibleColumnName, java.lang.String orderByColumnName, java.lang.String nameForNoChoice) Creates a dynamically data filled combo box.
HalfDataComboBox(java.lang.String name, java.lang.String[] contentArray) Creates a statically data filled combo box.

Method Summary

Modifier and Type	Method and Description
void	addItem(java.lang.String item, Identifier identifier) Adds an item to the combo box.
void	dataChangePerformed(DataChangedEvent e) Called from data objects when data have been changed.
void	destroy() Destroys the markupable.
void	fetchYourValueFromRequest(GeneralizedRequest request) Causes the component to read user input by calling request.getParameter and update the internal mirrored value.
protected void	finalize()
void	free() Releases external resources.
java.lang.String	getCreationTag() Returns the tag sequence that's needed to show this object in the user interface.
java.lang.String	getLabel() Returns the component's label.
Identifier	getSelectedIdentifier() Returns the int identifier of the selected entry.
java.lang.String	getSelectedItem() Returns the current selected item.
boolean	isFilled() Returns true if the component has a value.
boolean	isRequirementUnfulfilled() Returns true if the component's value is mandatory but not filled.
boolean	isSpecialChoice() Returns true if the choosen entry is not equals "no entry" or "any".
boolean	isValid() Returns true if the component's value is valid.
void	reduceContent(java.lang.String whereCondition) Reduces the content of the combo box by adding a where condition to the select statement of the content date object and recall of the fillFromContentDataObject method.
void	setAdditionalTagFragments(java.lang.String additionalTagFragments) Sets the component's additional tag fragments.
static void	setDefaultAdditionalTagFragments(java.lang.String newDefaultAdditionalTagFragments) Sets the component's default additional tag fragments.
void	setEnabled(boolean enabled) Sets the specified boolean to indicate whether or not this component is enabled.
void	setRequired(boolean required) Sets the fact that user input is requested (mandatory)
void	setSelected(java.lang.String stringToSelect) Selects an item by the visible string
void	setSelectedIdentifier(Identifier selectedIdentifier) Selects an item by the identifier.

Methods inherited from class de.must.markup.MustInputField

getName, setComment, setFocus, setPlaceHolder, setToolTipText, toString

Methods inherited from class java.lang.Object

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

Field Detail

additionalTagFragments

protected java.lang.String additionalTagFragments

label

protected java.lang.String label

required

protected boolean required

contentDataObject

protected DataObject contentDataObject

visibleColumnName

protected java.lang.String visibleColumnName

whereCondition

protected java.lang.String whereCondition

enabled

protected boolean enabled

identifierTable

protected IdentifierTextTable identifierTable

selected

protected java.lang.String selected

Constructor Detail

HalfDataComboBox

public HalfDataComboBox(java.lang.String name,
                        java.lang.String[] contentArray)

Creates a statically data filled combo box.

Parameters:

name - the name of the combo box

contentArray - the content of the combo box

HalfDataComboBox

public HalfDataComboBox(SessionData sessionData,
                        DataObject contentDataObject,
                        java.lang.String visibleColumnName)

Creates a dynamically data filled combo box.

Parameters:

sessionData - the session's public data

contentDataObject - the data object to fill the content

visibleColumnName - the name of the column to be displayed

HalfDataComboBox

public HalfDataComboBox(SessionData sessionData,
                        java.lang.String name,
                        DataObject contentDataObject,
                        java.lang.String visibleColumnName)

Creates a dynamically data filled combo box.

Parameters:

sessionData - the session's public data

name - the name of the combo box

contentDataObject - the data object to fill the content

visibleColumnName - the name of the column to be displayed

HalfDataComboBox

public HalfDataComboBox(SessionData sessionData,
                        DataObject contentDataObject,
                        java.lang.String visibleColumnName,
                        java.lang.String orderByColumnName,
                        java.lang.String nameForNoChoice)

Creates a dynamically data filled combo box.

Parameters:

sessionData - the session's public data

contentDataObject - the data object to fill the content

visibleColumnName - the name of the column to be displayed

orderByColumnName - the sorting column name of the content data object

nameForNoChoice - the expression to be used to indicate "no choice"

HalfDataComboBox

public HalfDataComboBox(SessionData sessionData,
                        java.lang.String name,
                        DataObject contentDataObject,
                        java.lang.String visibleColumnName,
                        java.lang.String orderByColumnName,
                        java.lang.String nameForNoChoice)

Creates a dynamically data filled combo box.

Parameters:

sessionData - the session's public data

name - the name of the combo box

contentDataObject - the data object to fill the content

visibleColumnName - the name of the column to be displayed

orderByColumnName - the sorting column name of the content data object

nameForNoChoice - the expression to be used to indicate "no choice"

Method Detail

setDefaultAdditionalTagFragments

public static void setDefaultAdditionalTagFragments(java.lang.String newDefaultAdditionalTagFragments)

Sets the component's default additional tag fragments. E.g. JavaScript like onChange may be added.

Parameters:

newDefaultClassName - the component's default additional tag fragments.

setAdditionalTagFragments

public void setAdditionalTagFragments(java.lang.String additionalTagFragments)

Sets the component's additional tag fragments. E.g. JavaScript like onChange may be added.

Parameters:

newDefaultClassName - the component's additional tag fragments.

reduceContent

public void reduceContent(java.lang.String whereCondition)

Reduces the content of the combo box by adding a where condition to the select statement of the content date object and recall of the fillFromContentDataObject method. Applicable only for the combo box filled from database.

Parameters:

whereCondition - the where condition to use

addItem

public void addItem(java.lang.String item,
                    Identifier identifier)

Adds an item to the combo box.

Parameters:

item - the item to add

identifyValueInt - the identifier of the item to add

setEnabled

public void setEnabled(boolean enabled)

Sets the specified boolean to indicate whether or not this component is enabled.

Parameters:

enabled - indicates whether or not this component is enabled

setSelected

public void setSelected(java.lang.String stringToSelect)

Selects an item by the visible string

Parameters:

stringToSelect - the string to select

getSelectedItem

public java.lang.String getSelectedItem()

Returns the current selected item.

Returns:

the current selected item

setSelectedIdentifier

public void setSelectedIdentifier(Identifier selectedIdentifier)

Selects an item by the identifier.

Parameters:

selectedIdentifier - the identifier to select an entry

getSelectedIdentifier

public Identifier getSelectedIdentifier()

Returns the int identifier of the selected entry.

Returns:

the identifier of the selected entry

getLabel

public java.lang.String getLabel()

Returns the component's label.

Returns:

the component's label

dataChangePerformed

public void dataChangePerformed(DataChangedEvent e)

Called from data objects when data have been changed. Used for synchronization of data presentations.

Parameters:

e - the data change event that happend.

getCreationTag

public java.lang.String getCreationTag()

Returns the tag sequence that's needed to show this object in the user interface.

Specified by:

getCreationTag in interface Markupable

Returns:

the tag sequence to show the component

fetchYourValueFromRequest

public void fetchYourValueFromRequest(GeneralizedRequest request)

Causes the component to read user input by calling request.getParameter and update the internal mirrored value.

Specified by:

fetchYourValueFromRequest in interface ValueFetcher

Specified by:

fetchYourValueFromRequest in class MustInputField

Parameters:

request - the current request

isSpecialChoice

public boolean isSpecialChoice()

Returns true if the choosen entry is not equals "no entry" or "any".

Returns:

true if the choosen entry is not equals "no entry" or "any"

setRequired

public void setRequired(boolean required)

Sets the fact that user input is requested (mandatory)

Parameters:

required - whether this inuput is mandatory or not.

isFilled

public boolean isFilled()

Returns true if the component has a value.

Returns:

true if the component has a value

isValid

public boolean isValid()

Returns true if the component's value is valid.

Returns:

true if the component's value is valid

isRequirementUnfulfilled

public boolean isRequirementUnfulfilled()

Returns true if the component's value is mandatory but not filled.

Returns:

if mandatory input is unfulfilled

destroy

public final void destroy()

Description copied from interface: Markupable

Destroys the markupable. Useful to release e.g. static references which prevent the garbage collector from finalizing. For example HalfDataComboBoxes add s as Listeners to database changes. These listeners are registered statically. Thus, these listeners cannot be removed by the garbage collector, they have to be removed manually. This may be done by calling this destroy method.

Specified by:

destroy in interface Markupable

Overrides:

destroy in class MustInputField

free

public void free()

Description copied from interface: Exemptible

Releases external resources. May be called manually without waiting for garbage collection to occur.

Specified by:

free in interface Exemptible

finalize

protected final void finalize()
                       throws java.lang.Throwable

Overrides:

finalize in class java.lang.Object

Throws:

java.lang.Throwable