javax.faces.component
Class UISelectMany

java.lang.Object
  extended by javax.faces.component.UIComponent
      extended by javax.faces.component.UIComponentBase
          extended by javax.faces.component.UIOutput
              extended by javax.faces.component.UIInput
                  extended by javax.faces.component.UISelectMany
All Implemented Interfaces:
EditableValueHolder, StateHolder, ValueHolder
Direct Known Subclasses:
HtmlSelectManyCheckbox, HtmlSelectManyListbox, HtmlSelectManyMenu

public class UISelectMany
extends UIInput

Events:

Type Phases Description
javax.faces.event.ValueChangeEvent The valueChange event is delivered when the value attribute is changed.


Field Summary
static java.lang.String COMPONENT_FAMILY
           
static java.lang.String COMPONENT_TYPE
           
static java.lang.String INVALID_MESSAGE_ID
           
 
Fields inherited from class javax.faces.component.UIInput
CONVERSION_MESSAGE_ID, REQUIRED_MESSAGE_ID, UPDATE_MESSAGE_ID
 
Fields inherited from class javax.faces.component.UIComponent
bindings
 
Constructor Summary
UISelectMany()
          Construct an instance of the UISelectMany.
 
Method Summary
protected  boolean compareValues(java.lang.Object previous, java.lang.Object value)
           
protected  java.lang.Object getConvertedValue(FacesContext context, java.lang.Object submittedValue)
          Convert the provided object to the desired value.
 java.lang.String getFamily()
           
 java.lang.Object[] getSelectedValues()
           
 ValueBinding getValueBinding(java.lang.String name)
          Deprecated. Use getValueExpression instead
 javax.el.ValueExpression getValueExpression(java.lang.String name)
           
 void setSelectedValues(java.lang.Object[] selectedValues)
           
 void setValueBinding(java.lang.String name, ValueBinding binding)
          Deprecated. Use setValueExpression instead
 void setValueExpression(java.lang.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, java.lang.Object convertedValue)
           
 
Methods inherited from class javax.faces.component.UIInput
addValidator, addValueChangeListener, broadcast, decode, getConverterMessage, getRequiredMessage, getSubmittedValue, getValidator, getValidatorMessage, getValidators, getValueChangeListener, getValueChangeListeners, isImmediate, isLocalValueSet, isRequired, isValid, processDecodes, processUpdates, processValidators, removeValidator, removeValueChangeListener, resetValue, restoreState, saveState, setConverterMessage, setImmediate, setLocalValueSet, setRequired, setRequiredMessage, setSubmittedValue, setValid, setValidator, setValidatorMessage, setValue, setValueChangeListener, updateModel
 
Methods inherited from class javax.faces.component.UIOutput
getConverter, getLocalValue, getValue, setConverter
 
Methods inherited from class javax.faces.component.UIComponentBase
addFacesListener, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttributes, getChildCount, getChildren, getClientId, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getParent, getRenderer, getRendererType, getRendersChildren, invokeOnComponent, isRendered, isTransient, processRestoreState, processSaveState, queueEvent, removeFacesListener, restoreAttachedState, saveAttachedState, setId, setParent, setRendered, setRendererType, setTransient
 
Methods inherited from class javax.faces.component.UIComponent
encodeAll, getContainerClientId
 
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
 

Field Detail

COMPONENT_FAMILY

public static final java.lang.String COMPONENT_FAMILY
See Also:
Constant Field Values

COMPONENT_TYPE

public static final java.lang.String COMPONENT_TYPE
See Also:
Constant Field Values

INVALID_MESSAGE_ID

public static final java.lang.String INVALID_MESSAGE_ID
See Also:
Constant Field Values
Constructor Detail

UISelectMany

public UISelectMany()
Construct an instance of the UISelectMany.

Method Detail

getSelectedValues

public java.lang.Object[] getSelectedValues()

setSelectedValues

public void setSelectedValues(java.lang.Object[] selectedValues)

getValueBinding

public ValueBinding getValueBinding(java.lang.String name)
Deprecated. Use getValueExpression instead

Description copied from class: UIComponentBase
Get the named value-binding associated with this component.

Value-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.

Overrides:
getValueBinding in class UIComponentBase

setValueBinding

public void setValueBinding(java.lang.String name,
                            ValueBinding binding)
Deprecated. Use setValueExpression instead

Description copied from class: UIComponentBase
Put the provided value-binding into a map of value-bindings associated with this component.

Overrides:
setValueBinding in class UIComponentBase

getValueExpression

public javax.el.ValueExpression getValueExpression(java.lang.String name)
Overrides:
getValueExpression in class UIComponent

setValueExpression

public void setValueExpression(java.lang.String name,
                               javax.el.ValueExpression binding)
Overrides:
setValueExpression in class UIComponent

compareValues

protected boolean compareValues(java.lang.Object previous,
                                java.lang.Object value)
Overrides:
compareValues in class UIInput
Returns:
true if Objects are different (!)

validateValue

protected void validateValue(FacesContext context,
                             java.lang.Object convertedValue)
Overrides:
validateValue in class UIInput

validate

public void validate(FacesContext context)
First part is identical to super.validate except the empty condition. Second part: iterate through UISelectItem and UISelectItems and check current values against these items

Overrides:
validate in class UIInput

getConvertedValue

protected java.lang.Object getConvertedValue(FacesContext context,
                                             java.lang.Object submittedValue)
Description copied from class: UIInput
Convert 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:

Overrides:
getConvertedValue in class UIInput

getFamily

public java.lang.String getFamily()
Overrides:
getFamily in class UIInput


Copyright © 2011 Apache Software Foundation. All Rights Reserved.