Package jakarta.faces.bean

Annotation Interface ManagedBean

@Retention(RUNTIME) @Target(TYPE) @Inherited @Deprecated public @interface ManagedBean
Deprecated.
This has been replaced by the Managed Beans specification in general and specifically the dependency injection, scopes and naming from the CDI specification. Note that the eager attribute for application scoped beans is replaced specifically by observing the jakarta.enterprise.context.Initialized event for jakarta.enterprise.context.ApplicationScoped. See 6.7.3 of the CDI spec for further details.

The presence of this annotation on a class automatically registers the class with the runtime as a managed bean class. Classes must be scanned for the presence of this annotation at application startup, before any requests have been serviced.

The value of the name() attribute is taken to be the managed-bean-name. If the value of the name attribute is unspecified or is the empty String, the managed-bean-name is derived from taking the unqualified class name portion of the fully qualified class name and converting the first character to lower case. For example, if the ManagedBean annotation is on a class with the fully qualified class name com.foo.Bean, and there is no name attribute on the annotation, the managed-bean-name is taken to be bean. The fully qualified class name of the class to which this annotation is attached is taken to be the managed-bean-class.

The scope of the managed bean is declared using one of NoneScoped, RequestScoped, ViewScoped, SessionScoped, ApplicationScoped, or CustomScoped annotations. If the scope annotations are omitted, the bean must be handled as if the RequestScoped annotation is present.

If the value of the eager() attribute is true, and the managed-bean-scope value is "application", the runtime must instantiate this class when the application starts. This instantiation and storing of the instance must happen before any requests are serviced. If eager is unspecified or false, or the managed-bean-scope is something other than "application", the default "lazy" instantiation and scoped storage of the managed bean happens.

When the runtime processes this annotation, if a managed bean exists whose name is equal to the derived managed-bean-name, a FacesException must be thrown and the application must not be placed in service.

A class tagged with this annotation must have a public zero-argument constructor. If such a constructor is not defined on the class, a FacesException must be thrown and the application must not be placed in service.

Since:
2.0

  • Optional Element Summary

    Optional Elements
    Modifier and Type
    Optional Element
    Description
    boolean
    eager
    Deprecated.
    Taken to be the value of the eager attribute of the managed-bean.
    String
    name
    Deprecated.
    Taken to be the managed-bean-name.

  • Element Details

    • name

      String name
      Deprecated.

      Taken to be the managed-bean-name. See class documentation for details.

      Returns:
      the managed bean name.
      Default:
      ""

    • eager

      boolean eager
      Deprecated.

      Taken to be the value of the eager attribute of the managed-bean. See class documentation for details.

      Returns:
      the eager attribute of the managed bean.
      Default:
      false