jakarta.faces.component

Class UISelectOne

java.lang.Object

jakarta.faces.component.UIComponent

jakarta.faces.component.UIComponentBase

jakarta.faces.component.UIOutput

jakarta.faces.component.UIInput

jakarta.faces.component.UISelectOne

All Implemented Interfaces:

EditableValueHolder, PartialStateHolder, StateHolder, TransientStateHolder, ValueHolder, ComponentSystemEventListener, FacesListener, SystemEventListenerHolder, EventListener

Direct Known Subclasses:

HtmlSelectOneListbox, HtmlSelectOneMenu, HtmlSelectOneRadio

@JSFComponent(defaultRendererType="jakarta.faces.Menu")
 @JSFJspProperty(name="hideNoSelectionOption",
                returnType="boolean")
public class UISelectOne
extends UIInput

Component for choosing one option out of a set of possibilities.

This component is expected to have children of type UISelectItem or UISelectItems; these define the set of possible options that the user can choose from.

See the javadoc for this class in the JSF Specification for further details.

Field Summary

Fields

Modifier and Type	Field and Description
static String	COMPONENT_FAMILY
static String	COMPONENT_TYPE
static String	INVALID_MESSAGE_ID

Fields inherited from class jakarta.faces.component.UIInput

ALWAYS_PERFORM_VALIDATION_WHEN_REQUIRED_IS_TRUE, CONVERSION_MESSAGE_ID, EMPTY_STRING_AS_NULL_PARAM_NAME, REQUIRED_MESSAGE_ID, UPDATE_MESSAGE_ID, VALIDATE_EMPTY_FIELDS_PARAM_NAME

Fields inherited from class jakarta.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

Constructor Summary

Constructors

Constructor and Description
UISelectOne()

Method Summary

Modifier and Type	Method and Description
String	getFamily()
String	getGroup()
void	processValidators(FacesContext context) Verify that when ever there is a ValueExpression and submitted value is not empty, then visit all the UISelectItem elements within the UISelectOne radio components to check if the submitted value exists in any of the select items.
void	setGroup(String group)
protected void	validateValue(FacesContext context, Object value) Verify that the result of converting the newly submitted value is equal to the value property of one of the child SelectItem objects.

Methods inherited from class jakarta.faces.component.UIInput

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

Methods inherited from class jakarta.faces.component.UIOutput

getConverter, getLocalValue, setConverter

Methods inherited from class jakarta.faces.component.UIComponentBase

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

Methods inherited from class jakarta.faces.component.UIComponent

getClientId, getCompositeComponentParent, getContainerClientId, getCurrentComponent, getCurrentCompositeComponent, getListenersForEventClass, getNamingContainer, getPassThroughAttributes, getResourceBundleMap, getStateHelper, getStateHelper, getTransientStateHelper, getTransientStateHelper, getValueExpression, initialStateMarked, isCompositeComponent, isInView, isVisitable, popComponentFromEL, processEvent, pushComponentToEL, restoreTransientState, saveTransientState, setInView, setValueExpression, subscribeToEvent, unsubscribeFromEvent

Methods inherited from class java.lang.Object

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

Methods inherited from interface jakarta.faces.component.ValueHolder

getConverter, getLocalValue, setConverter

Field Detail

COMPONENT_TYPE

public static final String COMPONENT_TYPE

See Also:

Constant Field Values

COMPONENT_FAMILY

public static final String COMPONENT_FAMILY

See Also:

Constant Field Values

INVALID_MESSAGE_ID

public static final String INVALID_MESSAGE_ID

See Also:

Constant Field Values

Constructor Detail

UISelectOne

public UISelectOne()

Method Detail

getFamily

public String getFamily()

Overrides:

getFamily in class UIInput

processValidators

public void processValidators(FacesContext context)

Verify that when ever there is a ValueExpression and submitted value is not empty, then visit all the UISelectItem elements within the UISelectOne radio components to check if the submitted value exists in any of the select items.

Overrides:

processValidators in class UIInput

See Also:

UIInput.processValidators(FacesContext)

validateValue

protected void validateValue(FacesContext context,
                             Object value)

Verify that the result of converting the newly submitted value is equal to the value property of one of the child SelectItem objects. If this is not true, a validation error is reported.

Overrides:

validateValue in class UIInput

See Also:

UIInput.validateValue(FacesContext,java.lang.Object)

getGroup

public String getGroup()

setGroup

public void setGroup(String group)