-
@Target({TYPE,METHOD,FIELD}) @Retention(RUNTIME) @Documented @NormalScope @Inherited public @interface ApplicationScopedSpecifies that a bean is application scoped.
While
ApplicationScopedmust be associated with the built-in application context required by the specification, third-party extensions are allowed to also associate it with their own context. Behavior described below is only related to the built-in application context.The application scope is active:
- during the
service()method of any servlet in the web application, during thedoFilter()method of any servlet filter and when the container calls anyServletContextListener,HttpSessionListener,AsyncListenerorServletRequestListener, - during any Java EE web service invocation,
- during any remote method invocation of any EJB, during any asynchronous method invocation of any EJB, during any call to an EJB timeout method and during message delivery to any EJB message-driven bean,
- when the disposer method or
@PreDestroycallback of any bean with any normal scope other than@ApplicationScopedis called, and - during
@PostConstructcallback of any bean.
The application context is shared between all servlet requests, web service invocations, EJB remote method invocations, EJB asynchronous method invocations, EJB timeouts and message deliveries to message-driven beans that execute within the same application.
The application context is destroyed when the application is shut down.
An event with qualifier
@Initialized(ApplicationScoped.class)is fired when the application context is initialized and an event with qualifier@Destroyed(ApplicationScoped.class)when the application context is destroyed. The event payload is:- the
ServletContextif the application is a web application deployed to a Servlet container, or - any
java.lang.Objectfor other types of application.
- Author:
- Gavin King, Pete Muir, Antoine Sabot-Durand
- during the