Package lumis.doui.control.datepicker

Class DateTimePickerControl

java.lang.Object

lumis.doui.control.Control

lumis.doui.control.DataControl

lumis.doui.control.DataBoundControl

lumis.doui.control.datepicker.DateTimePickerControl

All Implemented Interfaces:

java.util.Observer, javax.servlet.jsp.el.VariableResolver, IControl, IDataBoundControl, IDataControl, IRenderer

Direct Known Subclasses:

LastWeekDateTimePickerControl, ScheduleDateTimePickerControl, ScheduleStartDateTimePickerControl

public class DateTimePickerControl
extends DataBoundControl

Renders two input text boxes for date and time. The date control is rendered with a picker button that opens a calendar to graphically select the date. The value of this control is the calculated adding the time and the date values.

Example use: <control:lum_dateTimePicker id="sendDateTime" /> xml data available for xsl rendering: <control dateFormat="M/d/yyyy" id="sendDateTime" timeFormat="HH:mm" type="lum_dateTimePicker"> <control id="sendDateTime.buttonSelect" type="lum_button" ... /> <strings> <string id="STR_AT">at</string> <string id="STR_H">h</string> <string id="STR_HRS">hrs</string> </strings> <data> <date>15</date> <month>3</month> <year>2007</year> <hour>23</hour> <minute>08</minute> <formattedDate>3/15/2007</formattedDate> <formattedTime>23:08</formattedTime> </data> </control>

Since:

4.0.0

Version:

$Revision$ $Date$

See Also:

ButtonControl

Field Summary

Fields

Modifier and Type	Field	Description
protected java.lang.String	dateFormat
protected java.lang.String	defaultDateFormat
protected java.lang.String	defaultTimeFormat
protected java.text.SimpleDateFormat	sdfDate
protected java.text.SimpleDateFormat	sdfDateTime
protected java.text.SimpleDateFormat	sdfDay
protected java.text.SimpleDateFormat	sdfHour
protected java.text.SimpleDateFormat	sdfMinute
protected java.text.SimpleDateFormat	sdfMonth
protected java.text.SimpleDateFormat	sdfTime
protected java.text.SimpleDateFormat	sdfYear
protected java.lang.String	timeFormat

Fields inherited from class lumis.doui.control.DataControl

FORCE_CASE_LOWER, FORCE_CASE_NONE, FORCE_CASE_UPPER, forceCase, requestParameterName, UNKNOWN_DATA_TYPE, value, valuePreviouslySet

Fields inherited from class lumis.doui.control.Control

childControls, controlContainer, controlDefinitionNode, controlResource, douiContext, hasValidatorSubControls, isValid, locale, ON_EVENT_CLOSE_WINDOW, ON_EVENT_LINK, ON_EVENT_POPUP_LINK_OR_RUNTIME_INTERFACE, ON_EVENT_POPUP_RUNTIME_INTERFACE, ON_EVENT_PROCESS_ACTION, ON_EVENT_RENDER_ACTION, ON_EVENT_REPLACE_INTERFACE, ON_EVENT_SCRIPT, ON_EVENT_VALIDATE, onEventScripts, PARAMETER_TYPE_FIRST_SELECTED, PARAMETER_TYPE_GET_VALUE, parentControl, resources, type, VALIDATION_SELECTED_MANY, VALIDATION_SELECTED_ONE

Constructor Summary

Constructors

Constructor	Description
DateTimePickerControl()

Method Summary

Modifier and Type	Method	Description
void	buildSubControls()
protected boolean	fixedIdentifierRequired()
IResource	getControlResource()
protected java.lang.Object	getParameterValue(java.lang.String parameterName)	Returns the value for this control, reading from request the parameters based on the specified name.
IDataControlRequestHelpDefinition	getRequestHelpDefinition()	Returns the request parameters help definition.
protected java.util.Map<java.lang.String,java.lang.String>	getStringsToLocalize()
protected java.lang.Class<? extends java.util.Date>	getValueClass()	Returns the class the possible values of this control are assignable to.
void	init(org.w3c.dom.Node controlDefinitionNode, ControlContainer controlContainer, IControl parentControl)
void	setRenderData()

Methods inherited from class lumis.doui.control.DataBoundControl

autoAddDateTimeValueValidator, autoAddDoubleValueValidator, autoAddFileSizeValidator, autoAddIntegerValueValidator, autoAddLengthValidator, autoAddLongValueValidator, autoAddRequiredValueValidator, autoAddValidators, createConverter, createDataType, getDataId, getFieldName, getProcessActionHandlerParameterName, getReload, getRuntimeDefaultSource, getSource, getSourceById, getSourceContext, getUnboundedConverter, loadFromRequest, setDefaultValue, setRawValue, setReload, setSourceParameter, setValid, setValueFromSource, setValueFromSource, update

Methods inherited from class lumis.doui.control.DataControl

convertValueToControlValue, getConverter, getDataType, getDefaultValue, getProcessActionIds, getRequestParameterName, getValue, getValue, initProcessActionIds, isTrim, loadSubControlFromRequest, loadSubControlsFromRequest, setProcessActionHandlerParameter, setProcessActionHandlerParameter, setProcessActionHandlerParameters, setSourceParameter, setSourceParameters, setTrim, setValue, valueIsArray

Methods inherited from class lumis.doui.control.Control

appendSubControl, appendSubControls, applyOnEventScripts, convertToStandardValue, createContainer, disconnect, generateControlId, generateControlIdPrefix, getAdditionalParameters, getAdditionalParameters, getAncestor, getChildControls, getClientEventHandlerScript, getId, getLocale, getName, getNamespace, getParentControl, getPrepareForReadScript, getRenderData, getResources, getScriptActionValidation, getType, getValidationScript, getWindowProperties, getWindowProperties, isRequired, isValid, localize, localizeStrings, processCustomTags, registerOnEventScript, removeChild, removeChildren, resolveVariable, setName, setRuntimeAttributes

Methods inherited from class java.lang.Object

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

Methods inherited from interface lumis.doui.control.IControl

createContainer, disconnect, getChildControls, getId, getName, getParentControl, getPrepareForReadScript, getRenderData, getResources, getType, isValid, registerOnEventScript, removeChild, removeChildren, setRuntimeAttributes

Methods inherited from interface lumis.doui.control.IDataControl

getConverter, getProcessActionIds, getValue, getValue, setProcessActionHandlerParameters, setValue

Methods inherited from interface lumis.doui.render.IRenderer

getResources

Field Detail

defaultDateFormat

protected java.lang.String defaultDateFormat

defaultTimeFormat

protected java.lang.String defaultTimeFormat

dateFormat

protected java.lang.String dateFormat

timeFormat

protected java.lang.String timeFormat

sdfDateTime

protected java.text.SimpleDateFormat sdfDateTime

sdfDate

protected java.text.SimpleDateFormat sdfDate

sdfTime

protected java.text.SimpleDateFormat sdfTime

sdfDay

protected java.text.SimpleDateFormat sdfDay

sdfMonth

protected java.text.SimpleDateFormat sdfMonth

sdfYear

protected java.text.SimpleDateFormat sdfYear

sdfHour

protected java.text.SimpleDateFormat sdfHour

sdfMinute

protected java.text.SimpleDateFormat sdfMinute

Constructor Detail

DateTimePickerControl

public DateTimePickerControl()

Method Detail

getValueClass

protected java.lang.Class<? extends java.util.Date> getValueClass()
                                                           throws PortalException

Description copied from class: DataControl

Returns the class the possible values of this control are assignable to.

This default implementation uses IDouiDataType.getValueClass() of the data type of this control.

Overrides:

getValueClass in class DataControl

Returns:

the class the possible values of this control are assignable to.

Throws:

PortalException

init

public void init(org.w3c.dom.Node controlDefinitionNode,
                 ControlContainer controlContainer,
                 IControl parentControl)
          throws PortalException

Specified by:

init in interface IControl

Overrides:

init in class DataBoundControl

Throws:

PortalException

fixedIdentifierRequired

protected boolean fixedIdentifierRequired()

Overrides:

fixedIdentifierRequired in class Control

getParameterValue

protected java.lang.Object getParameterValue(java.lang.String parameterName)
                                      throws PortalException

Description copied from class: DataControl

Returns the value for this control, reading from request the parameters based on the specified name.

DataControl.loadFromRequest() calls this method when necessary, to read the value to be set in the control.

Overrides:

getParameterValue in class DataControl

Parameters:

parameterName - the parameter name where the value is to be read from. For controls that require multiple request parameters, it is recommended to use the control's identifier as a prefix to its parameter names during render, and then can implement this method as using the given parameter name as the prefix.

Returns:

the value.

Throws:

PortalException

setRenderData

public void setRenderData()
                   throws PortalException

Specified by:

setRenderData in interface IControl

Overrides:

setRenderData in class DataBoundControl

Throws:

PortalException

buildSubControls

public void buildSubControls()
                      throws PortalException

Specified by:

buildSubControls in interface IControl

Overrides:

buildSubControls in class DataBoundControl

Throws:

PortalException

getStringsToLocalize

protected java.util.Map<java.lang.String,java.lang.String> getStringsToLocalize()

Overrides:

getStringsToLocalize in class Control

getControlResource

public IResource getControlResource()
                             throws PortalException

Specified by:

getControlResource in interface IControl

Overrides:

getControlResource in class Control

Throws:

PortalException

getRequestHelpDefinition

public IDataControlRequestHelpDefinition getRequestHelpDefinition()
                                                           throws PortalException

Description copied from interface: IDataControl

Returns the request parameters help definition. Used in process action REST API help. Must not return null.

Specified by:

getRequestHelpDefinition in interface IDataControl

Overrides:

getRequestHelpDefinition in class DataBoundControl

Returns:

the request parameters help definition. Used in process action REST API help. Must not return null.

Throws:

PortalException