- java.lang.Object
-
- javax.faces.component.behavior.BehaviorBase
-
- All Implemented Interfaces:
- Behavior, PartialStateHolder, StateHolder
- Direct Known Subclasses:
- ClientBehaviorBase
public class BehaviorBase extends Object implements Behavior, PartialStateHolder
BehaviorBase is a convenience base class that provides a default implementation of the
Behavior
contract. It also provides behavior listener registration and state saving support.- Since:
- 2.0
-
-
Constructor Summary
Constructors Constructor and Description BehaviorBase()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method and Description protected void
addBehaviorListener(BehaviorListener listener)
Add the specified
BehaviorListener
to the set of listeners registered to receive event notifications from thisBehavior
.void
broadcast(BehaviorEvent event)
Default implementation of
Behavior.broadcast(javax.faces.event.BehaviorEvent)
.void
clearInitialState()
Clears the initial state flag, causing the behavior to revert from partial to full state saving.
boolean
initialStateMarked()
Implementation of
PartialStateHolder.initialStateMarked()
.boolean
isTransient()
Implementation of
StateHolder.isTransient()
.void
markInitialState()
Implementation of
PartialStateHolder.markInitialState()
.protected void
removeBehaviorListener(BehaviorListener listener)
Remove the specified
BehaviorListener
from the set of listeners registered to receive event notifications from thisBehavior
.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
setTransient(boolean transientFlag)
Implementation of
StateHolder.setTransient(boolean)
.
-
-
-
Method Detail
-
broadcast
public void broadcast(BehaviorEvent event) throws AbortProcessingException
Default implementation of
Behavior.broadcast(javax.faces.event.BehaviorEvent)
. Delivers the specifiedBehaviorEvent
to all registeredBehaviorListener
event listeners who have expressed an interest in events of this type. Listeners are called in the order in which they were registered (added).- Specified by:
broadcast
in interfaceBehavior
- Parameters:
event
- TheBehaviorEvent
to be broadcast- Throws:
AbortProcessingException
- Signal the JavaServer Faces implementation that no further processing on the current event should be performedIllegalArgumentException
- if the implementation class of thisBehaviorEvent
is not supported by this componentNullPointerException
- ifevent
isnull
- Since:
- 2.0
-
isTransient
public boolean isTransient()
Implementation of
StateHolder.isTransient()
.- Specified by:
isTransient
in interfaceStateHolder
-
setTransient
public void setTransient(boolean transientFlag)
Implementation of
StateHolder.setTransient(boolean)
.- Specified by:
setTransient
in interfaceStateHolder
- Parameters:
transientFlag
- boolean passtrue
if this Object will not participate in state saving or restoring, otherwise passfalse
.
-
saveState
public Object saveState(FacesContext context)
Implementation of
StateHolder.saveState(javax.faces.context.FacesContext)
.- Specified by:
saveState
in interfaceStateHolder
-
restoreState
public void restoreState(FacesContext context, Object state)
Implementation of
StateHolder.restoreState(javax.faces.context.FacesContext, java.lang.Object)
.- Specified by:
restoreState
in interfaceStateHolder
-
markInitialState
public void markInitialState()
Implementation of
PartialStateHolder.markInitialState()
.- Specified by:
markInitialState
in interfacePartialStateHolder
-
initialStateMarked
public boolean initialStateMarked()
Implementation of
PartialStateHolder.initialStateMarked()
.- Specified by:
initialStateMarked
in interfacePartialStateHolder
-
clearInitialState
public void clearInitialState()
Clears the initial state flag, causing the behavior to revert from partial to full state saving.
- Specified by:
clearInitialState
in interfacePartialStateHolder
-
addBehaviorListener
protected void addBehaviorListener(BehaviorListener listener)
Add the specified
BehaviorListener
to the set of listeners registered to receive event notifications from thisBehavior
. It is expected thatBehavior
classes acting as event sources will have corresponding typesafe APIs for registering listeners of the required type, and the implementation of those registration methods will delegate to this method. For example:public class AjaxBehaviorEvent extends BehaviorEvent { ... } public interface AjaxBehaviorListener extends BehaviorListener { public void processAjaxBehavior(FooEvent event); } public class AjaxBehavior extends ClientBehaviorBase { ... public void addAjaxBehaviorListener(AjaxBehaviorListener listener) { addBehaviorListener(listener); } public void removeAjaxBehaviorListener(AjaxBehaviorListener listener) { removeBehaviorListener(listener); } ... }
- Parameters:
listener
- TheBehaviorListener
to be registered- Throws:
NullPointerException
- iflistener
isnull
- Since:
- 2.0
-
removeBehaviorListener
protected void removeBehaviorListener(BehaviorListener listener)
Remove the specified
BehaviorListener
from the set of listeners registered to receive event notifications from thisBehavior
.- Parameters:
listener
- TheBehaviorListener
to be deregistered- Throws:
NullPointerException
- iflistener
isnull
- Since:
- 2.0
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
21/08/2025 18:30:06 Cette version de la page est en cache (à la date du 21/08/2025 18:30:06) afin d'accélérer le traitement.Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la version plus récente de la page.
Document créé le 11/06/2005, dernière modification le 18/08/2025
Source du document imprimé : https://www.gaudry.be/java-api-javaee-rf-javax/faces/component/behavior/BehaviorBase.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.