Spring Boot 控制 HTTP API 缓存

• Spring Boot 控制 HTTP缓存
• 缓存协商机制
• 轮子使用
• 缓存问题
  • 浏览器缓存 问题
  • 代理缓存 问题

Spring Boot 控制 HTTP缓存

HTTP协议的缓存策略可以缩短网页请求资源的距离，减少延迟，节省网络流量，并且由于缓存文件可以重复利用，降低网络负荷，加快客户端响应。

如何利用 HTTP缓存 进行一些骚操作呐，是我最近思考的问题。查看了Spring Boot对HTTP缓存的支持也只有org.springframework.web.filter.ShallowEtagHeaderFilter和plus.wcj.heifer.boot.HeiferBootAutoConfiguration#addResourceHandlers这个两个方式能对HTTP缓存进行骚操作，

• org.springframework.web.filter.ShallowEtagHeaderFilter只支持静态资源的缓存协商，看了一下注释说明只节省带宽，而不是服务器性能。
• plus.wcj.heifer.boot.HeiferBootAutoConfiguration#addResourceHandlers可以支持HTTP API，但是不支持RESTful API。

去GitHub寻找一下有没有支持HTTP缓存的轮子，一顿寻找下来颗粒无收，那索性就自己造轮子吧。

缓存协商机制

维护缓存过期网上有很多的文章，这里就不再赘述了，下面列出一些文章
HTTP caching
Prevent unnecessary network requests with the HTTP Cache

因为HTTP协议的版本问题，就采用了HTTP协议1.0的实现了。

1. request
   • If-None-Match
2. response
   • Cache-control
   • ETag

就用以上三个headers来实现缓存协商机制，Cache-control用于控制缓存过期时间，If-None-Match和ETag用于缓存协商，基于上面3个标签我们来实现HTTP缓存和缓存协商吧。

轮子使用

吭哧吭哧2天，轮子已经造好了并且已经发布到maven中央仓库了，这里就略过实现过程了，感兴趣的可以去看一下源码。

githu地址
maven中央库

maven引入，

    <dependency>
        <groupId>plus.wcjgroupId>
        <artifactId>libby-http-cache-controlartifactId>
        <version>2022.1.0version>
    dependency>

一个简单的小DEMO， 访问 /html就会出现一个简单的网页了，然后大家就点击上面的button开始测试吧，

@RestController
@RequestMapping
public class CacheController {
    private Map<String, Long> data = new HashMap<>();

    @GetMapping("cache/{id}")
    @HttpCacheControl(key = "#id",value = "max-age=10, public")
    public Long get(@PathVariable String id) {
        return data.computeIfAbsent(id, s -> System.currentTimeMillis());
    }

    @PostMapping("cache/{id}")
    @HttpETagBind(key = "#id")
    public void post(@PathVariable String id) {
        data.put(id, System.currentTimeMillis());
    }

    @GetMapping("html")
    public ResponseEntity<String> html() {
        return ResponseEntity
                .ok()
                .body("get cache1get cache2modify cache1modify cache2
start test
");
    }
}

缓存问题

因为HTTP协议只是一个规范，所以不同的客户端和代理服务对HTTP实现各不相同，不同的客户端+代理服务的组合会出现不同的缓存效果。

浏览器缓存 问题

测试的时候建议使用多个浏览器进行测试，对于没有实现 HTTP缓存标准 的发包工具，是不会去维护Cache-control、If-None-Match、ETag等缓存标签。

如果你的 API设计风格 RESTful风格，浏览器（Chrome、firefox）会帮你维护If-None-Match标签。

1. GET cache/{id}
2. POST cache/{id}
3. GET cache/{id}

浏览器会在步骤2删除本地缓存，那么步骤3的If-None-Match就不会传输了。

总结 Chrome、firefox对HTTP缓存的实现是最标准的，API发包工具不维护HTTP缓存，

代理缓存 问题

在进行缓存测试的发现一个Nginx、Apache APISIX、Spring Cloud Gateway等等网关的一些小问题。

CacheControl: max-age=10, public，从理论上来说public应该让代理服务把数据缓存在本地（有些网关需要增加配置才能开启 代理缓存），但是不同的网关对HTTP缓存实现的不同，会表现不同的行为。

如果使用了(共享)代理缓存请配合 运维兄弟 多多测试。
如果使用了(共享)代理缓存请配合 运维兄弟 多多测试。
如果使用了(共享)代理缓存请配合 运维兄弟 多多测试。