de.must.markup

Class HiddenField

java.lang.Object

de.must.markup.MustInputField

de.must.markup.HiddenField

All Implemented Interfaces:

Markupable, ValueFetcher

public class HiddenField
extends MustInputField

Hidden field for storage sharing between butler and JSP including JavaScript. Let's assume you create it like hiddenField1 = new HiddenField("hidden1"); If the JSP form tag includes e.g. name="mainform", you may access the storage of the hidden field by JavaScript via document.mainform.hidden1.value. Of course, you should not forget to call hiddenField1.fetchYourValueFromRequest(request);; Be aware that the butler class is updated via form submit only. This may be done by the same JavaScript function via document.mainform.submit();

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String	value

Fields inherited from class de.must.markup.MustInputField

comment, focus, name, placeholder, toolTipText

Constructor Summary

Constructors

Constructor and Description
HiddenField() Constructs a new hidden field with the check text as specified.
HiddenField(java.lang.String name) Constructs a hidden field with the specified name.

Method Summary

Modifier and Type	Method and Description
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.
java.lang.String	getCreationTag() Returns the tag sequence that's needed to show this object in the user interface.
java.lang.String	getText() Return the text of the hidden field.
boolean	isFilled() Returns true if the component has a value.
boolean	isModified() Returns true if the component's value differs from its initial value.
boolean	isRequired() Returns always false.
boolean	isRequirementUnfulfilled() Returns false if mandatory input Field is not filled.
boolean	isValid() Returns true if the component's value is valid.
void	setRequired(boolean required) Sets the fact that user input is requested (mandatory)
void	setText(java.lang.String newText) Sets the text.

Methods inherited from class de.must.markup.MustInputField

getName, setComment, setFocus, setPlaceHolder, setToolTipText, toString

Methods inherited from class java.lang.Object

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

Field Detail

value

protected java.lang.String value

Constructor Detail

HiddenField

public HiddenField()

Constructs a new hidden field with the check text as specified.

Parameters:

checkText - the check box' text

HiddenField

public HiddenField(java.lang.String name)

Constructs a hidden field with the specified name.

Parameters:

name - the name of the hidden field

Method Detail

getCreationTag

public java.lang.String getCreationTag()

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

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

getText

public java.lang.String getText()

Return the text of the hidden field.

Returns:

the text of the hidden field

setText

public void setText(java.lang.String newText)

Sets the text.

Parameters:

newText - the new text

setRequired

public void setRequired(boolean required)

Sets the fact that user input is requested (mandatory)

Parameters:

required - whether this inuput is mandatory or not.

isRequired

public boolean isRequired()

Returns always false.

Returns:

always false

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 false if mandatory input Field is not filled.

Returns:

if mandatory input is unfulfilled

isModified

public boolean isModified()

Returns true if the component's value differs from its initial value.

Returns:

true if the component's value differs from its initial value

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

Overrides:

destroy in class MustInputField

See Also:

Markupable.destroy()