JavaEE API 8.0.1 · javax.faces.component.ComponentStateHelper

Modifier and Type	Field and Description
private UIComponent	component
private Map<Serializable, Object>	defaultMap
private Map<Serializable, Object>	deltaMap
private boolean	isTransient
private Map<Object, Object>	transientState

Access	Constructor and Description
public	ComponentStateHelper(UIComponent component)

Method Summary

Modifier and Type	Method and Description
public void	add(Serializable the key for which the value should be returned. key, Object the value to add value) Implements javax.faces.component.StateHelper.add. Store the specified `value` in a `List` that is internal to the `StateHelper`.
public Object	eval(Serializable the name of the value in the internal map, or the name of a value expression in the components value expression collection. key) Implements javax.faces.component.StateHelper.eval. Attempts to find a value associated with the specified key, using the value expression collection from the component if no such value is found.
public Object	eval(Serializable the key for which the value should be returned. key, Object the value to return if no value is found in the call to `eval()`. defaultValue) Implements javax.faces.component.StateHelper.eval. Performs the same logic as `eval(java.io.Serializable)` } but if no value is found, this will return the specified `defaultValue`
public Object	get(Serializable key) Implements javax.faces.component.StateHelper.get. Get the object from the main-map.
public Object	getTransient(Object the key for which the value should be returned. key) Implements javax.faces.component.TransientStateHelper.getTransient. Return the value currently associated with the specified `key` if any.
public Object	getTransient(Object the key for which the value should be returned. key, Object the value to return if no value is found in the call to `get()`. defaultValue) Implements javax.faces.component.TransientStateHelper.getTransient. Performs the same logic as `getTransient` } but if no value is found, this will return the specified `defaultValue`
private void	handleAttribute(String name, Object value)
public boolean	isTransient() Implements javax.faces.component.StateHolder.isTransient. If true, the Object implementing this interface must not participate in state saving or restoring.
public Object	Returns: the original value in the delta-map, if not present, the old value in the main map put(Serializable key, Object value) Implements javax.faces.component.StateHelper.put. Put the object in the main-map and/or the delta-map, if necessary.
public Object	put(Serializable the key of the map itself key, String the key within the internal map mapKey, Object the value for the key in the internal map value) Implements javax.faces.component.StateHelper.put. Store the specified `mapKey`/`value` in a `Map` that is internal to the helper, and return the previously stored value.
public Object	putTransient(Object the key for the value key, Object the value value) Implements javax.faces.component.TransientStateHelper.putTransient. Return the previously stored value and store the specified key/value pair.
public Object	Returns: the removed object in the delta-map. if not present, the removed object from the main map remove(Serializable key) Implements javax.faces.component.StateHelper.remove. We need to remove from both maps, if we do remove an existing key.
public Object	remove(Serializable the key of in the inner data structure whose value is a `Collection` or `Map` key, Object the value or key to be removed. valueOrKey) Implements javax.faces.component.StateHelper.remove. Remove a value from the inner data structure.
private Object	removeFromList(Serializable key, Object value)
private Object	removeFromMap(Serializable key, String mapKey)
public void	restoreState(FacesContext FacesContext context, Object the state to be restored. state) Implements javax.faces.component.StateHolder.restoreState. One and only implementation of restore state.
public void	restoreTransientState(FacesContext the Faces context context, Object the object containing transient values state) Implements javax.faces.component.TransientStateHolder.restoreTransientState. Restore the "transient state" using the object passed as state.
private Object	saveMap(FacesContext context, Map<Serializable, Object> map)
public Object	Returns: the saved state saveState(FacesContext context) Implements javax.faces.component.StateHolder.saveState. One and only implementation of save-state - makes all other implementations unnecessary.
public Object	saveTransientState(FacesContext the Faces context. context) Implements javax.faces.component.TransientStateHolder.saveTransientState. Return the object containing related "transient states".
public void	setTransient(boolean boolean pass `true` if this Object will not participate in state saving or restoring, otherwise pass `false`. newTransientValue) Implements javax.faces.component.StateHolder.setTransient. Denotes whether or not the Object implementing this interface must or must not participate in state saving or restoring.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

component	back to summary
private UIComponent component

defaultMap	back to summary
private Map<Serializable, Object> defaultMap

deltaMap	back to summary
private Map<Serializable, Object> deltaMap

isTransient	back to summary
private boolean isTransient

transientState	back to summary
private Map<Object, Object> transientState

ComponentStateHelper	back to summary
public ComponentStateHelper(UIComponent component)

Method Detail

add back to summary

add	back to summary
public void add(Serializable key, Object value) Implements javax.faces.component.StateHelper.add. Doc from javax.faces.component.StateHelper.add. Store the specified `value` in a `List` that is internal to the `StateHelper`. It's important to note for delta tracking that any modifications to the internal `List` be made through this method or `StateHelper#remove(java.io.Serializable, Object)`. Parameters key:Serializable the key for which the value should be returned. value:Object the value to add Annotations @Override See Also `StateHelper#add(java.io.Serializable, Object)`

public void add(Serializable key, Object value)

Implements javax.faces.component.StateHelper.add.

Doc from javax.faces.component.StateHelper.add.

Store the specified value in a List that is internal to the StateHelper.

It's important to note for delta tracking that any modifications to the internal List be made through this method or StateHelper#remove(java.io.Serializable, Object).

Parameters

key:Serializable: the key for which the value should be returned.
value:Object: the value to add

Annotations

@Override

eval back to summary

eval	back to summary
public Object eval(Serializable key) Implements javax.faces.component.StateHelper.eval. Doc from javax.faces.component.StateHelper.eval. Attempts to find a value associated with the specified key, using the value expression collection from the component if no such value is found. Parameters key:Serializable the name of the value in the internal map, or the name of a value expression in the components value expression collection. Returns:Object the evaluated value. Annotations @Override See Also `StateHelper#eval(java.io.Serializable)`

public Object eval(Serializable key)

Implements javax.faces.component.StateHelper.eval.

Doc from javax.faces.component.StateHelper.eval.

Attempts to find a value associated with the specified key, using the value expression collection from the component if no such value is found.

Parameters

key:Serializable: the name of the value in the internal map, or the name of a value expression in the components value expression collection.

Returns:Object

the evaluated value.

Annotations

@Override

eval back to summary

eval	back to summary
public Object eval(Serializable key, Object defaultValue) Implements javax.faces.component.StateHelper.eval. Doc from javax.faces.component.StateHelper.eval. Performs the same logic as `eval(java.io.Serializable)` } but if no value is found, this will return the specified `defaultValue` Parameters key:Serializable the key for which the value should be returned. defaultValue:Object the value to return if no value is found in the call to `eval()`. Returns:Object the evaluated value. Annotations @Override See Also `StateHelper#eval(java.io.Serializable, Object)`

public Object eval(Serializable key, Object defaultValue)

Implements javax.faces.component.StateHelper.eval.

Doc from javax.faces.component.StateHelper.eval.

Performs the same logic as eval(java.io.Serializable) } but if no value is found, this will return the specified defaultValue

Parameters

key:Serializable: the key for which the value should be returned.
defaultValue:Object: the value to return if no value is found in the call to eval().

Returns:Object

the evaluated value.

Annotations

@Override

get	back to summary
public Object get(Serializable key) Implements javax.faces.component.StateHelper.get. Get the object from the main-map. As everything is written through from the delta-map to the main-map, this should be enough. Annotations @Override

get

back to summary

public Object get(Serializable key)

Implements javax.faces.component.StateHelper.get.

Get the object from the main-map. As everything is written through from the delta-map to the main-map, this should be enough.

Annotations

@Override

getTransient back to summary

getTransient	back to summary
public Object getTransient(Object key) Implements javax.faces.component.TransientStateHelper.getTransient. Doc from javax.faces.component.TransientStateHelper.getTransient. Return the value currently associated with the specified `key` if any. Parameters key:Object the key for which the value should be returned. Returns:Object the stored value. Annotations @Override

public Object getTransient(Object key)

Implements javax.faces.component.TransientStateHelper.getTransient.

Doc from javax.faces.component.TransientStateHelper.getTransient.

Return the value currently associated with the specified key if any.

Parameters

key:Object: the key for which the value should be returned.

Returns:Object

the stored value.

Annotations

@Override

getTransient back to summary

getTransient	back to summary
public Object getTransient(Object key, Object defaultValue) Implements javax.faces.component.TransientStateHelper.getTransient. Doc from javax.faces.component.TransientStateHelper.getTransient. Performs the same logic as `getTransient` } but if no value is found, this will return the specified `defaultValue` Parameters key:Object the key for which the value should be returned. defaultValue:Object the value to return if no value is found in the call to `get()`. Returns:Object the stored value. Annotations @Override

public Object getTransient(Object key, Object defaultValue)

Implements javax.faces.component.TransientStateHelper.getTransient.

Doc from javax.faces.component.TransientStateHelper.getTransient.

Performs the same logic as getTransient } but if no value is found, this will return the specified defaultValue

Parameters

key:Object: the key for which the value should be returned.
defaultValue:Object: the value to return if no value is found in the call to get().

Returns:Object

the stored value.

Annotations

@Override

handleAttribute	back to summary
private void handleAttribute(String name, Object value)

isTransient back to summary

isTransient	back to summary
public boolean isTransient() Implements javax.faces.component.StateHolder.isTransient. Doc from javax.faces.component.StateHolder.isTransient. If true, the Object implementing this interface must not participate in state saving or restoring. Returns:boolean `true` if transient, `false` otherwise. Annotations @Override See Also `javax.faces.component.StateHolder#isTransient()`

public boolean isTransient()

Implements javax.faces.component.StateHolder.isTransient.

Doc from javax.faces.component.StateHolder.isTransient.

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

Returns:boolean

true if transient, false otherwise.

Annotations

@Override

put	back to summary
public Object put(Serializable key, Object value) Implements javax.faces.component.StateHelper.put. Put the object in the main-map and/or the delta-map, if necessary. Returns:Object the original value in the delta-map, if not present, the old value in the main map Annotations @Override

put

back to summary

public Object put(Serializable key, Object value)

Implements javax.faces.component.StateHelper.put.

Put the object in the main-map and/or the delta-map, if necessary.

Returns:Object

the original value in the delta-map, if not present, the old value in the main map

Annotations

@Override

put back to summary

put	back to summary
public Object put(Serializable key, String mapKey, Object value) Implements javax.faces.component.StateHelper.put. Doc from javax.faces.component.StateHelper.put. Store the specified `mapKey`/`value` in a `Map` that is internal to the helper, and return the previously stored value. The `Map` will then be associated with `key`. It's important to note for delta tracking that any modifications to the internal `Map` be made through this method or `StateHelper#remove(java.io.Serializable, Object)`. Parameters key:Serializable the key of the map itself mapKey:String the key within the internal map value:Object the value for the key in the internal map Returns:Object the value. Annotations @Override See Also `StateHelper#put(java.io.Serializable, String, Object)`

public Object put(Serializable key, String mapKey, Object value)

Implements javax.faces.component.StateHelper.put.

Doc from javax.faces.component.StateHelper.put.

Store the specified mapKey/value in a Map that is internal to the helper, and return the previously stored value. The Map will then be associated with key.

It's important to note for delta tracking that any modifications to the internal Map be made through this method or StateHelper#remove(java.io.Serializable, Object).

Parameters

key:Serializable: the key of the map itself
mapKey:String: the key within the internal map
value:Object: the value for the key in the internal map

Returns:Object

the value.

Annotations

@Override

putTransient	back to summary
public Object putTransient(Object key, Object value) Implements javax.faces.component.TransientStateHelper.putTransient. Doc from javax.faces.component.TransientStateHelper.putTransient. Return the previously stored value and store the specified key/value pair. This is intended to store data that would otherwise reside in an instance variable on the component. Parameters key:Object the key for the value value:Object the value Returns:Object the previously stored value Annotations @Override

putTransient

back to summary

public Object putTransient(Object key, Object value)

Implements javax.faces.component.TransientStateHelper.putTransient.

Doc from javax.faces.component.TransientStateHelper.putTransient.

Return the previously stored value and store the specified key/value pair. This is intended to store data that would otherwise reside in an instance variable on the component.

Parameters

key:Object: the key for the value
value:Object: the value

Returns:Object

the previously stored value

Annotations

@Override

remove	back to summary
public Object remove(Serializable key) Implements javax.faces.component.StateHelper.remove. We need to remove from both maps, if we do remove an existing key. Returns:Object the removed object in the delta-map. if not present, the removed object from the main map Annotations @Override

remove

back to summary

public Object remove(Serializable key)

Implements javax.faces.component.StateHelper.remove.

We need to remove from both maps, if we do remove an existing key.

Returns:Object

the removed object in the delta-map. if not present, the removed object from the main map

Annotations

@Override

remove back to summary

remove	back to summary
public Object remove(Serializable key, Object valueOrKey) Implements javax.faces.component.StateHelper.remove. Doc from javax.faces.component.StateHelper.remove. Remove a value from the inner data structure. Look in the inner data structure for the value at the given `key`. If the value is a `Map`, remove and return the value under the key given by the `valueOrKey` argument. If the value is a `Collection`, simply remove the value given by the argument `valueOrKey` and return null. Parameters key:Serializable the key of in the inner data structure whose value is a `Collection` or `Map` valueOrKey:Object the value or key to be removed. Returns:Object the removed value. Annotations @Override See Also `StateHelper#remove(java.io.Serializable, Object)`

public Object remove(Serializable key, Object valueOrKey)

Implements javax.faces.component.StateHelper.remove.

Doc from javax.faces.component.StateHelper.remove.

Remove a value from the inner data structure. Look in the inner data structure for the value at the given key. If the value is a Map, remove and return the value under the key given by the valueOrKey argument. If the value is a Collection, simply remove the value given by the argument valueOrKey and return null.

Parameters

key:Serializable: the key of in the inner data structure whose value is a Collection or Map
valueOrKey:Object: the value or key to be removed.

Returns:Object

the removed value.

Annotations

@Override

removeFromList	back to summary
private Object removeFromList(Serializable key, Object value)

removeFromMap	back to summary
private Object removeFromMap(Serializable key, String mapKey)

restoreState	back to summary
public void restoreState(FacesContext context, Object state) Implements javax.faces.component.StateHolder.restoreState. One and only implementation of restore state. Makes all other implementations unnecessary. Parameters context:FacesContext FacesContext state:Object the state to be restored. Annotations @Override

restoreState

back to summary

public void restoreState(FacesContext context, Object state)

Implements javax.faces.component.StateHolder.restoreState.

One and only implementation of restore state. Makes all other implementations unnecessary.

Parameters

context:FacesContext: FacesContext
state:Object: the state to be restored.

Annotations

@Override

restoreTransientState back to summary

restoreTransientState	back to summary
public void restoreTransientState(FacesContext context, Object state) Implements javax.faces.component.TransientStateHolder.restoreTransientState. Doc from javax.faces.component.TransientStateHolder.restoreTransientState. Restore the "transient state" using the object passed as state. If the `state` argument is `null` clear any previous transient state if any and return. Parameters context:FacesContext the Faces context state:Object the object containing transient values Annotations @SuppressWarnings:unchecked @Override

public void restoreTransientState(FacesContext context, Object state)

Implements javax.faces.component.TransientStateHolder.restoreTransientState.

Doc from javax.faces.component.TransientStateHolder.restoreTransientState.

Restore the "transient state" using the object passed as state.

If the state argument is null clear any previous transient state if any and return.

Parameters

context:FacesContext: the Faces context
state:Object: the object containing transient values

Annotations

@SuppressWarnings:unchecked
@Override

saveMap	back to summary
private Object saveMap(FacesContext context, Map<Serializable, Object> map)

saveState	back to summary
public Object saveState(FacesContext context) Implements javax.faces.component.StateHolder.saveState. One and only implementation of save-state - makes all other implementations unnecessary. Returns:Object the saved state Annotations @Override

saveState

back to summary

public Object saveState(FacesContext context)

Implements javax.faces.component.StateHolder.saveState.

One and only implementation of save-state - makes all other implementations unnecessary.

Returns:Object

the saved state

Annotations

@Override

saveTransientState	back to summary
public Object saveTransientState(FacesContext context) Implements javax.faces.component.TransientStateHolder.saveTransientState. Doc from javax.faces.component.TransientStateHolder.saveTransientState. Return the object containing related "transient states". that could be used later to restore the "transient state". Parameters context:FacesContext the Faces context. Returns:Object object containing transient values Annotations @Override

saveTransientState

back to summary

public Object saveTransientState(FacesContext context)

Implements javax.faces.component.TransientStateHolder.saveTransientState.

Doc from javax.faces.component.TransientStateHolder.saveTransientState.

Return the object containing related "transient states". that could be used later to restore the "transient state".

Parameters

context:FacesContext: the Faces context.

Returns:Object

object containing transient values

Annotations

@Override

setTransient back to summary

setTransient	back to summary
public void setTransient(boolean newTransientValue) Implements javax.faces.component.StateHolder.setTransient. Doc from javax.faces.component.StateHolder.setTransient. Denotes whether or not the Object implementing this interface must or must not participate in state saving or restoring. Parameters newTransientValue:boolean boolean pass `true` if this Object will not participate in state saving or restoring, otherwise pass `false`. Annotations @Override See Also `StateHolder#setTransient(boolean)`

public void setTransient(boolean newTransientValue)

Implements javax.faces.component.StateHolder.setTransient.

Doc from javax.faces.component.StateHolder.setTransient.

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

Parameters

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

Annotations

@Override

See Also

StateHolder#setTransient(boolean)

pack-priv Class ComponentStateHelper

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail