@JSFComponent(defaultRendererType="javax.faces.Listbox")
@JSFJspProperties(properties={@JSFJspProperty(name="hideNoSelectionOption",returnType="boolean"),@JSFJspProperty(name="collectionType",returnType="java.lang.String")})
public class UISelectMany
extends UIInput
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.
| Modifier and Type | Field and Description |
|---|---|
static String |
COMPONENT_FAMILY |
static String |
COMPONENT_TYPE |
static String |
INVALID_MESSAGE_ID |
CONVERSION_MESSAGE_ID, REQUIRED_MESSAGE_ID, UPDATE_MESSAGE_ID, VALIDATE_EMPTY_FIELDS_PARAM_NAMEBEANINFO_KEY, bindings, COMPOSITE_COMPONENT_TYPE_KEY, COMPOSITE_FACET_NAME, CURRENT_COMPONENT, CURRENT_COMPOSITE_COMPONENT, FACETS_KEY, VIEW_LOCATION_KEY| Constructor and Description |
|---|
UISelectMany() |
| Modifier and Type | Method and Description |
|---|---|
protected boolean |
compareValues(Object previous,
Object value) |
protected Object |
getConvertedValue(FacesContext context,
Object submittedValue)
Convert the provided object to the desired value.
|
String |
getFamily() |
Object[] |
getSelectedValues() |
ValueBinding |
getValueBinding(String name)
Deprecated.
Use getValueExpression instead
|
javax.el.ValueExpression |
getValueExpression(String name) |
void |
setSelectedValues(Object[] selectedValues) |
void |
setValueBinding(String name,
ValueBinding binding)
Deprecated.
Use setValueExpression instead
|
void |
setValueExpression(String name,
javax.el.ValueExpression binding) |
void |
validate(FacesContext context)
First part is identical to super.validate except the empty condition.
|
protected void |
validateValue(FacesContext context,
Object convertedValue) |
addValidator, addValueChangeListener, broadcast, clearInitialState, decode, getConverterMessage, getRequiredMessage, getSubmittedValue, getValidator, getValidatorMessage, getValidators, getValue, 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, updateModelgetConverter, getLocalValue, setConverteraddClientBehavior, addFacesListener, encodeAll, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttributes, getChildCount, getChildren, getClientBehaviors, getClientId, getDefaultEventName, getEventNames, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getParent, getRenderer, getRendererType, getRendersChildren, initialStateMarked, invokeOnComponent, isRendered, isTransient, processRestoreState, processSaveState, queueEvent, removeFacesListener, restoreAttachedState, saveAttachedState, setId, setParent, setRendered, setRendererType, setTransient, visitTreegetClientId, getCompositeComponentParent, getContainerClientId, getCurrentComponent, getCurrentCompositeComponent, getListenersForEventClass, getNamingContainer, getResourceBundleMap, getStateHelper, getStateHelper, isCompositeComponent, isInView, isVisitable, popComponentFromEL, processEvent, pushComponentToEL, setInView, subscribeToEvent, unsubscribeFromEventclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitgetConverter, getLocalValue, setConverterpublic static final String COMPONENT_TYPE
public static final String COMPONENT_FAMILY
public static final String INVALID_MESSAGE_ID
public Object[] getSelectedValues()
public void setSelectedValues(Object[] selectedValues)
public ValueBinding getValueBinding(String name)
UIComponentBaseValue-bindings are stored in a map associated with the component, though there is commonly a property (setter/getter methods) of the same name defined on the component itself which evaluates the value-binding when called.
getValueBinding in class UIComponentBasepublic void setValueBinding(String name, ValueBinding binding)
UIComponentBasesetValueBinding in class UIComponentBasepublic javax.el.ValueExpression getValueExpression(String name)
getValueExpression in class UIComponentpublic void setValueExpression(String name, javax.el.ValueExpression binding)
setValueExpression in class UIComponentprotected boolean compareValues(Object previous, Object value)
compareValues in class UIInputprotected void validateValue(FacesContext context, Object convertedValue)
validateValue in class UIInputpublic void validate(FacesContext context)
protected Object getConvertedValue(FacesContext context, Object submittedValue) throws ConverterException
UIInputIf 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:
getConvertedValue in class UIInputConverterExceptionCopyright © 2021 The Apache Software Foundation. All Rights Reserved.