de.must.markup

Class MustInputField

java.lang.Object

de.must.markup.MustInputField

All Implemented Interfaces:

Markupable, ValueFetcher

Direct Known Subclasses:

FileUploader, HalfDataComboBox, HiddenField, ImageViewer, MustButton, MustCheckBox, MustPasswordField, MustTextArea, MustTextField, RadioButtonGroup, TabButtonGroup, TabButtonGroupForJsp, VariableChoice, VariableChoiceNumKey

public abstract class MustInputField
extends java.lang.Object
implements Markupable, ValueFetcher

Input field to be rendered via markup languages. A view to different types of input fields to be used in markup languages. Markupable input fields are designed similar to JComponent. They have a value that may be set and retrieved like e.g. setText() and getText(). When laid-out, they provide tag sequences. When updated by user input via action POST, they synchronize their values by method fetchYourValueFromRequest.

See Also:

MustInputField, GroupOfMarkupables

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String	comment
protected boolean	focus
protected java.lang.String	name
protected java.lang.String	placeholder
protected java.lang.String	toolTipText

Constructor Summary

Constructors

Constructor and Description
MustInputField(java.lang.String name) Constructs a new input field with the specified name.

Method Summary

Modifier and Type	Method and Description
void	destroy() Destroys the markupable.
abstract void	fetchYourValueFromRequest(GeneralizedRequest request) Causes the component to read user input by calling request.getParameter and update the internal mirrored value.
java.lang.String	getName() Returns the name of the input field.
void	setComment(java.lang.String comment) Sets the component's comment text which will be presented to the right of the component.
void	setFocus(boolean focus)
void	setPlaceHolder(java.lang.String placeholder)
void	setToolTipText(java.lang.String newToolTipText) Sets the component's tool tip text.
java.lang.String	toString() Returns the tag sequence that's needed to show this object in the user interface.

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.must.markup.Markupable

getCreationTag

Field Detail

name

protected java.lang.String name

toolTipText

protected java.lang.String toolTipText

placeholder

protected java.lang.String placeholder

focus

protected boolean focus

comment

protected java.lang.String comment

Constructor Detail

MustInputField

public MustInputField(java.lang.String name)

Constructs a new input field with the specified name.

Parameters:

name - the name of the field to be used for markup parameters

Method Detail

getName

public java.lang.String getName()

Returns the name of the input field.

Returns:

the name of the input field

setToolTipText

public void setToolTipText(java.lang.String newToolTipText)

Sets the component's tool tip text.

Specified by:

setToolTipText in interface Markupable

Parameters:

newToolTipText - the component's tool tip text

setPlaceHolder

public void setPlaceHolder(java.lang.String placeholder)

setFocus

public void setFocus(boolean focus)

setComment

public void setComment(java.lang.String comment)

Sets the component's comment text which will be presented to the right of the component.

Specified by:

setComment in interface Markupable

Parameters:

comment - the component's comment text

toString

public java.lang.String toString()

Returns the tag sequence that's needed to show this object in the user interface. Useful to minimize instructions in JavaServerPages - only the markupable object is to be named.

Overrides:

toString in class java.lang.Object

Returns:

the tag sequence to show the component

fetchYourValueFromRequest

public abstract void fetchYourValueFromRequest(GeneralizedRequest request)

Description copied from interface: ValueFetcher

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

Specified by:

fetchYourValueFromRequest in interface ValueFetcher

Parameters:

request - the current request

destroy

public 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