Class AjaxBehavior
- java.lang.Object
-
- jakarta.faces.component.behavior.BehaviorBase
-
- jakarta.faces.component.behavior.ClientBehaviorBase
-
- jakarta.faces.component.behavior.AjaxBehavior
-
- All Implemented Interfaces:
Behavior,ClientBehavior,PartialStateHolder,StateHolder
public class AjaxBehavior extends ClientBehaviorBase
An instance of this class is added as a
ClientBehaviorto a component using theClientBehaviorHolder.addClientBehavior(java.lang.String, jakarta.faces.component.behavior.ClientBehavior)contract that components implement. The presence of thisClientBehaviorwill cause the rendering of JavaScript that produces anAjaxrequest using the specification public JavaScript API when the component is rendered.If the component is an instance of
EditableValueHolder, Where at all possible, the component must have the UI register the ajax event when the initial value is changed, not when focus is lost on the component.- Since:
- 2.0
-
-
Field Summary
Fields Modifier and Type Field Description static StringBEHAVIOR_IDThe standard id for this behavior.
-
Constructor Summary
Constructors Constructor Description AjaxBehavior()Default constructor that just creates this instance.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidaddAjaxBehaviorListener(AjaxBehaviorListener listener)Add the specifiedAjaxBehaviorListenerto the set of listeners registered to receive event notifications from thisAjaxBehavior.StringgetDelay()Returns the delay value, ornullif no value was set.Collection<String>getExecute()Return a non-emptyCollection<String>of component identifiers that will be used to identify components that should be processed during theexecutephase of the request processing lifecycle.Set<ClientBehaviorHint>getHints()StringgetOnerror()Return theStringof JavaScript function name that will be used to identify the client callback function that should be run in the event of an error.StringgetOnevent()Return theStringof JavaScript function name that will be used to identify the client callback function that should be run on the occurance of a client-side event.Collection<String>getRender()Return a non-emptyCollection<String>of component identifiers that will be used to identify components that should be processed during therenderphase of the request processing lifecycle.StringgetRendererType()Returns the renderer type of theClientBehaviorRendererto use for the behavior.ValueExpressiongetValueExpression(String name)Returns theValueExpressionused to calculate the value for the specified property name, if any.booleanisDisabled()Return the disabled status of this behavior.booleanisImmediate()Return the immediate status of this behavior.booleanisImmediateSet()Tests whether the immediate attribute is specified.booleanisResetValues()Return the resetValues status of this behavior.booleanisResetValuesSet()Tests whether the resetValues attribute is specified.voidremoveAjaxBehaviorListener(AjaxBehaviorListener listener)Remove the specifiedAjaxBehaviorListenerfrom the set of listeners registered to receive event notifications from thisAjaxBehavior.voidrestoreState(FacesContext context, Object state)ObjectsaveState(FacesContext context)Implementation ofStateHolder.saveState(jakarta.faces.context.FacesContext).voidsetDelay(String delay)If less than delay milliseconds elapses between calls to request() only the most recent one is sent and all other requests are discarded.voidsetDisabled(boolean disabled)Sets the disabled status of this behavior.voidsetExecute(Collection<String> execute)Sets the component identifiers that will be used to identify components that should be processed during theexecutephase of the request processing lifecycle.voidsetImmediate(boolean immediate)Sets the immediate status of this behavior.voidsetOnerror(String onerror)Sets the JavaScript function name that will be used to identify the client callback function that should be run in the event of an error.voidsetOnevent(String onevent)Sets the JavaScript function name that will be used to identify the client callback function that should be run in response to event activity.voidsetRender(Collection<String> render)Sets the component identifiers that will be used to identify components that should be processed during therenderphase of the request processing lifecycle.voidsetResetValues(boolean resetValues)Set the resetValues status of this behavior.voidsetValueExpression(String name, ValueExpression binding)Sets theValueExpressionused to calculate the value for the specified property name.-
Methods inherited from class jakarta.faces.component.behavior.ClientBehaviorBase
decode, getRenderer, getScript
-
Methods inherited from class jakarta.faces.component.behavior.BehaviorBase
addBehaviorListener, broadcast, clearInitialState, initialStateMarked, isTransient, markInitialState, removeBehaviorListener, setTransient
-
-
-
-
Field Detail
-
BEHAVIOR_ID
public static final String BEHAVIOR_ID
The standard id for this behavior.
- See Also:
- Constant Field Values
-
-
Method Detail
-
getRendererType
public String getRendererType()
Description copied from class:ClientBehaviorBaseReturns the renderer type of the
ClientBehaviorRendererto use for the behavior. The default implementation returns null. Subclasses should either override this method to return a string that identifies the type ofClientBehaviorRendererto use, or should overrideClientBehaviorBase.getScript(jakarta.faces.component.behavior.ClientBehaviorContext)and perform script rendering locally in theClientBehaviorimplementation.- Overrides:
getRendererTypein classClientBehaviorBase- Returns:
- the default renderer type, which is null.
-
getHints
public Set<ClientBehaviorHint> getHints()
This method returns an unmodifiable
Setcontaining theClientBehaviorHintSUBMITTING.- Specified by:
getHintsin interfaceClientBehavior- Overrides:
getHintsin classClientBehaviorBase- Returns:
- unmodifiable set containing the hint
ClientBehaviorHintSUBMITTING. - Since:
- 2.0
-
getOnerror
public String getOnerror()
Return the
Stringof JavaScript function name that will be used to identify the client callback function that should be run in the event of an error.- Returns:
- the JavaScript function name of
ONERROR. - Since:
- 2.0
-
setOnerror
public void setOnerror(String onerror)
Sets the JavaScript function name that will be used to identify the client callback function that should be run in the event of an error.
- Parameters:
onerror- the error handling function name- Since:
- 2.0
-
getOnevent
public String getOnevent()
Return the
Stringof JavaScript function name that will be used to identify the client callback function that should be run on the occurance of a client-side event.- Returns:
- the JavaScript function name of
ONEVENT. - Since:
- 2.0
-
setOnevent
public void setOnevent(String onevent)
Sets the JavaScript function name that will be used to identify the client callback function that should be run in response to event activity.
- Parameters:
onevent- the event handling function name- Since:
- 2.0
-
getExecute
public Collection<String> getExecute()
Return a non-empty
Collection<String>of component identifiers that will be used to identify components that should be processed during theexecutephase of the request processing lifecycle.Note that the returned collection may be unmodifiable. Modifications should be performed by calling
setExecute(java.util.Collection<java.lang.String>).- Returns:
- the JavaScript function name of
EXECUTE. - Since:
- 2.0
-
setExecute
public void setExecute(Collection<String> execute)
Sets the component identifiers that will be used to identify components that should be processed during the
executephase of the request processing lifecycle.- Parameters:
execute- the ids of components to execute- Since:
- 2.0
-
getDelay
public String getDelay()
Returns the delay value, or
nullif no value was set.- Returns:
- the delay value.
- Since:
- 2.2
-
setDelay
public void setDelay(String delay)
If less than delay milliseconds elapses between calls to request() only the most recent one is sent and all other requests are discarded. The default value of this option is 300. If the value of delay is the literal string
'none'without the quotes, no delay is used.- Parameters:
delay- the ajax delay value- Since:
- 2.2
-
getRender
public Collection<String> getRender()
Return a non-empty
Collection<String>of component identifiers that will be used to identify components that should be processed during therenderphase of the request processing lifecycle.Note that the returned collection may be unmodifiable. Modifications should be performed by calling
setRender(java.util.Collection<java.lang.String>).- Returns:
- the ids of components to render.
- Since:
- 2.0
-
setRender
public void setRender(Collection<String> render)
Sets the component identifiers that will be used to identify components that should be processed during the
renderphase of the request processing lifecycle.- Parameters:
render- the ids of components to render- Since:
- 2.0
-
isResetValues
public boolean isResetValues()
Return the resetValues status of this behavior.
- Returns:
- the resetValues status.
- Since:
- 2.2
-
setResetValues
public void setResetValues(boolean resetValues)
Set the resetValues status of this behavior.
- Parameters:
resetValues- the resetValues status.- Since:
- 2.2
-
isDisabled
public boolean isDisabled()
Return the disabled status of this behavior.
- Returns:
- the disabled status of this behavior.
- Since:
- 2.0
-
setDisabled
public void setDisabled(boolean disabled)
Sets the disabled status of this behavior.
- Parameters:
disabled- the flag to be set.- Since:
- 2.0
-
isImmediate
public boolean isImmediate()
Return the immediate status of this behavior.
- Returns:
- the immediate status.
- Since:
- 2.0
-
setImmediate
public void setImmediate(boolean immediate)
Sets the immediate status of this behavior.
- Parameters:
immediate- the flag to be set.- Since:
- 2.0
-
isImmediateSet
public boolean isImmediateSet()
Tests whether the immediate attribute is specified. Returns true if the immediate attribute is specified, either as a locally set property or as a value expression. This information allows an associated client behavior renderer to fall back on the parent component's immediate status when immediate is not explicitly specified on the
AjaxBehavior.- Returns:
- the flag whether the immediate attribute is specified.
- Since:
- 2.0
-
isResetValuesSet
public boolean isResetValuesSet()
Tests whether the resetValues attribute is specified. Returns true if the resetValues attribute is specified, either as a locally set property or as a value expression.
- Returns:
- the flag whether the resetValues attribute is specified.
- Since:
- 2.2
-
getValueExpression
public ValueExpression getValueExpression(String name)
Returns the
ValueExpressionused to calculate the value for the specified property name, if any.- Parameters:
name- Name of the property for which to retrieve aValueExpression- Returns:
- the
ValueExpression. - Throws:
NullPointerException- ifnameisnull
-
setValueExpression
public void setValueExpression(String name, ValueExpression binding)
Sets the
ValueExpressionused to calculate the value for the specified property name.- Parameters:
name- Name of the property for which to set aValueExpressionbinding- TheValueExpressionto set, ornullto remove any currently setValueExpression- Throws:
NullPointerException- ifnameisnull
-
addAjaxBehaviorListener
public void addAjaxBehaviorListener(AjaxBehaviorListener listener)
Add the specified
AjaxBehaviorListenerto the set of listeners registered to receive event notifications from thisAjaxBehavior.- Parameters:
listener- TheAjaxBehaviorListenerto be registered- Throws:
NullPointerException- iflistenerisnull- Since:
- 2.0
-
removeAjaxBehaviorListener
public void removeAjaxBehaviorListener(AjaxBehaviorListener listener)
Remove the specified
AjaxBehaviorListenerfrom the set of listeners registered to receive event notifications from thisAjaxBehavior.- Parameters:
listener- TheAjaxBehaviorListenerto be removed- Throws:
NullPointerException- iflistenerisnull- Since:
- 2.0
-
saveState
public Object saveState(FacesContext context)
Description copied from class:BehaviorBaseImplementation of
StateHolder.saveState(jakarta.faces.context.FacesContext).- Specified by:
saveStatein interfaceStateHolder- Overrides:
saveStatein classBehaviorBase- Parameters:
context- the Faces context.- Returns:
- the saved state.
-
restoreState
public void restoreState(FacesContext context, Object state)
Description copied from class:BehaviorBase- Specified by:
restoreStatein interfaceStateHolder- Overrides:
restoreStatein classBehaviorBase- Parameters:
context- the Faces context.state- the state.
-
-