|
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
public class UIOutput
UIOutput is a UIComponent that has a
value, optionally retrieved from a model tier bean via a value
expression, that is displayed to the user. The user cannot directly
modify the rendered value; it is for display purposes only.
During the Render Response phase of the request processing lifecycle, the current value of this component must be converted to a String (if it is not already), according to the following rules:
null, and is not already
a String, locate a Converter (if any) to use
for the conversion, as follows:
getConverter() returns a non-null Converter,
use that one, otherwiseApplication.createConverter(Class), passing the
current value's class, returns a non-null Converter,
use that one.null and a Converter
was located, call its getAsString() method to perform
the conversion.null but no Converter
was located, call toString() on the current value to perform
the conversion.By default, the rendererType property must be set to
"javax.faces.Text". 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. |
| 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 | |
|---|---|
UIOutput()
Create a new UIOutput instance with default property
values. |
|
| Method Summary | |
|---|---|
void |
clearInitialState()
For each of the attached objects on
this instance that implement |
Converter |
getConverter()
Return the Converter (if any)
that is registered for this UIComponent. |
java.lang.String |
getFamily()
Return the identifier of the component family to which this component belongs. |
java.lang.Object |
getLocalValue()
Return the local value of this UIComponent (if any),
without evaluating any associated ValueExpression. |
java.lang.Object |
getValue()
Gets the value of this UIComponent. |
void |
markInitialState()
In addition to the actions taken in UIComponentBase
when PartialStateHolder#markInitialState() is called,
check if the installed Converter is a PartialStateHolder and
if it is, call PartialStateHolder.markInitialState()
on it. |
void |
restoreState(FacesContext context,
java.lang.Object state)
Perform any processing required to restore the state from the entries in the state Object. |
java.lang.Object |
saveState(FacesContext context)
Gets the state of the instance as a Serializable Object. |
void |
setConverter(Converter converter)
Set the Converter (if any) that is registered for this
UIComponent. |
void |
setValue(java.lang.Object value)
Set the value of this UIComponent (if any). |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| 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.
| Constructor Detail |
|---|
public UIOutput()
Create a new UIOutput 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 UIComponentpublic Converter getConverter()
ValueHolderReturn the Converter (if any)
that is registered for this UIComponent.
getConverter in interface ValueHolderpublic void setConverter(Converter converter)
ValueHolderSet the Converter (if any) that is registered for this
UIComponent.
setConverter in interface ValueHolderconverter - New Converter (or null)public java.lang.Object getLocalValue()
ValueHolderReturn the local value of this UIComponent (if any),
without evaluating any associated ValueExpression.
getLocalValue in interface ValueHolderpublic java.lang.Object getValue()
ValueHolderGets the value of this UIComponent. If validation
failed, as indicated by FacesContext#isValidationFailed
returning true, always return the local value.
Otherwise, first, consult the local value property of this
component. If non-null return it. If
null, see if we have a ValueExpression for
the value property. If so, return the result of
evaluating the property, otherwise return null.
Note that because the specification for UIComponent#setValueBinding requires a call through to UIComponent#setValueExpression, legacy tags will continue to
work.
getValue in interface ValueHolderpublic void setValue(java.lang.Object value)
ValueHolderSet the value of this UIComponent (if any).
setValue in interface ValueHoldervalue - The new local valuepublic void markInitialState()
In addition to the actions taken in UIComponentBase
when PartialStateHolder#markInitialState() is called,
check if the installed Converter is a PartialStateHolder and
if it is, call PartialStateHolder.markInitialState()
on it.
markInitialState in interface PartialStateHoldermarkInitialState in class UIComponentBasepublic void clearInitialState()
UIComponentBaseFor each of the attached objects on
this instance that implement PartialStateHolder, call
PartialStateHolder#clearInitialState on the attached object.
clearInitialState in interface PartialStateHolderclearInitialState in class UIComponentBasepublic java.lang.Object saveState(FacesContext context)
StateHolder Gets the state of the instance as a
Serializable Object.
If the class that implements this interface has references to
instances that implement StateHolder (such as a
UIComponent with event handlers, validators, etc.)
this method must call the StateHolder.saveState(javax.faces.context.FacesContext) method on all those
instances as well. This method must not save the state
of children and facets. That is done via the StateManager
This method must not alter the state of the implementing object. In other words, after executing this code:
Object state = component.saveState(facesContext);
component should be the same as before executing
it.
The return from this method must be Serializable
saveState in interface StateHoldersaveState in class UIComponentBase
public void restoreState(FacesContext context,
java.lang.Object state)
StateHolderPerform any processing required to restore the state from the entries in the state Object.
If the class that implements this interface has references to
instances that also implement StateHolder (such as a
UIComponent with event handlers, validators, etc.)
this method must call the StateHolder.restoreState(javax.faces.context.FacesContext, java.lang.Object) method on all those
instances as well.
restoreState in interface StateHolderrestoreState in class UIComponentBase
|
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