org.josef.web.jsf.binding.jcc

Class DateSelect

java.lang.Object

javax.faces.component.UIComponent

javax.faces.component.UIComponentBase

javax.faces.component.UIOutput

javax.faces.component.UIInput

org.josef.web.jsf.binding.jcc.DateSelect

All Implemented Interfaces:

EventListener, javax.faces.component.EditableValueHolder, javax.faces.component.NamingContainer, javax.faces.component.PartialStateHolder, javax.faces.component.StateHolder, javax.faces.component.TransientStateHolder, javax.faces.component.ValueHolder, javax.faces.event.ComponentSystemEventListener, javax.faces.event.FacesListener, javax.faces.event.SystemEventListenerHolder

public class DateSelect
extends javax.faces.component.UIInput
implements javax.faces.component.NamingContainer

Backing bean for the DateSelect composite component.
Based upon: Core JavaServer faces 3rd edition, Chapter 9.

Version:

1.0 $Revision: 6248 $

Author:

Kees Schotanus

Field Summary

Fields inherited from class javax.faces.component.UIInput

COMPONENT_FAMILY, COMPONENT_TYPE, CONVERSION_MESSAGE_ID, REQUIRED_MESSAGE_ID, UPDATE_MESSAGE_ID, VALIDATE_EMPTY_FIELDS_PARAM_NAME

Fields inherited from class javax.faces.component.UIComponent

ATTRS_WITH_DECLARED_DEFAULT_VALUES, BEANINFO_KEY, bindings, COMPOSITE_COMPONENT_TYPE_KEY, COMPOSITE_FACET_NAME, CURRENT_COMPONENT, CURRENT_COMPOSITE_COMPONENT, FACETS_KEY, HONOR_CURRENT_COMPONENT_ATTRIBUTES_PARAM_NAME, VIEW_LOCATION_KEY

Fields inherited from interface javax.faces.component.NamingContainer

SEPARATOR_CHAR

Constructor Summary

Constructors

Constructor and Description
DateSelect()

Method Summary

Modifier and Type	Method and Description
Integer[]	createDays(int maximumDay) Creates the days the user can select from.
Map<String,Integer>	createMonths() Creates the months the user can select from.
Integer[]	createYears(int maximumYear, int minimumYear) Creates the years the user can select from.
void	encodeBegin(javax.faces.context.FacesContext facesContext) Sets the values of the day, month and year from the model date.
protected Object	getConvertedValue(javax.faces.context.FacesContext facesContext, Object submittedValue) Converts the submitted value to a Date.
javax.faces.component.UIInput	getDayComponent() Gets the day component.
Integer[]	getDays() Gets the days the user can select from.
String	getFamily() Gets the component family.
javax.faces.component.UIInput	getMonthComponent() Gets the month component.
Map<String,Integer>	getMonths() Gets the months the user can select from.
Object	getSubmittedValue() Gets the submitted value.
javax.faces.component.UIInput	getYearComponent() Gets the year component.
Integer[]	getYears() Gets the years the user can select from.
void	processDate(javax.faces.event.AjaxBehaviorEvent event) Process a date that the user has selected.
void	setDayComponent(javax.faces.component.UIInput day) Sets the day component.
void	setDays(Integer[] days) Sets the days the user can select from.
void	setMonthComponent(javax.faces.component.UIInput month) Sets the month component.
void	setMonths(Map<String,Integer> months) Sets the months the user can select from.
void	setYearComponent(javax.faces.component.UIInput year) Sets the year component.
void	setYears(Integer[] years) Sets the years the user can select from.

Methods inherited from class javax.faces.component.UIInput

addValidator, addValueChangeListener, clearInitialState, compareValues, decode, getConverterMessage, getRequiredMessage, getValidator, getValidatorMessage, getValidators, getValueChangeListener, getValueChangeListeners, isEmpty, isImmediate, isLocalValueSet, isRequired, isValid, markInitialState, processDecodes, processUpdates, processValidators, removeValidator, removeValueChangeListener, resetValue, restoreState, saveState, setConverterMessage, setImmediate, setLocalValueSet, setRequired, setRequiredMessage, setSubmittedValue, setValid, setValidator, setValidatorMessage, setValue, setValueChangeListener, updateModel, validate, validateValue

Methods inherited from class javax.faces.component.UIOutput

getConverter, getLocalValue, getValue, setConverter

Methods inherited from class javax.faces.component.UIComponentBase

addClientBehavior, addFacesListener, broadcast, encodeChildren, encodeEnd, findComponent, getAttributes, getChildCount, getChildren, getClientBehaviors, getClientId, getDefaultEventName, getEventNames, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getListenersForEventClass, getParent, getRenderer, getRendererType, getRendersChildren, getValueBinding, invokeOnComponent, isRendered, isTransient, processRestoreState, processSaveState, queueEvent, removeFacesListener, restoreAttachedState, saveAttachedState, setId, setParent, setRendered, setRendererType, setTransient, setValueBinding, subscribeToEvent, unsubscribeFromEvent

Methods inherited from class javax.faces.component.UIComponent

encodeAll, getClientId, getCompositeComponentParent, getContainerClientId, getCurrentComponent, getCurrentCompositeComponent, getNamingContainer, getResourceBundleMap, getStateHelper, getStateHelper, getTransientStateHelper, getTransientStateHelper, getValueExpression, initialStateMarked, isCompositeComponent, isInView, isVisitable, popComponentFromEL, processEvent, pushComponentToEL, restoreTransientState, saveTransientState, setInView, setValueExpression, visitTree

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.faces.component.ValueHolder

getConverter, getLocalValue, getValue, setConverter

Constructor Detail

DateSelect

public DateSelect()

Method Detail

getDayComponent

public javax.faces.component.UIInput getDayComponent()

Gets the day component.

Returns:

The day component.

setDayComponent

public void setDayComponent(javax.faces.component.UIInput day)

Sets the day component.

Parameters:

day - The day component.

getMonthComponent

public javax.faces.component.UIInput getMonthComponent()

Gets the month component.

Returns:

The month component.

setMonthComponent

public void setMonthComponent(javax.faces.component.UIInput month)

Sets the month component.

Parameters:

month - The month component.

getYearComponent

public javax.faces.component.UIInput getYearComponent()

Gets the year component.

Returns:

The year component.

setYearComponent

public void setYearComponent(javax.faces.component.UIInput year)

Sets the year component.

Parameters:

year - The year component.

getFamily

public String getFamily()

Gets the component family.
This is mandatory for a composite component.

Overrides:

getFamily in class javax.faces.component.UIInput

Returns:

The component family.

encodeBegin

public void encodeBegin(javax.faces.context.FacesContext facesContext)
                 throws IOException

Sets the values of the day, month and year from the model date.

Overrides:

encodeBegin in class javax.faces.component.UIComponentBase

Parameters:

facesContext - The FacesContext.

Throws:

IOException - When thrown by the superclass.

getSubmittedValue

public Object getSubmittedValue()

Gets the submitted value.
The format is not important since it is only used internally but it is an ISO date (YYYY-MM-DD).

Specified by:

getSubmittedValue in interface javax.faces.component.EditableValueHolder

Overrides:

getSubmittedValue in class javax.faces.component.UIInput

Returns:

The submitted value.

getConvertedValue

protected Object getConvertedValue(javax.faces.context.FacesContext facesContext,
                                   Object submittedValue)

Converts the submitted value to a Date.

Overrides:

getConvertedValue in class javax.faces.component.UIInput

Parameters:

facesContext - The FacesContext.

submittedValue - The submitted value.

Returns:

The submitted value as a Date.

Throws:

javax.faces.convert.ConverterException - When the submitted value could not be converted to a Date.
This is not to be expected since the submitted value is determined by the system (and not by the user).

processDate

public void processDate(javax.faces.event.AjaxBehaviorEvent event)

Process a date that the user has selected.
Processing involves: setting the date value to the backing bean and creating the proper number of days

Parameters:

event - The ajax event.

createDays

public Integer[] createDays(int maximumDay)

Creates the days the user can select from.

Parameters:

maximumDay - The maximum day the user can select.

Returns:

The days the user can select from.

createMonths

public Map<String,Integer> createMonths()

Creates the months the user can select from.

Returns:

The months the user can select from.

createYears

public Integer[] createYears(int maximumYear,
                             int minimumYear)

Creates the years the user can select from.

Parameters:

maximumYear - The maximum year.

minimumYear - The minimum year.

Returns:

The years the user can select from.

getDays

public Integer[] getDays()

Gets the days the user can select from.

Returns:

The days the user can select from.

setDays

public void setDays(Integer[] days)

Sets the days the user can select from.

Parameters:

days - The days the user can select from.

getMonths

public final Map<String,Integer> getMonths()

Gets the months the user can select from.

Returns:

The months the user can select from.

setMonths

public void setMonths(Map<String,Integer> months)

Sets the months the user can select from.

Parameters:

months - The months the user can select from.

getYears

public Integer[] getYears()

Gets the years the user can select from.

Returns:

The years the user can select from.

setYears

public void setYears(Integer[] years)

Sets the years the user can select from.

Parameters:

years - The years the user can select from.