You need to enable JavaScript to run this app. Jersey客户端响应过滤器读取响应实体实现EhCache缓存的问题
优惠活动
大模型
产品
解决方案
定价
更多

Jersey客户端响应过滤器读取响应实体实现EhCache缓存的问题

Jersey客户端侧过滤器缓存实现的问题解法

核心问题根因

你在ClientResponseFilter里无法使用readEntity这类方法读实体的原因非常直接:

  • ClientResponseContext接口本身就没有定义带反序列化能力的readEntity方法,它暴露的getEntityStream()是原始的一次性可读字节流,留给过滤器的操作空间就是对字节流做拦截、改写,不支持直接把流转成Java对象读取。
  • 流是一次性消费的:如果直接在过滤器里把原始实体流读完、不做重置,下游业务代码调用response.readEntity()时会因为流已经被耗尽,拿到空内容,这也是你觉得getEntityStream“没法正常用”的本质原因。

完整可运行的实现逻辑

响应过滤器修正(解决缓存写入问题)

严格遵循「读全量内容-重置流供下游使用-写入缓存」的流程修改,代码如下:

private Ehcache ehcache;
// 控制单响应缓存的最大大小,避免大对象引发OOM
private static final int MAX_CACHE_BODY_SIZE = 1024 * 1024; // 1MB阈值

public ClientCacheResponseFilter(Ehcache ehcache) {
    this.ehcache = ehcache;
}

@Override
public void filter(ClientRequestContext request, ClientResponseContext response) throws IOException {
    System.out.println("RESPONSE FILTER");
    if (!request.getMethod().equalsIgnoreCase("GET")) {
        return;
    }

    if (response.getStatus() != 200 || response.getEntityStream() == null) {
        return;
    }

    String cacheKey = request.getUri().toString();
    System.out.println("准备缓存响应值");

    // 完整读取原始实体流为字节数组
    InputStream originalStream = response.getEntityStream();
    ByteArrayOutputStream buffer = new ByteArrayOutputStream();
    byte[] copyBuffer = new byte[4096];
    int readLen;
    int totalReadSize = 0;

    while ((readLen = originalStream.read(copyBuffer)) != -1) {
        totalReadSize += readLen;
        // 超过缓存阈值直接跳过缓存
        if (totalReadSize > MAX_CACHE_BODY_SIZE) {
            // 读完剩余流避免连接挂起
            originalStream.transferTo(OutputStream.nullOutputStream());
            return;
        }
        buffer.write(copyBuffer, 0, readLen);
    }

    byte[] responseBodyBytes = buffer.toByteArray();
    // 关键步骤:把读到的字节数组包装成新的流,重置回响应上下文,保证下游业务能正常读取实体
    response.setEntityStream(new ByteArrayInputStream(responseBodyBytes));
    // 将原始响应字节存入EhCache,保证缓存内容和真实响应完全一致
    ehcache.getClientCache().put(cacheKey, responseBodyBytes);
}

请求过滤器适配调整

因为现在缓存存的是原始响应字节,缓存命中时直接将字节作为响应实体返回即可,和你现有代码的逻辑完全兼容,只需要适配实体类型的处理:

// 缓存命中分支逻辑
if (cacheValue != null) {
    System.out.println("命中缓存,直接返回响应");
    Response cachedResponse = Response.ok(cacheValue)
            .type(MediaType.APPLICATION_JSON_TYPE)
            .build();
    request.abortWith(cachedResponse);
}

实现注意事项

  • 流重置是核心操作:只要在过滤器中消费了原始实体流,必须通过setEntityStream()方法将可重复读取的新流放回响应上下文,否则会导致下游业务读取到空实体,直接触发异常。
  • 缓存内容优先存原始字节数组:不要在过滤器层提前将实体反序列化成业务Java对象(比如List<Game>),一方面会增加额外的序列化开销,另一方面如果后续调用方需要将实体读成其他类型(比如字符串、文件流),提前反序列化的对象会出现兼容问题。
  • 做好缓存大小阈值控制:避免大体积的响应被读入内存缓存,引发JVM内存溢出问题。
  • 仅对幂等的GET方法做缓存,符合HTTP缓存的通用设计语义,避免非幂等请求被错误缓存。

内容的提问来源于stack exchange,提问作者bojan985

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.04 09:45:00