org.apache.wicket.datetime.markup.html.form
Class DateTextField

java.lang.Object
  org.apache.wicket.Component
      org.apache.wicket.MarkupContainer
          org.apache.wicket.markup.html.WebMarkupContainer
              org.apache.wicket.markup.html.form.LabeledWebMarkupContainer
                  org.apache.wicket.markup.html.form.FormComponent<T>
                      org.apache.wicket.markup.html.form.AbstractTextComponent<T>
                          org.apache.wicket.markup.html.form.TextField<java.util.Date>
                              org.apache.wicket.datetime.markup.html.form.DateTextField

All Implemented Interfaces:

java.io.Serializable, java.lang.Iterable<Component>, IEventSink, IEventSource, IClusterable, IConverterLocator, AbstractTextComponent.ITextFormatProvider, IFormModelUpdateListener, IFormVisitorParticipant, ILabelProvider<java.lang.String>, IHeaderContributor, IRequestableComponent, IHierarchical<Component>

public class DateTextField
extends TextField<java.util.Date>
implements AbstractTextComponent.ITextFormatProvider

A TextField that is mapped to a java.util.Date object and that uses Joda time to parse and format values.

You should use on of the factory methods to construct the kind you want or use the public constructor and pass in the converter to use.

This component tries to apply the time zone difference between the client and server. See the date converter of this package for more information on that.

Author:

eelcohillenius

See Also:

StyleDateConverter, DateTime, DateTimeFormat, DateTimeZone, Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.wicket.markup.html.form.AbstractTextComponent

AbstractTextComponent.ITextFormatProvider

Field Summary

Fields inherited from class org.apache.wicket.markup.html.form.FormComponent

FLAG_CONVERT_EMPTY_INPUT_STRING_TO_NULL, VALUE_SEPARATOR

Fields inherited from class org.apache.wicket.Component

ENABLE, FLAG_INITIALIZED, FLAG_REMOVING_FROM_HIERARCHY, FLAG_RESERVED1, FLAG_RESERVED2, FLAG_RESERVED3, FLAG_RESERVED4, FLAG_RESERVED5, FLAG_RESERVED8, PARENT_PATH, PATH_SEPARATOR, RENDER

Constructor Summary

DateTextField(java.lang.String id, DateConverter converter)
Construct with a converter, and a null model.

DateTextField(java.lang.String id, IModel<java.util.Date> model, DateConverter converter)
Construct with a converter.

Method Summary

static DateTextField	forDatePattern(java.lang.String id, IModel<java.util.Date> model, java.lang.String datePattern) Creates a new DateTextField defaulting to using a short date pattern
static DateTextField	forDatePattern(java.lang.String id, java.lang.String datePattern) Creates a new DateTextField defaulting to using a short date pattern
static DateTextField	forDateStyle(java.lang.String id, IModel<java.util.Date> model, java.lang.String dateStyle) Creates a new DateTextField using the provided date style.
static DateTextField	forDateStyle(java.lang.String id, java.lang.String dateStyle) Creates a new DateTextField using the provided date style.
static DateTextField	forShortStyle(java.lang.String id) Creates a new DateTextField defaulting to using a short date pattern
static DateTextField	forShortStyle(java.lang.String id, IModel<java.util.Date> model, boolean applyTimeZoneDifference) Creates a new DateTextField defaulting to using a short date pattern
<C> IConverter<C>	getConverter(java.lang.Class<C> clazz) Gets the converter that should be used by this component.
java.lang.String	getTextFormat() Gets the pattern for printing output and parsing input.
static DateTextField	withConverter(java.lang.String id, DateConverter converter) Creates a new DateTextField using the provided converter.
static DateTextField	withConverter(java.lang.String id, IModel<java.util.Date> model, DateConverter converter) Creates a new DateTextField using the provided converter.

Methods inherited from class org.apache.wicket.markup.html.form.TextField

getInputType, onComponentTag

Methods inherited from class org.apache.wicket.markup.html.form.AbstractTextComponent

convertInput, getConvertEmptyInputStringToNull, isInputNullable, onBeforeRender, setConvertEmptyInputStringToNull

Methods inherited from class org.apache.wicket.markup.html.form.FormComponent

add, add, checkRequired, clearInput, convertValue, error, getConvertedInput, getDefaultLabel, getDefaultLabel, getForm, getInput, getInputAsArray, getInputName, getModel, getModelObject, getModelValue, getRawInput, getType, getValidatorKeyPrefix, getValidators, getValue, hasRawInput, inputAsInt, inputAsInt, inputAsIntArray, inputChanged, internalOnModelChanged, invalid, isMultiPart, isRequired, isValid, newValidatable, onDetach, onDisabled, onInvalid, onValid, processChildren, processInput, remove, setConvertedInput, setLabel, setModel, setModelObject, setModelValue, setRequired, setType, shouldTrimInput, trim, updateCollectionModel, updateModel, valid, validate, validateRequired, validateValidators, visitComponentsPostOrder, visitFormComponentsPostOrder

Methods inherited from class org.apache.wicket.markup.html.form.LabeledWebMarkupContainer

getLabel, setLabelInternal

Methods inherited from class org.apache.wicket.markup.html.WebMarkupContainer

getWebPage, getWebRequest

Methods inherited from class org.apache.wicket.MarkupContainer

add, addOrReplace, autoAdd, contains, get, get, getAssociatedMarkup, getAssociatedMarkupStream, getMarkup, getMarkupType, hasAssociatedMarkup, internalAdd, internalInitialize, iterator, iterator, onAfterRenderChildren, onComponentTagBody, onMarkupAttached, onRender, remove, remove, removeAll, renderAll, renderAssociatedMarkup, renderNext, replace, setDefaultModel, size, swap, toString, toString, visitChildren, visitChildren, visitChildren, visitChildren

Methods inherited from class org.apache.wicket.Component

add, addStateChange, afterRender, beforeRender, canCallListenerInterface, checkComponentTag, checkComponentTagAttribute, checkHierarchyChange, configure, continueToOriginalDestination, debug, detach, detachModel, detachModels, determineVisibility, error, exceptionMessage, fatal, findMarkupStream, findPage, findParent, findParentWithAssociatedMarkup, getAjaxRegionMarkupId, getApplication, getBehaviorById, getBehaviorId, getBehaviors, getBehaviors, getClassRelativePath, getDefaultModel, getDefaultModelObject, getDefaultModelObjectAsString, getDefaultModelObjectAsString, getEscapeModelStrings, getFeedbackMessage, getFeedbackMessages, getFlag, getId, getInnermostModel, getInnermostModel, getLocale, getLocalizer, getMarkup, getMarkupAttributes, getMarkupId, getMarkupId, getMarkupIdFromMarkup, getMarkupIdImpl, getMarkupSourcingStrategy, getMetaData, getModelComparator, getOutputMarkupId, getOutputMarkupPlaceholderTag, getPage, getPageRelativePath, getParent, getPath, getRenderBodyOnly, getRequest, getRequestCycle, getRequestFlag, getResponse, getSession, getSizeInBytes, getStatelessHint, getString, getString, getString, getStyle, getVariation, hasBeenRendered, hasErrorMessage, hasFeedbackMessage, info, initModel, internalPrepareForRender, internalRenderComponent, isActionAuthorized, isAuto, isBehaviorAccepted, isEnableAllowed, isEnabled, isEnabledInHierarchy, isIgnoreAttributeModifier, isRenderAllowed, isStateless, isVersioned, isVisibilityAllowed, isVisible, isVisibleInHierarchy, locateMarkupStream, markRendering, modelChanged, modelChanging, newMarkupSourcingStrategy, onAfterRender, onConfigure, onEvent, onInitialize, onModelChanged, onModelChanging, onRemove, prepareForRender, redirectToInterceptPage, remove, remove, render, renderComponentTag, rendered, renderHead, renderHead, renderHead, renderPlaceholderTag, replaceComponentTagBody, replaceWith, sameInnermostModel, sameInnermostModel, send, setAuto, setDefaultModelObject, setEnabled, setEscapeModelStrings, setFlag, setIgnoreAttributeModifier, setMarkup, setMarkupId, setMarkupIdImpl, setMetaData, setOutputMarkupId, setOutputMarkupPlaceholderTag, setParent, setRenderBodyOnly, setRequestFlag, setResponsePage, setResponsePage, setResponsePage, setVersioned, setVisibilityAllowed, setVisible, success, urlFor, urlFor, urlFor, urlFor, urlFor, visitParents, warn, wrap

Methods inherited from class java.lang.Object

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

Constructor Detail

DateTextField

public DateTextField(java.lang.String id,
                     IModel<java.util.Date> model,
                     DateConverter converter)

Construct with a converter.

Parameters:

id - The component id

model - The model

converter - The converter to use

DateTextField

public DateTextField(java.lang.String id,
                     DateConverter converter)

Construct with a converter, and a null model.

Parameters:

id - The component id

converter - The converter to use

Method Detail

forDatePattern

public static DateTextField forDatePattern(java.lang.String id,
                                           IModel<java.util.Date> model,
                                           java.lang.String datePattern)

Creates a new DateTextField defaulting to using a short date pattern

Parameters:

id - The id of the text field

model - The model

datePattern - The pattern to use. Must be not null. See SimpleDateFormat for available patterns.

Returns:

DateTextField

forDatePattern

public static DateTextField forDatePattern(java.lang.String id,
                                           java.lang.String datePattern)

Creates a new DateTextField defaulting to using a short date pattern

Parameters:

id - The id of the text field

datePattern - The pattern to use. Must be not null. See SimpleDateFormat for available patterns.

Returns:

DateTextField

forDateStyle

public static DateTextField forDateStyle(java.lang.String id,
                                         IModel<java.util.Date> model,
                                         java.lang.String dateStyle)

Creates a new DateTextField using the provided date style.

Parameters:

id - The id of the text field

model - The model

dateStyle - Date style to use. The first character is the date style, and the second character is the time style. Specify a character of 'S' for short style, 'M' for medium, 'L' for long, and 'F' for full. A date or time may be ommitted by specifying a style character '-'. See DateTimeFormat.forStyle(String).

Returns:

DateTextField

forDateStyle

public static DateTextField forDateStyle(java.lang.String id,
                                         java.lang.String dateStyle)

Creates a new DateTextField using the provided date style.

Parameters:

id - The id of the text field

dateStyle - Date style to use. The first character is the date style, and the second character is the time style. Specify a character of 'S' for short style, 'M' for medium, 'L' for long, and 'F' for full. A date or time may be ommitted by specifying a style character '-'. See DateTimeFormat.forStyle(String).

Returns:

DateTextField

forShortStyle

public static DateTextField forShortStyle(java.lang.String id)

Creates a new DateTextField defaulting to using a short date pattern

Parameters:

id - The id of the text field

Returns:

DateTextField

forShortStyle

public static DateTextField forShortStyle(java.lang.String id,
                                          IModel<java.util.Date> model,
                                          boolean applyTimeZoneDifference)

Creates a new DateTextField defaulting to using a short date pattern

Parameters:

id - The id of the text field

model - The model

applyTimeZoneDifference - Whether to apply the time zone difference between client and server

Returns:

DateTextField

withConverter

public static DateTextField withConverter(java.lang.String id,
                                          DateConverter converter)

Creates a new DateTextField using the provided converter.

Parameters:

id - The id of the text field

converter - the date converter

Returns:

DateTextField

withConverter

public static DateTextField withConverter(java.lang.String id,
                                          IModel<java.util.Date> model,
                                          DateConverter converter)

Creates a new DateTextField using the provided converter.

Parameters:

id - The id of the text field

model - The model

converter - the date converter

Returns:

DateTextField

getConverter

public final <C> IConverter<C> getConverter(java.lang.Class<C> clazz)

Description copied from class: Component

Gets the converter that should be used by this component.

Specified by:

getConverter in interface IConverterLocator

Overrides:

getConverter in class Component

Type Parameters:

C - The object to convert from and to String

Parameters:

clazz - The type to convert to

Returns:

The specialized converter.

See Also:

Component.getConverter(java.lang.Class)

getTextFormat

public final java.lang.String getTextFormat()

Description copied from interface: AbstractTextComponent.ITextFormatProvider

Gets the pattern for printing output and parsing input.

Specified by:

getTextFormat in interface AbstractTextComponent.ITextFormatProvider

Returns:

The text pattern

See Also:

AbstractTextComponent.ITextFormatProvider.getTextFormat()