Module org.apache.wicket.extensions

Package org.apache.wicket.extensions.markup.html.form.datetime

Class LocalDateTimeField

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.FormComponentPanel<T>

org.apache.wicket.extensions.markup.html.form.datetime.LocalDateTimeField

All Implemented Interfaces:

Serializable, Iterable<Component>, IEventSink, IEventSource, IFeedbackContributor, IConverterLocator, IGenericComponent<LocalDateTime,FormComponent<LocalDateTime>>, IMetadataContext<Serializable,Component>, IQueueRegion, IFormModelUpdateListener, IFormVisitorParticipant, ILabelProvider<String>, IHeaderContributor, IRequestableComponent, org.apache.wicket.util.IHierarchical<Component>, org.apache.wicket.util.io.IClusterable

public class LocalDateTimeField
extends FormComponentPanel<T>

Works on a LocalDateTime object. See AbstractDateTimeField for further details.

Author:

eelcohillenius

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DATE_CSS_CLASS_KEY
static final String	TIME_CSS_CLASS_KEY

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_RESERVED1, FLAG_RESERVED2, FLAG_RESERVED3, FLAG_RESERVED4, FLAG_RESERVED5, FLAG_RESERVED8, PARENT_PATH, PATH_SEPARATOR, RENDER, RFLAG_CONTAINER_DEQUEING, RFLAG_CONTAINER_HAS_REMOVALS

Constructor Summary

Constructors

Constructor	Description
LocalDateTimeField(String id)	Construct.
LocalDateTimeField(String id, IModel<LocalDateTime> model)	Construct.

Method Summary

Modifier and Type	Method	Description
void	convertInput()	Sets the converted input, which is an instance of Date, possibly null.
protected LocalDateTime	createTemporal(LocalDate date, LocalTime time)	Create the temporal object from date and time.
protected final LocalDateTextField	getDateField()
protected LocalTime	getDefaultTime()	Get a default time if none was entered.
String	getInput()
protected LocalDate	getLocalDate(LocalDateTime temporal)	Get the local date from the given temporal.
protected LocalTime	getLocalTime(LocalDateTime temporal)	Get the time from the given temporal.
protected final TimeField	getTimeField()
protected LocalDateTextField	newDateField(String id, IModel<LocalDate> dateFieldModel)	create a new LocalDateTextField instance to be added to this panel.
protected TimeField	newTimeField(String id, IModel<LocalTime> timeFieldModel)	create a new TimeField instance to be added to this panel.
protected void	onBeforeRender()
protected void	onInitialize()

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

checkRequired, clearInput, newMarkupSourcingStrategy, onComponentTag

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

add, add, convertValue, error, getConvertedInput, getDefaultLabel, getDefaultLabel, getForm, getInputAsArray, getInputName, getModelValue, getParameterValues, getRawInput, getType, getValidatorKeyPrefix, getValidators, getValue, hasRawInput, inputAsInt, inputAsInt, inputAsIntArray, inputChanged, internalOnModelChanged, invalid, isInputNullable, isMultiPart, isRequired, isValid, newValidatable, newValidationError, onDetach, onDisabled, onInvalid, onValid, processChildren, processInput, remove, reportRequiredError, setConvertedInput, setLabel, setModelValue, setRequired, setType, shouldTrimInput, trim, updateAutoLabels, updateAutoLabels, updateCollectionModel, updateModel, valid, validate, validateRequired, validateValidators, visitComponentsPostOrder, visitFormComponentsPostOrder

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

getLabel

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

getWebApplication, getWebPage, getWebRequest, getWebResponse, getWebSession

Methods inherited from class org.apache.wicket.MarkupContainer

add, addDequeuedComponent, addOrReplace, autoAdd, canDequeueTag, contains, dequeue, dequeue, dequeuePreamble, findChildComponent, findComponentToDequeue, get, getAssociatedMarkup, getAssociatedMarkupStream, getMarkup, getMarkupType, getRegionMarkup, internalAdd, internalInitialize, iterator, iterator, newDequeueContext, onComponentTagBody, onRender, queue, remove, remove, removeAll, renderAll, renderAssociatedMarkup, renderNext, replace, setDefaultModel, size, stream, streamChildren, toString, toString, visitChildren, visitChildren

Methods inherited from class org.apache.wicket.Component

add, addStateChange, beforeRender, canCallListener, canCallListenerAfterExpiry, checkComponentTag, checkComponentTagAttribute, checkHierarchyChange, clearOriginalDestination, configure, continueToOriginalDestination, createConverter, debug, detach, detachModel, detachModels, determineVisibility, error, exceptionMessage, fatal, findMarkupStream, findPage, findParent, findParentWithAssociatedMarkup, getAjaxRegionMarkupId, getApplication, getBehaviorById, getBehaviorId, getBehaviors, getBehaviors, getClassRelativePath, getConverter, getDefaultModel, getDefaultModelObject, getDefaultModelObjectAsString, getDefaultModelObjectAsString, getEscapeModelStrings, getFeedbackMessages, getFlag, getId, getInnermostModel, getInnermostModel, getLocale, getLocalizer, getMarkup, getMarkupAttributes, getMarkupId, getMarkupId, getMarkupIdFromMarkup, getMarkupIdImpl, getMarkupSourcingStrategy, getMarkupTag, 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, internalRenderComponent, internalRenderHead, isActionAuthorized, isAuto, isBehaviorAccepted, isEnableAllowed, isEnabled, isEnabledInHierarchy, isIgnoreAttributeModifier, isInitialized, isRenderAllowed, isRendering, isStateless, isVersioned, isVisibilityAllowed, isVisible, isVisibleInHierarchy, markRendering, modelChanged, modelChanging, onAfterRender, onConfigure, onEvent, onModelChanged, onModelChanging, onReAdd, onRemove, redirectToInterceptPage, remove, remove, render, renderComponentTag, rendered, renderHead, renderPart, renderPlaceholderTag, replaceComponentTagBody, replaceWith, sameInnermostModel, sameInnermostModel, send, setAuto, setDefaultModelObject, setEnabled, setEscapeModelStrings, setFlag, setIgnoreAttributeModifier, setMarkup, setMarkupId, setMarkupIdImpl, setMetaData, setOutputMarkupId, setOutputMarkupPlaceholderTag, setParent, setRenderBodyOnly, setResponsePage, setResponsePage, setResponsePage, setVersioned, setVisibilityAllowed, setVisible, success, urlFor, urlFor, urlFor, urlForListener, urlForListener, visitParents, visitParents, warn, wrap

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.wicket.IGenericComponent

getDefaultModel, getDefaultModelObject, getModel, getModelObject, setDefaultModel, setDefaultModelObject, setModel, setModelObject

Methods inherited from interface org.apache.wicket.IQueueRegion

dequeue, getRegionMarkup, newDequeueContext

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Details

DATE_CSS_CLASS_KEY

public static final String DATE_CSS_CLASS_KEY

TIME_CSS_CLASS_KEY

public static final String TIME_CSS_CLASS_KEY

Constructor Details

LocalDateTimeField

public LocalDateTimeField(String id)

Construct.

Parameters:

id -

LocalDateTimeField

public LocalDateTimeField(String id,
 IModel<LocalDateTime> model)

Construct.

Parameters:

id -

model -

Method Details

createTemporal

protected LocalDateTime createTemporal(LocalDate date,
 LocalTime time)

Create the temporal object from date and time.

Returns:

getLocalDate

protected LocalDate getLocalDate(LocalDateTime temporal)

Get the local date from the given temporal.

Returns:

local date

getLocalTime

protected LocalTime getLocalTime(LocalDateTime temporal)

Get the time from the given temporal.

Returns:

time

onInitialize

protected void onInitialize()

Overrides:

onInitialize in class MarkupContainer

getDateField

protected final LocalDateTextField getDateField()

Returns:

The date TextField

getTimeField

protected final TimeField getTimeField()

Returns:

The date TextField

getInput

public String getInput()

Overrides:

getInput in class FormComponent<T extends Temporal>

convertInput

public void convertInput()

Sets the converted input, which is an instance of Date, possibly null. It combines the inputs of the nested date, hours, minutes and am/pm fields and constructs a date from it.

Note that overriding this method is a better option than overriding FormComponent.updateModel() like the first versions of this class did. The reason for that is that this method can be used by form validators without having to depend on the actual model being updated, and this method is called by the default implementation of FormComponent.updateModel() anyway (so we don't have to override that anymore).

Overrides:

convertInput in class FormComponent<T extends Temporal>

getDefaultTime

protected LocalTime getDefaultTime()

Get a default time if none was entered.

Returns:

null by default

newDateField

protected LocalDateTextField newDateField(String id,
 IModel<LocalDate> dateFieldModel)

create a new LocalDateTextField instance to be added to this panel.

Parameters:

id - the component id

dateFieldModel - model that should be used by the LocalDateTextField

Returns:

a new date text field instance

newTimeField

protected TimeField newTimeField(String id,
 IModel<LocalTime> timeFieldModel)

create a new TimeField instance to be added to this panel.

Parameters:

id - the component id

timeFieldModel - model that should be used by the TimeField

Returns:

a new time text field instance

onBeforeRender

protected void onBeforeRender()

Overrides:

onBeforeRender in class FormComponent<T extends Temporal>

See Also:

• Component.onBeforeRender()