javax.faces.component
Class UIOutput

java.lang.Object
  javax.faces.component.UIComponentBase
      javax.faces.component.UIOutput

All Implemented Interfaces:

java.io.Serializable, UIComponent

Direct Known Subclasses:

UIGraphic, UIInput, UIPanel, UIParameter, UISelectItem, UISelectItems

public class UIOutput

extends UIComponentBase

UIOutput is a UIComponent that displays output to the user. The user cannot manipulate this component; it is for display purposes only. There are no restrictions on the data type of the local value, or the object referenced by the value reference expression (if any); however, individual Renderers will generally impose restrictions on the type of data they know how to display.

By default, the rendererType property is set to "Text". This value can be changed by calling the setRendererType() method.

See Also:

Serialized Form

Field Summary

Fields inherited from interface javax.faces.component.UIComponent

SEPARATOR_CHAR

Constructor Summary

UIOutput()
Create a new UIOutput instance with default property values.

Method Summary

java.lang.Object	currentValue(FacesContext context) Evaluate and return the current value of this component, according to the following algorithm.
java.lang.Object	getValue() Return the local value of this UIInput component.
java.lang.String	getValueRef() Return the value reference expression for this UIInput component, pointing at the model tier property that will be updated or rendered.
void	setValue(java.lang.Object value) Set the local value of this UIInput component.
void	setValueRef(java.lang.String valueRef) Set the value reference expression for this UIInput component, pointing at the model tier property that will be updated or rendered.

Methods inherited from class javax.faces.component.UIComponentBase

addChild, addChild, addFacet, addValidator, broadcast, clearChildren, clearFacets, clearValidators, containsChild, decode, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttribute, getAttributeNames, getChild, getChildCount, getChildren, getClientId, getComponentId, getConverter, getFacet, getFacetNames, getFacetsAndChildren, getParent, getRendererType, getRendersChildren, getRendersSelf, getValidators, isRendered, isValid, processDecodes, processReconstitutes, processUpdates, processValidators, reconstitute, removeChild, removeChild, removeFacet, removeValidator, setAttribute, setComponentId, setConverter, setParent, setRendered, setRendererType, setValid, updateModel, validate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

UIOutput

public UIOutput()

Create a new UIOutput instance with default property values.

Method Detail

getValue

public java.lang.Object getValue()

Return the local value of this UIInput component.

setValue

public void setValue(java.lang.Object value)

Set the local value of this UIInput component.

Parameters:

value - The new local value

getValueRef

public java.lang.String getValueRef()

Return the value reference expression for this UIInput component, pointing at the model tier property that will be updated or rendered.

setValueRef

public void setValueRef(java.lang.String valueRef)

Set the value reference expression for this UIInput component, pointing at the model tier property that will be updated or rendered.

Parameters:

valueRef - The new value reference expression

currentValue

public java.lang.Object currentValue(FacesContext context)

Evaluate and return the current value of this component, according to the following algorithm.

• If the value property has been set (containing the local value for this component), return that; else
• If the valueRef property has been set,
  • Retrieve the Application instance for this web application from ApplicationFactory.
  • Ask it for a ValueBinding for the valueRef expression.
  • Use the getValue() method of the ValueBinding to retrieve the value that the value reference expression points at.
• Otherwise, return null.

Parameters:

context - FacesContext within which to evaluate the value reference expression, if necessary

Throws:

EvaluationException - if a problem occurs evaluating the value reference expression

java.lang.NullPointerException - if context is null