搜索

7.4. 受管 Bean

download PDF

Jakarta EE 在 Jakarta 托管 Bean 规范中建立了通用定义。对于 Java EE,受管 Bean 定义为具有最低编程限制的容器管理的 Bean,否则被缩写为 POJO(Plain Old Java 对象)所知。它们支持一组基本服务,如资源注入、生命周期回调和拦截器。配套规范(如 Jakarta Enterprise Beans 和 Jakarta Contexts 和 Dependency Injection)构建在这个基本模型之上。

除极少数外,几乎每个没有参数的构造器或带有注释 @Inject 的构造器都是 bean。这包括每个 JavaBean 和每个 Jakarta Enterprise Beans 会话 bean。

7.4.1. Bean 类

受管 Bean 是 Java 类。对于 Jakarta EE,受管 Bean 的基本生命周期和语义按照 Jakarta Managed Beans 1.0 规范进行定义。您可以通过注解 beanagedBean 类来明确声明受管 Banaged Bean,但在上下文和依赖注入中,您不需要这样做。根据规范,上下文和依赖注入容器将满足以下条件的任何类视为受管 Bean:

  • 这不是一个非静态内类。
  • 它是具体类,或者带有 @Decorator 标注。
  • 它没有使用 EJB 组件定义注释,也不声明为 ejb-jar.xml 文件中的企业 Java Bean bean 类。
  • 它不实施接口 javax.enterprise.inject.spi.Extension
  • 它具有不含参数的构造器,或者带有 @Inject 标注的构造器。
  • 它不标有 @Vetoed,也不在标有 @Vetoed 的包中标注。

受管 Bean 的无限制 Bean 类型包含 Bean 类、每个超级类,以及它直接或间接实施的所有接口。

如果受管 Bean 具有公共字段,则必须具有默认范围 @Dependent

@Vetoed

CDI 1.1 中引入了 @Vetoed 注释。您可以通过添加此注解来防止 bean 注入:

@Vetoed
public class SimpleGreeting implements Greeting {
    ...
}

在这个代码中,SimpleGreeting Bean 不视为注入。

软件包中的所有 bean 可以被禁止注入:

@Vetoed
package org.sample.beans;

import javax.enterprise.inject.Vetoed;

此代码在 org.sample .beans 软件包中的 package-info. java 代码将阻止此软件包中的所有 bean 注入。

Jakarta EE 组件(如无状态 Jakarta Enterprise Beans 或 JAX-RS 资源端点)可以标记为 @Vetoed,以防止它们被视为 bean。将 @Vetoed 注释添加到所有持久实体可防止 BeanManager 将实体作为 Jakarta 上下文和依赖注入 Bean 管理。当实体使用 @Vetoed 标注时,不会进行注入。其背后的原因是防止 BeanManager 执行可能导致 Java Persistence 提供商中断的操作。

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.