org.apache.myfaces.view.facelets.tag.jsf

Class FaceletState

java.lang.Object

org.apache.myfaces.view.facelets.tag.jsf.FaceletState

All Implemented Interfaces:

Serializable, StateHolder

public class FaceletState
extends Object
implements StateHolder, Serializable

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
FaceletState()

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(Object obj)
javax.el.ValueExpression	getBinding(String uniqueId, String key) A "Facelet Binding ValueExpression" is a ValueExpression used/generated by facelets algorithm associated with an uniqueId, which usually is bound to the tagId.
Map<String,Map<String,javax.el.ValueExpression>>	getBindings()
Object	getState(String key)
int	hashCode()
boolean	isDynamic()
boolean	isTransient()
void	putBinding(String uniqueId, String key, javax.el.ValueExpression expr)
Object	putState(String key, Object value)
void	restoreState(FacesContext context, Object state)
Object	saveState(FacesContext context)
void	setTransient(boolean newTransientValue)

Methods inherited from class java.lang.Object

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

Constructor Detail

FaceletState

public FaceletState()

Method Detail

getState

public Object getState(String key)

putState

public Object putState(String key,
              Object value)

saveState

public Object saveState(FacesContext context)

Specified by:

saveState in interface StateHolder

restoreState

public void restoreState(FacesContext context,
                Object state)

Specified by:

restoreState in interface StateHolder

isTransient

public boolean isTransient()

Specified by:

isTransient in interface StateHolder

setTransient

public void setTransient(boolean newTransientValue)

Specified by:

setTransient in interface StateHolder

isDynamic

public boolean isDynamic()

putBinding

public void putBinding(String uniqueId,
              String key,
              javax.el.ValueExpression expr)

getBinding

public javax.el.ValueExpression getBinding(String uniqueId,
                                  String key)

A "Facelet Binding ValueExpression" is a ValueExpression used/generated by facelets algorithm associated with an uniqueId, which usually is bound to the tagId. Components like c:forEach or ui:param uses it and the reason behind this is avoid use VariableMapper to create EL Expressions that later cannot be cached. Instead, the intention is make an indirection using 2 ValueExpression instances. In that way, all EL Expressions can be cached, because VariableMapper will use an instance that contains the uniqueId and the one stored in the map will have the real value or EL Expression that points to the managed bean. (Remember each EL expression that uses a variable stored in VariableMapper will copy the EL expression bound to the variable, so if the EL expression value changes across views, all EL Expressions that contains a reference cannot be cached). This map is something special, because its content is related to the view structure. It does not need to be saved fully into the state, and it does not have any delta state, but it "evolves" with the initial state.

getBindings

public Map<String,Map<String,javax.el.ValueExpression>> getBindings()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object