Jersey 2中如何在post-matching请求过滤器中修改查询参数?
Jersey 2.x Post-Matching 过滤器修改查询参数的实现方案
现有方案的限制说明
- *
ContainerRequestContext#setRequestUri*方法为Jersey框架的受限接口,仅允许在pre-matching阶段的过滤器中调用,post-matching阶段调用会直接抛出IllegalStateException异常,这是框架的设计规则:URI修改会改变路由匹配逻辑,post-matching阶段已完成资源路由匹配,因此框架直接禁用了URI修改接口。 - 普通Servlet Filter虽然可以通过
HttpServletRequestWrapper修改请求参数,但在请求到达Servlet Filter时,尚未完成Jersey的资源路由匹配流程,无法获取匹配到的资源类、资源方法的注解信息,无法满足你的业务逻辑需求。 - 基于请求属性透传参数的方案需要改造所有业务代码的参数读取逻辑,改造成本高,不符合你的预期。
核心实现逻辑
post-matching阶段修改查询参数不需要依赖setRequestUri接口:Jersey在路由匹配完成后,所有通过@QueryParam、@PathParam注解标记的资源参数,都会从当前请求上下文绑定的UriInfo实例中读取值。只要在post-matching过滤器中,将原有的UriInfo实例替换为携带修改后查询参数的新实例,后续的参数注入流程就会自动读取到修改后的值,全程不需要改动业务代码,也不需要接触Servlet层的过滤链路。
代码实现示例
public class MyFilter implements ContainerRequestFilter { @Override public void filter(final ContainerRequestContext requestContext) { // 获取原始请求的UriInfo实例,可正常读取匹配到的资源类、方法元数据与注解 UriInfo originalUriInfo = requestContext.getUriInfo(); // 复制原始查询参数,按需修改对应参数值 MultivaluedMap<String, String> originalQueryParams = originalUriInfo.getQueryParameters(); MultivaluedMap<String, String> newQueryParams = new MultivaluedHashMap<>(originalQueryParams); // 示例:按需替换查询参数值,替换逻辑可基于获取到的资源类、方法注解实现 newQueryParams.putSingle("targetParam", "modifiedValue"); // 构建新的请求URI,保留原基础路径、请求路径,仅替换查询参数 URI baseUri = originalUriInfo.getBaseUri(); URI requestUri = UriBuilder.fromUri(originalUriInfo.getRequestUri()) .replaceQuery(newQueryParams) .build(); // 构造新的UriInfo实例,替换请求上下文中的原有实例 UriInfo newUriInfo = new UriInfoImpl(baseUri, requestUri); requestContext.setUriInfo(newUriInfo); } }
注意:
ContainerRequestContext#setUriInfo接口没有调用阶段限制,post-matching阶段可正常调用,不会触发框架抛出的状态异常。
方案优势
- 完整运行在post-matching过滤器生命周期内,可正常获取资源类、资源方法的注解信息,完全匹配你的业务逻辑依赖
- 不需要通过请求属性透传参数,后续Jersey的参数注入逻辑会自动使用修改后的查询参数,零业务代码侵入
- 不需要接触Servlet层的过滤链路,也就不需要构造
HttpServletRequestWrapper实现,不存在跨层上下文丢失的问题
内容的提问来源于stack exchange,提问作者Giridhar Kumar
相关产品推荐
相关产品推荐

