|
DRAFT | ||||||||
| 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.UISelectOne
public class UISelectOne
UISelectOne is a
UIComponent that represents the user's choice of zero or one
items from among a discrete set of available options. The user can
modify the selected value. Optionally, the component can be
preconfigured with a currently selected item, by storing it as the
value property of the component.
This component is generally rendered as a select box or a group of radio buttons.
By default, the rendererType property is set to
"javax.faces.Menu". This value can be changed by
calling the setRendererType() method.
| Field Summary | |
|---|---|
static java.lang.String |
COMPONENT_FAMILY
The standard component family for this component. |
static java.lang.String |
COMPONENT_TYPE
The standard component type for this component. |
static java.lang.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, VALIDATE_EMPTY_FIELDS_PARAM_NAME |
| Fields inherited from class javax.faces.component.UIComponent |
|---|
BEANINFO_KEY, bindings, COMPOSITE_COMPONENT_TYPE_KEY, COMPOSITE_FACET_NAME, CURRENT_COMPONENT, CURRENT_COMPOSITE_COMPONENT, FACETS_KEY, VIEW_LOCATION_KEY |
| Constructor Summary | |
|---|---|
UISelectOne()
Create a new UISelectOne instance with default property
values. |
|
| Method Summary | |
|---|---|
java.lang.String |
getFamily()
Return the identifier of the component family to which this component belongs. |
protected void |
validateValue(FacesContext context,
java.lang.Object value)
In addition to the standard validation behavior inherited from UIInput,
ensure that any specified value is equal to one of the available
options. |
| Methods inherited from class javax.faces.component.UIOutput |
|---|
getConverter, getLocalValue, getValue, 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, getValue, setConverter |
| Field Detail |
|---|
public static final java.lang.String COMPONENT_TYPE
The standard component type for this component.
public static final java.lang.String COMPONENT_FAMILY
The standard component family for this component.
public static final java.lang.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 UISelectOne()
Create a new UISelectOne instance with default property
values.
| Method Detail |
|---|
public java.lang.String getFamily()
UIComponentReturn 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.
getFamily in class UIInput
protected void validateValue(FacesContext context,
java.lang.Object value)
In addition to the
standard validation behavior inherited from UIInput,
ensure that any specified value is 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.
If UIInput.isRequired() returns
true, and the current value is equal to the value of
an inner UISelectItem whose UISelectItem#isNoSelectionOption method returns
true, enqueue an error message and set the
valid property to false.
validateValue in class UIInputcontext - The FacesContext for the current requestvalue - The converted value to test for membership.
java.lang.NullPointerException - if context
is null
|
DRAFT | ||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
Copyright © 2009 Sun Microsystems, Inc. All Rights Reserved. Use is subject to license terms.
Generated on 24-November-2009 03:24