Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

61.2. 容器请求过滤器

概述
复制链接

本节介绍如何实施和注册 容器请求过滤器，该过滤器 用于截获服务器（容器）侧传入的请求消息。容器请求过滤器通常用于处理服务器端的标头，并可用于任何类型的通用请求处理（也就是说，独立于特定资源方法的处理）。

此外，容器请求过滤器是特殊案例之一，因为它可在两个不同的扩展点安装： PreMatchContainerRequest （在资源匹配步骤之前）和 ContainerRequest （在资源匹配步骤后安装）。

ContainerRequestFilter 接口
复制链接

javax.ws.rs.container.ContainerRequestFilter 接口定义如下： 

// Java
...
package javax.ws.rs.container;

import java.io.IOException;

public interface ContainerRequestFilter {
    public void filter(ContainerRequestContext requestContext) throws IOException;
}
Copy to Clipboard Toggle word wrap

通过实现 ContainerRequestFilter 接口，您可以在服务器端为以下任意扩展点创建一个过滤器：

  • PreMatchContainerRequest
  • ContainerRequest

ContainerRequestContext 接口
复制链接

ContainerRequestFilter 的 过滤器 方法接收一个类型为 javax.ws.rs.container.ContainerRequestContext，它可用于访问传入请求消息及其相关元数据。ContainerRequestContext 接口定义如下： 

// Java
...
package javax.ws.rs.container;

import java.io.InputStream;
import java.net.URI;
import java.util.Collection;
import java.util.Date;
import java.util.List;
import java.util.Locale;
import java.util.Map;

import javax.ws.rs.core.Cookie;
import javax.ws.rs.core.MediaType;
import javax.ws.rs.core.MultivaluedMap;
import javax.ws.rs.core.Request;
import javax.ws.rs.core.Response;
import javax.ws.rs.core.SecurityContext;
import javax.ws.rs.core.UriInfo;


public interface ContainerRequestContext {

    public Object getProperty(String name);

    public Collection getPropertyNames();

    public void setProperty(String name, Object object);

    public void removeProperty(String name);

    public UriInfo getUriInfo();

    public void setRequestUri(URI requestUri);

    public void setRequestUri(URI baseUri, URI requestUri);

    public Request getRequest();

    public String getMethod();

    public void setMethod(String method);

    public MultivaluedMap getHeaders();

    public String getHeaderString(String name);

    public Date getDate();

    public Locale getLanguage();

    public int getLength();

    public MediaType getMediaType();

    public List getAcceptableMediaTypes();

    public List getAcceptableLanguages();

    public Map getCookies();

    public boolean hasEntity();

    public InputStream getEntityStream();

    public void setEntityStream(InputStream input);

    public SecurityContext getSecurityContext();

    public void setSecurityContext(SecurityContext context);

    public void abortWith(Response response);
}
Copy to Clipboard Toggle word wrap

PreMatchContainerRequest 过滤器的实现示例
复制链接

要对 PreMatchContainerRequest 扩展点实施容器请求过滤器（即，在资源匹配之前执行过滤器），请定义实施 ContainerRequestFilter 接口的类，确保为类标上 @PreMatching 注释（以选择 PreMatchContainerRequest 扩展点）。

例如，以下代码显示了在 PreMatchContainerRequest 扩展点中安装的简单容器请求过滤器示例，其优先级为 20: 

// Java
package org.jboss.fuse.example;

import javax.ws.rs.container.ContainerRequestContext;
import javax.ws.rs.container.ContainerRequestFilter;
import javax.ws.rs.container.PreMatching;
import javax.annotation.Priority;
import javax.ws.rs.ext.Provider;

@PreMatching
@Priority(value = 20)
@Provider
public class SamplePreMatchContainerRequestFilter implements
  ContainerRequestFilter {

  public SamplePreMatchContainerRequestFilter() {
    System.out.println("SamplePreMatchContainerRequestFilter starting up");
  }

  @Override
  public void filter(ContainerRequestContext requestContext) {
    System.out.println("SamplePreMatchContainerRequestFilter.filter() invoked");
  }
}
Copy to Clipboard Toggle word wrap

ContainerRequest 过滤器的实现示例
复制链接

要对 ContainerRequest 扩展点实施容器请求过滤器（即，在资源匹配后执行过滤器），请定义一个实施 ContainerRequestFilter 接口的类，但不具有 @PreMatching 注释。

例如，以下代码显示了在 ContainerRequest 扩展点中安装的简单容器请求过滤器示例，其优先级为 30： 

// Java
package org.jboss.fuse.example;

import javax.ws.rs.container.ContainerRequestContext;
import javax.ws.rs.container.ContainerRequestFilter;
import javax.ws.rs.ext.Provider;
import javax.annotation.Priority;

@Provider
@Priority(value = 30)
public class SampleContainerRequestFilter implements ContainerRequestFilter {

  public SampleContainerRequestFilter() {
    System.out.println("SampleContainerRequestFilter starting up");
  }

  @Override
  public void filter(ContainerRequestContext requestContext) {
    System.out.println("SampleContainerRequestFilter.filter() invoked");
  }
}
Copy to Clipboard Toggle word wrap

注入 ResourceInfo
复制链接

在 ContainerRequest 扩展点（即，在资源匹配 后 ），可以通过注入 ResourceInfo 类来访问匹配的资源类和资源方法。例如，以下代码演示了如何将 ResourceInfo 类注入 ContainerRequestFilter 类的一个字段： 

// Java
package org.jboss.fuse.example;

import javax.ws.rs.container.ContainerRequestContext;
import javax.ws.rs.container.ContainerRequestFilter;
import javax.ws.rs.container.ResourceInfo;
import javax.ws.rs.ext.Provider;
import javax.annotation.Priority;
import javax.ws.rs.core.Context;

@Provider
@Priority(value = 30)
public class SampleContainerRequestFilter implements ContainerRequestFilter {

  @Context
  private ResourceInfo resinfo;

  public SampleContainerRequestFilter() {
    ...
  }

  @Override
  public void filter(ContainerRequestContext requestContext) {
    String resourceClass = resinfo.getResourceClass().getName();
    String methodName    = resinfo.getResourceMethod().getName();
    System.out.println("REST invocation bound to resource class: " + resourceClass);
    System.out.println("REST invocation bound to resource method: " + methodName);
  }
}
Copy to Clipboard Toggle word wrap

中止调用
复制链接

通过创建适合容器请求过滤器的实施，可以在调用中中止服务器端调用。通常，这可用于在服务器端实施安全功能：例如，用于实施身份验证功能或授权功能。如果传入请求无法成功进行身份验证，您可能会在容器请求过滤器中中止调用。

例如，以下预匹配功能尝试从 URI 的查询参数中提取用户名和密码，并调用验证方法来检查用户名和密码凭证。如果身份验证失败，调用会在 ContainerRequestContext 对象中调用 abortWith 来中止，从而传递返回给客户端的错误响应。 

// Java
package org.jboss.fuse.example;

import javax.annotation.Priority;
import javax.ws.rs.container.ContainerRequestContext;
import javax.ws.rs.container.ContainerRequestFilter;
import javax.ws.rs.container.PreMatching;
import javax.ws.rs.core.Response;
import javax.ws.rs.core.Response.ResponseBuilder;
import javax.ws.rs.core.Response.Status;
import javax.ws.rs.ext.Provider;

@PreMatching
@Priority(value = 20)
@Provider
public class SampleAuthenticationRequestFilter implements
  ContainerRequestFilter {

  public SampleAuthenticationRequestFilter() {
    System.out.println("SampleAuthenticationRequestFilter starting up");
  }

  @Override
  public void filter(ContainerRequestContext requestContext) {
    ResponseBuilder responseBuilder = null;
    Response response = null;

    String userName = requestContext.getUriInfo().getQueryParameters().getFirst("UserName");
    String password = requestContext.getUriInfo().getQueryParameters().getFirst("Password");
    if (authenticate(userName, password) == false) {
      responseBuilder = Response.serverError();
      response = responseBuilder.status(Status.BAD_REQUEST).build();
      requestContext.abortWith(response);
    }
  }

  public boolean authenticate(String userName, String password) {
    // Perform authentication of 'user'
    ...
  }
}
Copy to Clipboard Toggle word wrap

绑定服务器请求过滤器
复制链接

要 绑定 一个服务器请求过滤器（即，将其安装到 Apache CXF 运行时），请执行以下步骤：

  1. 将 @Provider 注释添加到容器请求过滤器类，如以下代码片段所示： 

    // Java
package org.jboss.fuse.example;

import javax.ws.rs.container.ContainerRequestContext;
import javax.ws.rs.container.ContainerRequestFilter;
import javax.ws.rs.ext.Provider;
import javax.annotation.Priority;

@Provider
@Priority(value = 30)
public class SampleContainerRequestFilter implements ContainerRequestFilter {
  ...
}
    Copy to Clipboard Toggle word wrap

    当容器请求过滤器实现加载到 Apache CXF 运行时时，REST 实施会自动扫描加载的类，以搜索标有 @Provider 注释( 扫描阶段)的类。

  2. 在 XML 中定义 JAX-RS 服务器端点（例如，查看 第 18.1 节 “配置 JAX-RS 服务器端点”）时，将服务器请求过滤器添加到 jaxrs:providers 元素中的提供程序列表中。 

    <blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:jaxrs="http://cxf.apache.org/blueprint/jaxrs"
    xmlns:cxf="http://cxf.apache.org/blueprint/core"
    ...
>
    ...
    <jaxrs:server id="customerService" address="/customers">
      ...
      <jaxrs:providers>
        <ref bean="filterProvider" />
      </jaxrs:providers>
      <bean id="filterProvider" class="org.jboss.fuse.example.SampleContainerRequestFilter"/>

    </jaxrs:server>

</blueprint>
    Copy to Clipboard Toggle word wrap
    注意

    此步骤是 Apache CXF 非标准要求。严格根据 JAX-RS 标准进行说明，@Provider 注释应属于绑定该过滤器所需的所有内容。但是，在实践中，标准方法非常不灵活，如果大型项目中纳入了许多库，则可能会导致供应商冲突。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat