-
@Target(value=PARAMETER) @Retention(value=RUNTIME) @Documented public @interface Observes
Identifies the event parameter of an observer method. May be applied to a parameter of a method of a bean class or extension.
public void afterLogin(@Observes LoggedInEvent event) { ... }An observer method is a non-abstract method of a managed bean class or session bean class (or of an extension). An observer method may be either static or non-static. If the bean is a session bean, the observer method must be either a business method of the EJB or a static method of the bean class.
Each observer method must have exactly one event parameter, of the same type as the event type it observes. Event qualifiers may be declared by annotating the event parameter. When searching for observer methods for an event, the container considers the type and qualifiers of the event parameter.
If the event parameter does not explicitly declare any qualifier, the observer method observes events with no qualifier.
The event parameter type may contain a type variable or wildcard.
In addition to the event parameter, observer methods may declare additional parameters, which may declare qualifiers. These additional parameters are injection points.
public void afterLogin(@Observes LoggedInEvent event, @Manager User user, Logger log) { ... }A bean (or extension) may declare multiple observer methods.
Observer methods are inherited by bean subclasses.
Interceptors and decorators may not declare observer methods.
- Author:
- Gavin King, Pete Muir, David Allen
-
-
Optional Element Summary
Optional Elements Modifier and Type Optional Element and Description TransactionPhaseduringSpecifies at what time the observer method is notified.ReceptionnotifyObserver
-
-
-
Element Detail
-
notifyObserver
public abstract Reception notifyObserver
Specifies under what conditions the observer method is notified.
By default, the observer method is notified even if no instance of the bean that defines the observer method already exists in the current context.
- Default:
- javax.enterprise.event.Reception.ALWAYS
-
-
-
during
public abstract TransactionPhase during
Specifies at what time the observer method is notified.
By default, the observer method is notified when the event is fired.
- Default:
- javax.enterprise.event.TransactionPhase.IN_PROGRESS
-
-
Document created the 11/06/2005, last modified the 18/08/2025
Source of the printed document:https://www.gaudry.be/en/java-api-javaee-rf-javax/enterprise/event/observes.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author of this site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.