com.sun.faces.application

Class ValueBindingValueExpressionAdapter

java.lang.Object

javax.faces.el.ValueBinding

com.sun.faces.application.ValueBindingValueExpressionAdapter

All Implemented Interfaces:

Serializable, StateHolder

public class ValueBindingValueExpressionAdapter
extends ValueBinding
implements StateHolder, Serializable

Wrap a ValueExpression instance and expose it as a ValueBinding

Author:

Jacob Hookom

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ValueBindingValueExpressionAdapter()
ValueBindingValueExpressionAdapter(javax.el.ValueExpression valueExpression)

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object other)
String	getExpressionString() Return the (possibly null) expression String, including the delimiters, from which this ValueBinding was built.
Class	getType(FacesContext context) Return the type of the property represented by this ValueBinding, relative to the specified FacesContext.
Object	getValue(FacesContext context) Return the value of the property represented by this ValueBinding, relative to the specified FacesContext.
javax.el.ValueExpression	getWrapped()
int	hashCode()
boolean	isReadOnly(FacesContext context) Return true if the specified property of the specified property is known to be immutable; otherwise, return false.
boolean	isTransient() If true, the Object implementing this interface must not participate in state saving or restoring.
void	restoreState(FacesContext context, Object state) Perform any processing required to restore the state from the entries in the state Object.
Object	saveState(FacesContext context) Gets the state of the instance as a Serializable Object.
void	setTransient(boolean tranzient) Denotes whether or not the Object implementing this interface must or must not participate in state saving or restoring.
void	setValue(FacesContext context, Object value) Set the value of the property represented by this ValueBinding, relative to the specified FacesContext.

Methods inherited from class java.lang.Object

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

Constructor Detail

ValueBindingValueExpressionAdapter

public ValueBindingValueExpressionAdapter()

ValueBindingValueExpressionAdapter

public ValueBindingValueExpressionAdapter(javax.el.ValueExpression valueExpression)

Method Detail

getExpressionString

public String getExpressionString()

Description copied from class: ValueBinding

Return the (possibly null) expression String, including the delimiters, from which this ValueBinding was built.

Overrides:

getExpressionString in class ValueBinding

Returns:

the expression string

getType

public Class getType(FacesContext context)
              throws EvaluationException,
                     PropertyNotFoundException

Description copied from class: ValueBinding

Return the type of the property represented by this ValueBinding, relative to the specified FacesContext.

Specified by:

getType in class ValueBinding

Parameters:

context - FacesContext for the current request

Returns:

the Java type of this expression

Throws:

EvaluationException - if an exception is thrown while getting the description of the property (the thrown exception must be included as the cause property of this exception)

PropertyNotFoundException - if a specified property name does not exist

getValue

public Object getValue(FacesContext context)
                throws EvaluationException,
                       PropertyNotFoundException

Description copied from class: ValueBinding

Return the value of the property represented by this ValueBinding, relative to the specified FacesContext.

Specified by:

getValue in class ValueBinding

Parameters:

context - FacesContext for the current request

Returns:

the value of this expression

Throws:

EvaluationException - if an exception is thrown while getting the value (the thrown exception must be included as the cause property of this exception)

PropertyNotFoundException - if a specified property name does not exist, or is not readable

isReadOnly

public boolean isReadOnly(FacesContext context)
                   throws EvaluationException,
                          PropertyNotFoundException

Description copied from class: ValueBinding

Return true if the specified property of the specified property is known to be immutable; otherwise, return false.

Specified by:

isReadOnly in class ValueBinding

Parameters:

context - FacesContext for the current request

Returns:

whether or not this expression is read only

Throws:

EvaluationException - if an exception is thrown while getting the description of the property (the thrown exception must be included as the cause property of this exception)

PropertyNotFoundException - if a specified property name does not exist

setValue

public void setValue(FacesContext context,
                     Object value)
              throws EvaluationException,
                     PropertyNotFoundException

Description copied from class: ValueBinding

Set the value of the property represented by this ValueBinding, relative to the specified FacesContext.

Specified by:

setValue in class ValueBinding

Parameters:

context - FacesContext for the current request

value - The new value to be set

Throws:

EvaluationException - if an exception is thrown while setting the value (the thrown exception must be included as the cause property of this exception)

PropertyNotFoundException - if a specified property name does not exist, or is not writeable

isTransient

public boolean isTransient()

Description copied from interface: StateHolder

If true, the Object implementing this interface must not participate in state saving or restoring.

Specified by:

isTransient in interface StateHolder

Returns:

true if transient, false otherwise.

setTransient

public void setTransient(boolean tranzient)

Description copied from interface: StateHolder

Denotes whether or not the Object implementing this interface must or must not participate in state saving or restoring.

Specified by:

setTransient in interface StateHolder

Parameters:

tranzient - boolean pass true if this Object will not participate in state saving or restoring, otherwise pass false.

saveState

public Object saveState(FacesContext context)

Description copied from interface: 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

Specified by:

saveState in interface StateHolder

Parameters:

context - the Faces context.

Returns:

the saved state.

restoreState

public void restoreState(FacesContext context,
                         Object state)

Description copied from interface: StateHolder

Perform 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.

If the state argument is null, take no action and return.

Specified by:

restoreState in interface StateHolder

Parameters:

context - the Faces context.

state - the state.

equals

public boolean equals(Object other)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

getWrapped

public javax.el.ValueExpression getWrapped()