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 the ClientBehaviorHolder.addClientBehavior(java.lang.String, javax.faces.component.behavior.ClientBehavior) contract that components implement. The presence of this ClientBehavior will cause the rendering of JavaScript that produces an Ajax 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.

Eerste pagina van API Java Inhoudsopgave Haut

Constructor Summary

Constructors
Constructor and Description

AjaxBehavior()

Eerste pagina van API Java Inhoudsopgave Haut

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 this `AjaxBehavior`.
`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 the `execute` phase of the request processing lifecycle.
`Set<ClientBehaviorHint>`	`getHints()` This method returns an unmodifiable `Set` containing the `ClientBehaviorHint` `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 the `render` 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 this `AjaxBehavior`.
`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.

Eerste pagina van API Java Inhoudsopgave Haut

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
- Constructor Detail
  - AjaxBehavior
```
public AjaxBehavior()
```
- 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 of ClientBehaviorRenderer to use, or should override ClientBehaviorBase.getScript(javax.faces.component.behavior.ClientBehaviorContext) and perform script rendering locally in the ClientBehavior implementation.
    
    Overrides:
    
    getRendererType in class ClientBehaviorBase
    
    Returns:
    
    the default renderer type, which is null.
  - getHints
```
public Set<ClientBehaviorHint> getHints()
```
    This method returns an unmodifiable Set containing the ClientBehaviorHint SUBMITTING.
    
    Specified by:
    
    getHints in interface ClientBehavior
    
    Overrides:
    
    getHints in class ClientBehaviorBase
    
    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 the execute 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 the render 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 a ValueExpression
    
    Throws:
    
    NullPointerException - if name is null
  - 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 a ValueExpression
    
    binding - The ValueExpression to set, or null to remove any currently set ValueExpression
    
    Throws:
    
    NullPointerException - if name is null
  - addAjaxBehaviorListener
```
public void addAjaxBehaviorListener(AjaxBehaviorListener listener)
```
    Add the specified AjaxBehaviorListener to the set of listeners registered to receive event notifications from this AjaxBehavior.
    
    Parameters:
    
    listener - The AjaxBehaviorListener to be registered
    
    Throws:
    
    NullPointerException - if listener is null
    
    Since:
    
    2.0
  - removeAjaxBehaviorListener
```
public void removeAjaxBehaviorListener(AjaxBehaviorListener listener)
```
    Remove the specified AjaxBehaviorListener from the set of listeners registered to receive event notifications from this AjaxBehavior.
    
    Parameters:
    
    listener - The AjaxBehaviorListener to be removed
    
    Throws:
    
    NullPointerException - if listener is null
    
    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 interface StateHolder
    
    Overrides:
    
    saveState in class BehaviorBase
  - 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 interface StateHolder
    
    Overrides:
    
    restoreState in class BehaviorBase

Nederlandse vertaling

U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.

Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.

Bij voorbaat dank.

Document heeft de 11/06/2005 gemaakt, de laatste keer de 18/08/2025 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-javaee-rf-javax/faces/component/behavior/AjaxBehavior.html

De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.

Referenties

Manuel PHP : https://docs.oracle.com, AjaxBehavior (Java(TM) EE 7 Specification APIs)

Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur van deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.

Class AjaxBehavior

Field Summary

Constructor Summary

Method Summary

Methods inherited from class javax.faces.component.behavior.ClientBehaviorBase

Methods inherited from class javax.faces.component.behavior.BehaviorBase

Methods inherited from class java.lang.Object

Methods inherited from interface javax.faces.component.behavior.Behavior

Field Detail

BEHAVIOR_ID

Constructor Detail

AjaxBehavior

Method Detail

getRendererType

getHints

getOnerror

setOnerror

getOnevent

setOnevent

getExecute

setExecute

getDelay

setDelay

getRender

setRender

isResetValues

setResetValues

isDisabled

setDisabled

isImmediate

setImmediate

isImmediateSet

isResetValuesSet

getValueExpression

setValueExpression

addAjaxBehaviorListener

removeAjaxBehaviorListener

saveState

restoreState

Referenties