Class UISelectMany
- All Implemented Interfaces:
- EditableValueHolder,- PartialStateHolder,- StateHolder,- TransientStateHolder,- ValueHolder,- ComponentSystemEventListener,- FacesListener,- SystemEventListenerHolder,- EventListener
- Direct Known Subclasses:
- HtmlSelectManyCheckbox,- HtmlSelectManyListbox,- HtmlSelectManyMenu
This is not an abstract class; java code can create an instance of this, configure its rendererType appropriately, and add it to a view. However there is no tag class for this component, ie it cannot be added directly to a page when using JSP (and other presentation technologies are expected to behave similarly). Instead, there is a family of subclasses that extend this base functionality, and they do have tag classes.
See the javadoc for this class in the JSF Specification for further details.
- 
Field SummaryFieldsFields inherited from class jakarta.faces.component.UIInputALWAYS_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_NAMEFields inherited from class jakarta.faces.component.UIComponentATTRS_WITH_DECLARED_DEFAULT_VALUES, BEANINFO_KEY, bindings, COMPOSITE_COMPONENT_TYPE_KEY, COMPOSITE_FACET_NAME, FACETS_KEY, VIEW_LOCATION_KEY
- 
Constructor SummaryConstructors
- 
Method SummaryModifier and TypeMethodDescriptionprotected booleancompareValues(Object previous, Object value) protected ObjectgetConvertedValue(FacesContext context, Object submittedValue) Convert the provided object to the desired value.Object[]jakarta.el.ValueExpressiongetValueExpression(String name) voidsetSelectedValues(Object[] selectedValues) voidsetValueExpression(String name, jakarta.el.ValueExpression binding) protected voidvalidateValue(FacesContext context, Object convertedValue) Methods inherited from class jakarta.faces.component.UIInputaddValidator, addValueChangeListener, broadcast, clearInitialState, decode, getConverterMessage, getRequiredMessage, getSubmittedValue, getValidatorMessage, getValidators, getValue, getValueChangeListeners, isEmpty, isImmediate, isLocalValueSet, isRequired, isValid, markInitialState, processDecodes, processUpdates, processValidators, removeValidator, removeValueChangeListener, resetValue, restoreState, saveState, setConverterMessage, setImmediate, setLocalValueSet, setRequired, setRequiredMessage, setSubmittedValue, setValid, setValidatorMessage, setValue, updateModel, validateMethods inherited from class jakarta.faces.component.UIOutputgetConverter, getLocalValue, setConverterMethods inherited from class jakarta.faces.component.UIComponentBaseaddClientBehavior, 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, visitTreeMethods inherited from class jakarta.faces.component.UIComponentgetClientId, getCompositeComponentParent, getContainerClientId, getCurrentComponent, getCurrentCompositeComponent, getListenersForEventClass, getNamingContainer, getPassThroughAttributes, getResourceBundleMap, getStateHelper, getStateHelper, getTransientStateHelper, getTransientStateHelper, initialStateMarked, isCompositeComponent, isInView, isVisitable, popComponentFromEL, processEvent, pushComponentToEL, restoreTransientState, saveTransientState, setInView, subscribeToEvent, unsubscribeFromEventMethods inherited from class java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface jakarta.faces.component.ValueHoldergetConverter, getLocalValue, setConverter
- 
Field Details- 
COMPONENT_TYPE- See Also:
 
- 
COMPONENT_FAMILY- See Also:
 
- 
INVALID_MESSAGE_ID- See Also:
 
 
- 
- 
Constructor Details- 
UISelectManypublic UISelectMany()
 
- 
- 
Method Details- 
getFamily
- 
getSelectedValues
- 
setSelectedValues
- 
getValueExpression- Overrides:
- getValueExpressionin class- UIComponent
 
- 
setValueExpression- Overrides:
- setValueExpressionin class- UIComponent
 
- 
compareValues- Overrides:
- compareValuesin class- UIInput
- Returns:
- true if Objects are different (!)
 
- 
validateValue- Overrides:
- validateValuein class- UIInput
 
- 
getConvertedValueprotected Object getConvertedValue(FacesContext context, Object submittedValue) throws ConverterException Description copied from class:UIInputConvert the provided object to the desired value.If there is a renderer for this component, then call the renderer's getConvertedValue method. While this can of course be implemented in any way the renderer desires, it typically performs exactly the same processing that this method would have done anyway (ie that described below for the no-renderer case). Otherwise: - If the submittedValue is not a String then just return the submittedValue unconverted.
- If there is no "value" value-binding then just return the submittedValue unconverted.
- Use introspection to determine the type of the target property specified by the value-binding, and then use Application.createConverter to find a converter that can map from String to the required type. Apply the converter to the submittedValue and return the result.
 - Overrides:
- getConvertedValuein class- UIInput
- Throws:
- ConverterException
 
 
-