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
相关产品推荐
相关产品推荐

