org.apache.tapestry.contrib.valid
Class ValidatingTextField

java.lang.Object
  org.apache.hivemind.impl.BaseLocatable
      org.apache.tapestry.AbstractComponent
          org.apache.tapestry.form.AbstractFormComponent
              org.apache.tapestry.valid.ValidField
                  org.apache.tapestry.contrib.valid.ValidatingTextField

All Implemented Interfaces:

org.apache.hivemind.Locatable, org.apache.hivemind.LocationHolder, IFormComponent, IComponent, IDirectEvent, Component, IRender

public abstract class ValidatingTextField
extends ValidField

Backwards compatible version of the 1.0.7 ValidatingTextField component.

Parameter	Type	Read / Write	Required	Default	Description
text	java.lang.String	R / W	yes		The text inside the text field. When the form is submitted, the binding is only updated if the value is valid.
minimumLength	int	R	no	0	The minimum length (number of characters read) for the field. The value provided in the request is trimmed of leading and trailing whitespace. If a field is not required and no value is given, then minimumLength is ignored. Minimum length only applies if some non-null value is given.
required	boolean	R	no	false	If true, then a non-null value must be provided. A value consisting only of whitespace is considered null.
displayName	String	R	yes		A textual name for the field that is used when formulating error messages.

May not have a body. May have informal parameters.

Since:

1.0.8

Author:

Howard Lewis Ship

See Also:

ValidField

Field Summary

Fields inherited from class org.apache.tapestry.AbstractComponent

_body, _bodyCount

Constructor Summary

ValidatingTextField()

Method Summary

abstract int	getMinimumLength()
abstract String	getText()
IValidator	getValidator() Overrides ValidField.getValidator()to construct a validator on the fly.
Object	getValue()
abstract boolean	isRequired() Returns false.
abstract void	setText(String value)
void	setValue(Object value)

Methods inherited from class org.apache.tapestry.valid.ValidField

getDisplayName, isDisabled, isHidden, readValue, renderFormComponent, rewindFormComponent, updateValue

Methods inherited from class org.apache.tapestry.form.AbstractFormComponent

generateClientId, getCanTakeFocus, getForm, getIdParameter, getName, getRenderBodyOnRewind, peekClientId, renderComponent, renderDelegateAttributes, renderDelegatePrefix, renderDelegateSuffix, setForm, setName, setName

Methods inherited from class org.apache.tapestry.AbstractComponent

addAsset, addBody, addComponent, checkActiveLock, cleanupAfterRender, enterActiveState, equals, finishLoad, finishLoad, getAsset, getAssets, getBeans, getBinding, getBindingNames, getBindings, getBody, getBodyCount, getBoundId, getClientId, getComponent, getComponents, getContainedComponent, getContainedRenderers, getContainer, getEventInvoker, getExtendedId, getId, getIdPath, getInnerRenderers, getListeners, getMessages, getNamespace, getPage, getRenderWorker, getSpecification, getSpecifiedId, getTemplateTagName, hasEvents, hashCode, isInActiveState, isParameterBound, isRendering, isStateful, pageEndRender, prepareForRender, render, renderBody, renderIdAttribute, renderInformalParameters, setBinding, setClientId, setContainedComponent, setContainer, setHasEvents, setId, setNamespace, setPage, setTemplateTagName, toString, triggerEvent

Methods inherited from class org.apache.hivemind.impl.BaseLocatable

getLocation, setLocation

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.tapestry.form.IFormComponent

getClientId

Methods inherited from interface org.apache.tapestry.IComponent

addAsset, addBody, addComponent, enterActiveState, finishLoad, getAsset, getAssets, getBeans, getBinding, getBindingNames, getBindings, getComponent, getComponents, getContainedComponent, getContainer, getEventInvoker, getExtendedId, getId, getIdPath, getListeners, getMessages, getNamespace, getPage, getSpecification, getSpecifiedId, getTemplateTagName, isRendering, renderBody, setBinding, setClientId, setContainedComponent, setContainer, setId, setNamespace, setPage, setTemplateTagName

Methods inherited from interface org.apache.tapestry.IRender

render

Methods inherited from interface org.apache.hivemind.LocationHolder

setLocation

Methods inherited from interface org.apache.hivemind.Locatable

getLocation

Constructor Detail

ValidatingTextField

public ValidatingTextField()

Method Detail

getMinimumLength

public abstract int getMinimumLength()

isRequired

public abstract boolean isRequired()

Description copied from class: AbstractFormComponent

Returns false. Subclasses that might be required must override this method. Typically, this involves checking against the component's validators.

Specified by:

isRequired in interface IFormComponent

Overrides:

isRequired in class AbstractFormComponent

getText

public abstract String getText()

setText

public abstract void setText(String value)

getValue

public Object getValue()

Specified by:

getValue in class ValidField

setValue

public void setValue(Object value)

Specified by:

setValue in class ValidField

getValidator

public IValidator getValidator()

Overrides ValidField.getValidator()to construct a validator on the fly.

Specified by:

getValidator in class ValidField