- java.lang.Object
-
- javax.faces.component.behavior.BehaviorBase
-
- javax.faces.component.behavior.ClientBehaviorBase
-
- javax.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
ClientBehavior
to a component using theClientBehaviorHolder.addClientBehavior(java.lang.String, javax.faces.component.behavior.ClientBehavior)
contract that components implement. The presence of thisClientBehavior
will cause the rendering of JavaScript that produces anAjax
request 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 and Description static String
BEHAVIOR_ID
The standard id for this behavior.
-
Constructor Summary
Constructors Constructor and Description AjaxBehavior()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method and Description void
addAjaxBehaviorListener(AjaxBehaviorListener listener)
Add the specified
AjaxBehaviorListener
to the set of listeners registered to receive event notifications from thisAjaxBehavior
.String
getDelay()
Returns the delay value, or
null
if no value was set.Collection<String>
getExecute()
Return a non-empty
Collection<String>
of component identifiers that will be used to identify components that should be processed during theexecute
phase of the request processing lifecycle.Set<ClientBehaviorHint>
getHints()
This method returns an unmodifiable
Set
containing theClientBehaviorHint
SUBMITTING
.String
getOnerror()
Return the
String
of JavaScript function name that will be used to identify the client callback function that should be run in the event of an error.String
getOnevent()
Return the
String
of 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-empty
Collection<String>
of component identifiers that will be used to identify components that should be processed during therender
phase of the request processing lifecycle.String
getRendererType()
Returns the renderer type of the
ClientBehaviorRenderer
to use for the behavior.ValueExpression
getValueExpression(String name)
Returns the
ValueExpression
used to calculate the value for the specified property name, if any.boolean
isDisabled()
Return the disabled status of this behavior.
boolean
isImmediate()
Return the immediate status of this behavior.
boolean
isImmediateSet()
Tests whether the immediate attribute is specified.
boolean
isResetValues()
Return the resetValues status of this behavior.
boolean
isResetValuesSet()
Tests whether the resetValues attribute is specified.
void
removeAjaxBehaviorListener(AjaxBehaviorListener listener)
Remove the specified
AjaxBehaviorListener
from the set of listeners registered to receive event notifications from thisAjaxBehavior
.void
restoreState(FacesContext context, Object state)
Implementation of
StateHolder.restoreState(javax.faces.context.FacesContext, java.lang.Object)
.Object
saveState(FacesContext context)
Implementation of
StateHolder.saveState(javax.faces.context.FacesContext)
.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.
void
setDisabled(boolean disabled)
Sets the disabled status of this behavior.
void
setExecute(Collection<String> execute)
Sets the component identifiers that will be used to identify components that should be processed during the
execute
phase of the request processing lifecycle.void
setImmediate(boolean immediate)
Sets the immediate status of this behavior.
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.
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.
void
setRender(Collection<String> render)
Sets the component identifiers that will be used to identify components that should be processed during the
render
phase of the request processing lifecycle.void
setResetValues(boolean resetValues)
Set the resetValues status of this behavior.
void
setValueExpression(String name, ValueExpression binding)
Sets the
ValueExpression
used to calculate the value for the specified property name.-
Methods inherited from class javax.faces.component.behavior.ClientBehaviorBase
decode, getRenderer, getScript
-
Methods inherited from class javax.faces.component.behavior.BehaviorBase
addBehaviorListener, broadcast, clearInitialState, initialStateMarked, isTransient, markInitialState, removeBehaviorListener, setTransient
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface javax.faces.component.behavior.Behavior
broadcast
-
-
-
-
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:ClientBehaviorBase
Returns the renderer type of the
ClientBehaviorRenderer
to use for the behavior. The default implementation returns null. Subclasses should either override this method to return a string that identifies the type ofClientBehaviorRenderer
to use, or should overrideClientBehaviorBase.getScript(javax.faces.component.behavior.ClientBehaviorContext)
and perform script rendering locally in theClientBehavior
implementation.- Overrides:
getRendererType
in classClientBehaviorBase
- Returns:
- the default renderer type, which is null.
-
getHints
public Set<ClientBehaviorHint> getHints()
This method returns an unmodifiable
Set
containing theClientBehaviorHint
SUBMITTING
.- Specified by:
getHints
in interfaceClientBehavior
- Overrides:
getHints
in classClientBehaviorBase
- Returns:
- unmodifiable set containing the hint
ClientBehaviorHint
SUBMITTING
. - Since:
- 2.0
-
getOnerror
public String getOnerror()
Return the
String
of JavaScript function name that will be used to identify the client callback function that should be run in the event of an error.- 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
String
of 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.- 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 theexecute
phase 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>)
.- 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
execute
phase 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
null
if no value was set.- 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 therender
phase 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>)
.- 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
render
phase 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.
- Since:
- 2.2
-
setResetValues
public void setResetValues(boolean resetValues)
Set the resetValues status of this behavior.
- Since:
- 2.2
-
isDisabled
public boolean isDisabled()
Return the disabled status of this behavior.
- Since:
- 2.0
-
setDisabled
public void setDisabled(boolean disabled)
Sets the disabled status of this behavior.
- Since:
- 2.0
-
isImmediate
public boolean isImmediate()
Return the immediate status of this behavior.
- Since:
- 2.0
-
setImmediate
public void setImmediate(boolean immediate)
Sets the immediate status of this behavior.
- 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
.- 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.
- Since:
- 2.2
-
getValueExpression
public ValueExpression getValueExpression(String name)
Returns the
ValueExpression
used to calculate the value for the specified property name, if any.- Parameters:
name
- Name of the property for which to retrieve aValueExpression
- Throws:
NullPointerException
- ifname
isnull
-
setValueExpression
public void setValueExpression(String name, ValueExpression binding)
Sets the
ValueExpression
used to calculate the value for the specified property name.- Parameters:
name
- Name of the property for which to set aValueExpression
binding
- TheValueExpression
to set, ornull
to remove any currently setValueExpression
- Throws:
NullPointerException
- ifname
isnull
-
addAjaxBehaviorListener
public void addAjaxBehaviorListener(AjaxBehaviorListener listener)
Add the specified
AjaxBehaviorListener
to the set of listeners registered to receive event notifications from thisAjaxBehavior
.- Parameters:
listener
- TheAjaxBehaviorListener
to be registered- Throws:
NullPointerException
- iflistener
isnull
- Since:
- 2.0
-
removeAjaxBehaviorListener
public void removeAjaxBehaviorListener(AjaxBehaviorListener listener)
Remove the specified
AjaxBehaviorListener
from the set of listeners registered to receive event notifications from thisAjaxBehavior
.- Parameters:
listener
- TheAjaxBehaviorListener
to be removed- Throws:
NullPointerException
- iflistener
isnull
- Since:
- 2.0
-
saveState
public Object saveState(FacesContext context)
Description copied from class:BehaviorBase
Implementation of
StateHolder.saveState(javax.faces.context.FacesContext)
.- Specified by:
saveState
in interfaceStateHolder
- Overrides:
saveState
in classBehaviorBase
-
restoreState
public void restoreState(FacesContext context, Object state)
Description copied from class:BehaviorBase
Implementation of
StateHolder.restoreState(javax.faces.context.FacesContext, java.lang.Object)
.- Specified by:
restoreState
in interfaceStateHolder
- Overrides:
restoreState
in classBehaviorBase
-
-
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 18/08/2025
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-javaee-rf-javax/faces/component/behavior/ajaxbehavior.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor dieser Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.