Package 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 UIInputComponent 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 Faces Specification for further details.
-
-
Field Summary
Fields Modifier and Type Field Description static StringCOMPONENT_FAMILYstatic StringCOMPONENT_TYPEstatic StringINVALID_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, FACETS_KEY, VIEW_LOCATION_KEY
-
-
Constructor Summary
Constructors Constructor Description UISelectOne()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description StringgetFamily()StringgetGroup()voidprocessValidators(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.voidsetGroup(String group)protected voidvalidateValue(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, getValidatorMessage, getValidators, getValue, getValueChangeListeners, isEmpty, isImmediate, isLocalValueSet, isRequired, isValid, markInitialState, processDecodes, processUpdates, removeValidator, removeValueChangeListener, resetValue, restoreState, saveState, setConverterMessage, setImmediate, setLocalValueSet, setRequired, setRequiredMessage, setSubmittedValue, setValid, setValidatorMessage, setValue, 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, invokeOnComponent, isRendered, isTransient, processRestoreState, processSaveState, queueEvent, removeFacesListener, restoreAttachedState, saveAttachedState, setId, setParent, setRendered, setRendererType, setTransient, 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
-
-
Method Detail
-
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:
processValidatorsin classUIInput- See Also:
UIInput.processValidators(jakarta.faces.context.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:
validateValuein classUIInput- See Also:
UIInput.validateValue(jakarta.faces.context.FacesContext,java.lang.Object)
-
getGroup
public String getGroup()
-
setGroup
public void setGroup(String group)
-
-