主页
产品
Red Hat JBoss Enterprise Application Platform
7.4
Development Guide
7.11. 拦截器

7.11. 拦截器

拦截器允许您在 Bean 的业务方法中添加功能，而无需直接修改 bean 的方法。拦截器在 Bean 的任何业务方法之前执行。拦截器定义为 Jakarta Enterprise Beans 规范的一部分。

Jakarta Contexts 和 Dependency Injection 允许您使用注解将拦截器绑定到 bean 来增强此功能。

拦截点

业务方法拦截器：商业方法拦截器适用于 Bean 的客户调用 Bean 方法。
生命周期回调拦截器：生命周期回调拦截器适用于容器调用的生命周期回调。
超时方法拦截器：超时方法拦截器应用于容器的 Jakarta Enterprise Beans 超时方法的调用。

启用 Interceptors

默认情况下，禁用所有拦截器。您可以使用 bean 存档的 beans.xml 描述符启用拦截器。但是，此激活仅适用于该存档中的 bean。

您可以使用 @Priority 注释为整个应用启用拦截器。

示例：在 beans.xml中启用 Interceptors

<beans
   xmlns="http://xmlns.jcp.org/xml/ns/javaee"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="
      http://xmlns.jcp.org/xml/ns/javaee
      http://xmlns.jcp.org/xml/ns/javaee/beans_2.0.xsd">
   <interceptors>
      <class>org.mycompany.myapp.TransactionInterceptor</class>
   </interceptors>
</beans>

<beans
   xmlns="http://xmlns.jcp.org/xml/ns/javaee"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="
      http://xmlns.jcp.org/xml/ns/javaee
      http://xmlns.jcp.org/xml/ns/javaee/beans_2.0.xsd">
   <interceptors>
      <class>org.mycompany.myapp.TransactionInterceptor</class>
   </interceptors>
</beans>

Copy to Clipboard

Toggle word wrap

使 XML 声明解决了两个问题：

它可让您在系统中指定拦截器的排序，以确保确定行为。
它可让您在部署时启用或禁用拦截器类。

在使用 beans.xml 文件启用拦截器之前，使用 @Priority 启用的拦截器会被调用。

注意

由 @Priority 启用拦截器并且同时被 beans.xml 文件调用会导致无法移植的行为。因此，应避免这种启用组合，以便在不同 Jakarta 上下文和依赖注入实施之间保持一致的行为。

7.11.1. 使用 Jakarta Contexts 和 Dependency Injection 的 Interceptors
复制链接

Jakarta Contexts 和 Dependency Injection 可以简化拦截器代码，更轻松地应用于您的业务代码。

如果没有 Jakarta 上下文和依赖注入，拦截器有两个问题：

Bean 必须直接指定拦截器实施。
应用程序中的每个 bean 都必须以正确的顺序指定完整的拦截器集合。这使得在应用程序范围内添加或移除拦截器会非常耗时且容易出错。

使用 Jakarta 上下文和依赖注入的 Interceptors

定义拦截器绑定类型。

@InterceptorBinding
@Retention(RUNTIME)
@Target({TYPE, METHOD})
public @interface Secure {}

@InterceptorBinding
@Retention(RUNTIME)
@Target({TYPE, METHOD})
public @interface Secure {}

Copy to Clipboard

Toggle word wrap

标记拦截器实施。

@Secure
@Interceptor
public class SecurityInterceptor {
  @AroundInvoke
  public Object aroundInvoke(InvocationContext ctx) throws Exception {
    // enforce security ...
    return ctx.proceed();
    }
}

@Secure
@Interceptor
public class SecurityInterceptor {
  @AroundInvoke
  public Object aroundInvoke(InvocationContext ctx) throws Exception {
    // enforce security ...
    return ctx.proceed();
    }
}

Copy to Clipboard

Toggle word wrap

在您的开发环境中使用拦截器。

@Secure
public class AccountManager {
  public boolean transfer(Account a, Account b) {
    ...
  }
}

@Secure
public class AccountManager {
  public boolean transfer(Account a, Account b) {
    ...
  }
}

Copy to Clipboard

Toggle word wrap

通过将其添加到 META-INF/beans.xml 或 WEB-INF/beans.xml 文件，在部署中启用拦截器。

<beans>
  <interceptors>
    <class>com.acme.SecurityInterceptor</class>
    <class>com.acme.TransactionInterceptor</class>
  </interceptors>
</beans>

<beans>
  <interceptors>
    <class>com.acme.SecurityInterceptor</class>
    <class>com.acme.TransactionInterceptor</class>
  </interceptors>
</beans>

Copy to Clipboard

Toggle word wrap

拦截器按照列出的顺序应用。

返回顶部

7.11. 拦截器

启用 Interceptors

7.11.1. 使用 Jakarta Contexts 和 Dependency Injection 的 Interceptors
复制链接

使用 Jakarta 上下文和依赖注入的 Interceptors

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

7.11. 拦截器

启用 Interceptors

7.11.1. 使用 Jakarta Contexts 和 Dependency Injection 的 Interceptors复制链接链接已复制到粘贴板!

使用 Jakarta 上下文和依赖注入的 Interceptors

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

7.11.1. 使用 Jakarta Contexts 和 Dependency Injection 的 Interceptors
复制链接