|
Préférences
Moteurs de recherche
|
|||||||||||||||||||||||||||||||||||||||||||||||
JavaTM Platform, Enterprise Edition, v 5.0
javax.faces.component
|
Field Summary | |
---|---|
static String |
COMPONENT_FAMILY
The standard component family for this component. |
static String |
COMPONENT_TYPE
The standard component type for this component. |
static String |
INVALID_MESSAGE_ID
The message identifier of the FacesMessage to be created if
a value not matching the available options is specified. |
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()
Create a new UISelectMany instance with default property
values. |
Method Summary | |
---|---|
protected boolean |
compareValues(Object previous,
Object value)
Return true if the new value is different from the
previous value. |
String |
getFamily()
Return the identifier of the component family to which this component belongs. |
Object[] |
getSelectedValues()
Return the currently selected values, or null if there
are no currently selected values. |
ValueBinding |
getValueBinding(String name)
Deprecated. this has been replaced by getValueExpression(java.lang.String) . |
ValueExpression |
getValueExpression(String name)
Return any ValueExpression set for value if a
ValueExpression for selectedValues is requested;
otherwise, perform the default superclass processing for this method. |
void |
setSelectedValues(Object[] selectedValues)
Set the currently selected values, or null to indicate
that there are no currently selected values. |
void |
setValueBinding(String name,
ValueBinding binding)
Deprecated. This has been replaced by setValueExpression(java.lang.String, javax.el.ValueExpression) . |
void |
setValueExpression(String name,
ValueExpression binding)
Store any ValueExpression specified for
selectedValues under value instead;
otherwise, perform the default superclass processing for this method. |
protected void |
validateValue(FacesContext context,
Object value)
In addition to the standard validation behavior inherited from UIInput , ensure that any specified values are equal to one of
the available options. |
Methods inherited from class javax.faces.component.UIOutput |
---|
getConverter, getLocalValue, getValue, setConverter |
Methods inherited from class javax.faces.component.UIComponentBase |
---|
addFacesListener, broadcast, 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 |
---|
public static final String COMPONENT_TYPE
The standard component type for this component.
public static final String COMPONENT_FAMILY
The standard component family for this component.
public static final String INVALID_MESSAGE_ID
The message identifier of the
FacesMessage
to be created if
a value not matching the available options is specified.
Constructor Detail |
---|
public UISelectMany()
Create a new UISelectMany
instance with default property
values.
Method Detail |
---|
public String getFamily()
UIComponent
Return the identifier of the component family to which this
component belongs. This identifier, in conjunction with the value
of the rendererType
property, may be used to select
the appropriate Renderer
for this component instance.
public Object[] getSelectedValues()
Return the currently selected values, or null
if there
are no currently selected values. This is a typesafe alias for
getValue()
.
public void setSelectedValues(Object[] selectedValues)
Set the currently selected values, or null
to indicate
that there are no currently selected values. This is a typesafe
alias for setValue()
.
selectedValues
- The new selected values (if any)public ValueBinding getValueBinding(String name)
getValueExpression(java.lang.String)
.
Return any ValueBinding
set for value
if
a ValueBinding
for selectedValues
is
requested; otherwise, perform the default superclass processing
for this method.
This method relies on the superclass to provide the
ValueExpression
to ValueBinding
wrapping.
getValueBinding
in class UIComponentBase
name
- Name of the attribute or property for which to retrieve
a ValueBinding
NullPointerException
- if name
is null
public void setValueBinding(String name, ValueBinding binding)
setValueExpression(java.lang.String, javax.el.ValueExpression)
.
Store any ValueBinding
specified for
selectedValues
under value
instead;
otherwise, perform the default superclass processing for this
method.
This method relies on the superclass to wrap the argument
ValueBinding
in a ValueExpression
.
setValueBinding
in class UIComponentBase
name
- Name of the attribute or property for which to set
a ValueBinding
binding
- The ValueBinding
to set, or null
to remove any currently set ValueBinding
NullPointerException
- if name
is null
public ValueExpression getValueExpression(String name)
Return any ValueExpression
set for value
if a
ValueExpression
for selectedValues
is requested;
otherwise, perform the default superclass processing for this method.
getValueExpression
in class UIComponentBase
name
- Name of the attribute or property for which to retrieve
a ValueExpression
NullPointerException
- if name
is null
public void setValueExpression(String name, ValueExpression binding)
Store any ValueExpression
specified for
selectedValues
under value
instead;
otherwise, perform the default superclass processing for this method.
setValueExpression
in class UIComponentBase
name
- Name of the attribute or property for which to set
a ValueExpression
binding
- The ValueExpression
to set, or null
to remove any currently set ValueExpression
NullPointerException
- if name
is null
protected boolean compareValues(Object previous, Object value)
Return true
if the new value is different from the
previous value. Value comparison must not be sensitive to element order.
compareValues
in class UIInput
previous
- old value of this componentvalue
- new value of this componentprotected void validateValue(FacesContext context, Object value)
In addition to the standard validation behavior inherited from
UIInput
, ensure that any specified values are equal to one of
the available options. Before comparing each option, coerce the
option value type to the type of this component's value following
the Expression Language coercion rules. If the specified value is not
equal to any of the options, enqueue an error message
and set the valid
property to false
.
validateValue
in class UIInput
context
- The FacesContext
for the current requestvalue
- The converted value to test for membership.
NullPointerException
- if context
is null