|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectjavax.faces.component.UIComponent
javax.faces.component.UIComponentBase
javax.faces.component.UIOutput
javax.faces.component.UIInput
javax.faces.component.UISelectMany
@JSFComponent(defaultRendererType="javax.faces.Listbox") 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 |
| Fields inherited from class javax.faces.component.UIComponent |
|---|
bindings |
| 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 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, 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 UIInputpublic 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 UIComponentBase
public void setValueBinding(String name,
ValueBinding binding)
UIComponentBase
setValueBinding in class UIComponentBasepublic 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 UIInputpublic void validate(FacesContext context)
validate in class UIInput
protected Object getConvertedValue(FacesContext context,
Object submittedValue)
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 UIInput
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||