
同 DefaultServlet 一样,ExpiresFilter 也是 Tomcat 里一个非常重要的类。
我们知道 DefaultServlet 可以处理静态资源(HTML,CSS,JS,图片)的请求,并支持缓存。即:能够返回资源的 ETag,并在下次请求时对比资源的 ETag 与请求提交上来的 ETag 值,对比一致则返回 304 状态码,这样避免了资源的重复下载,节省服务器带宽。
但这种机制浏览器还是需要浏览器发起请求,特别是在移动弱网情况下,我们希望充分利用浏览器缓存。
比如:随着前后端分离架构的发展,前端代码可以通过打包工具将打出的文件名带上文件哈希值,例如:http://127.0.0.1:8080/static/js/home.79a114b.js
,那么这样的 URL 就能完全确保文件的唯一性,如果 home.js
这个文件被修改过了,它的哈希值会不一样,自然通过打包工具打出的完整文件名也会变更。
所以,我们希望这种资源,服务器能返回 Cache-Control
一个比较长的时间,让浏览器缓存,下次不发送请求。Tomcat 自带的 ExpiresFilter 就能处理这种问题。
配置和使用
ExpiresFilter 配置同一般的 Filter 一样:
1 | <web-app> |
需要注意这里的 init-param
配置,为的是告诉 ExpiresFilter,哪些类型的资源应该缓存多长时间。如:
1 | <init-param> |
表示 JS 文件缓存 10 分钟。
具体配置格式为:
1 | <init-param> |
base,可设置为:
- access;访问时间
- now;当前时间,相当于访问时间
- modification;文件的最后修改时间
plus,可选的,可以不填,没什么意义。
num,必须是个 int 值。
type,可设置为如下情况,每个值的含义通过单词就能理解了:
- years
- months
- weeks
- days
- hours
- minutes
- seconds
而且 num type
的组合可以有多项,如:
1 | <init-param> |
其它注意事项
如果代码在处理到 ExpiresFilter 前,Response 中已经设置了 Expires、Cache-Control 等头部的话,ExpiresFilter 是不会根据配置的规则再覆盖的,具体实现见源码的 isEligibleToExpirationHeaderGeneration
方法:
1 | protected boolean isEligibleToExpirationHeaderGeneration(HttpServletRequest request, XHttpServletResponse response) { |
参考文章
https://tomcat.apache.org/tomcat-8.0-doc/config/filter.html#Expires_Filter
https://tomcat.apache.org/tomcat-8.0-doc/api/index.html