|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object javax.faces.component.UIComponent javax.faces.component.UIComponentBase javax.faces.component.UIOutput javax.faces.component.UIInput javax.faces.component.UISelectMany
@JSFComponent(defaultRendererType="javax.faces.Listbox") @JSFJspProperties(properties={@JSFJspProperty(name="hideNoSelectionOption",returnType="boolean"),@JSFJspProperty(name="collectionType",returnType="java.lang.String")}) public class UISelectMany
Base class for the various component classes that allow a user to select zero or more options from a set.
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 Summary | |
---|---|
static String |
COMPONENT_FAMILY
|
static String |
COMPONENT_TYPE
|
static String |
INVALID_MESSAGE_ID
|
Fields inherited from class javax.faces.component.UIInput |
---|
CONVERSION_MESSAGE_ID, REQUIRED_MESSAGE_ID, UPDATE_MESSAGE_ID, VALIDATE_EMPTY_FIELDS_PARAM_NAME |
Fields inherited from class javax.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 | |
---|---|
UISelectMany()
|
Method Summary | |
---|---|
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)
|
Methods inherited from class javax.faces.component.UIOutput |
---|
getConverter, getLocalValue, setConverter |
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, setConverter |
Field Detail |
---|
public static final String COMPONENT_TYPE
public static final String COMPONENT_FAMILY
public static final String INVALID_MESSAGE_ID
Constructor Detail |
---|
public UISelectMany()
Method Detail |
---|
public String getFamily()
getFamily
in class UIInput
public Object[] getSelectedValues()
public void setSelectedValues(Object[] selectedValues)
public ValueBinding getValueBinding(String name)
UIComponentBase
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.
getValueBinding
in class UIComponentBase
public void setValueBinding(String name, ValueBinding binding)
UIComponentBase
setValueBinding
in class UIComponentBase
public javax.el.ValueExpression getValueExpression(String name)
getValueExpression
in class UIComponent
public void setValueExpression(String name, javax.el.ValueExpression binding)
setValueExpression
in class UIComponent
protected boolean compareValues(Object previous, Object value)
compareValues
in class UIInput
protected void validateValue(FacesContext context, Object convertedValue)
validateValue
in class UIInput
public void validate(FacesContext context)
validate
in class UIInput
protected Object getConvertedValue(FacesContext context, Object submittedValue) throws ConverterException
UIInput
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:
getConvertedValue
in class UIInput
ConverterException
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |