转自 http://www.cnblogs.com/daxin/p/3995287.html
【简介】
ExpiresFilter是Java servlet API 当中的一部分,它负责控制设置response当中的响应头(Expires
) 和 ( Cache-Control的max-age
),过期时间可以设置为相对于源文件的最后修改时间,或者浏览器的访问时间。
这些响应头指示浏览器控制文档的缓存,如果使用了缓存,那么浏览器在下一次获取文档(HTML)的时候就会从本地缓存中获取,而不是访问实际的资源服务器,除非超过失效时间。关于HTTP头控制客户端缓存的更多介绍请参见我的另外一篇文章,http://www.cnblogs.com/daxin/p/3981553.html或者可以直接查阅HTTP协议(see RFC 2616 section 14.9)。
【例子】
Basic configuration to add 'Expires
' and 'Cache-Control: max-age=
' headers to images, css and javascript.
下面的例子针对所有的 IMAGE CSS JAVASCRIPT 输出进行控制,添加HTTP头设置客户端缓存。
<filter>
<filter-name>ExpiresFilter</filter-name>
<filter-class>org.apache.catalina.filters.ExpiresFilter</filter-class>
<init-param>
<param-name>ExpiresByType image</param-name>
<param-value>access plus 10 minutes</param-value>
</init-param>
<init-param>
<param-name>ExpiresByType text/css</param-name>
<param-value>access plus 10 minutes</param-value>
</init-param>
<init-param>
<param-name>ExpiresByType application/javascript</param-name>
<param-value>access plus 10 minutes</param-value>
</init-param>
</filter>
...
<filter-mapping>
<filter-name>ExpiresFilter</filter-name>
<url-pattern>/*</url-pattern>
<dispatcher>REQUEST</dispatcher>
</filter-mapping>
【语法介绍】
<init-param>
<param-name>ExpiresDefault</param-name>
<param-value><base> [plus] {<num> <type>}*</param-value>
</init-param>
<init-param>
<param-name>ExpiresByType type</param-name>
<param-value><base> [plus] {<num> <type>}*</param-value>
</init-param>
<init-param>
<param-name>ExpiresByType type;encoding</param-name>
<param-value><base> [plus] {<num> <type>}*</param-value>
</init-param>
2.4版本的servlet规范在部属描述符中新增加了一个<dispatcher>元素,这个元素有四个可能的值:即REQUEST,FORWARD,INCLUDE和ERROR,
可以在一个<filter-mapping>元素中加入任意数目的<dispatcher>,使得filter将会作用于直接从客户端过来的request,通过forward过来的request,通过include过来的request和通过<error-page>过来的request。
如果没有指定任何< dispatcher >元素,默认值是REQUEST。
RequestDispatcher提供两个方法forward和include区别
都表示要跳转到其他资源,不同的是,如果使用forward跳转则后面的response输出则不会执行,
而用include来跳转,则include的servlet执行完后,再返回到原来的servlet执行response的输出(如果有)。
base可以设置为:
access 访问时间。
now
(equivalent to 'access
') 当前时间,相当于访问时间。modification 文件的最后修改时间。
plus的值是可选的,可以不填,没什么意义。
num必须是一个integer。
type的值可以设置为:不一一解释了一看就明白了。
years
months
weeks
days
hours
minutes
seconds
下面的例子设置所有的MIME类型的输出被客户端缓存一个月,即缓存过期时间为一个月。ExpiresDefault代表所有的MIME类型 比如 text/plain image/png application/javascript等等。
<init-param>
<param-name>ExpiresDefault</param-name>
<param-value>access plus 1 month</param-value>
</init-param>
<init-param>
<param-name>ExpiresDefault</param-name>
<param-value>access plus 4 weeks</param-value>
</init-param>
<init-param>
<param-name>ExpiresDefault</param-name>
<param-value>access plus 30 days</param-value>
</init-param>
过期时间还可以使用子句进行调整,例如:
<init-param>
<param-name>ExpiresByType text/html</param-name>
<param-value>access plus 1 month 15 days 2 hours</param-value> //缓存到期时间设置为当前时间 加上 1个月 15天 2小时
</init-param>
<init-param>
<param-name>ExpiresByType image/gif</param-name>
<param-value>modification plus 5 hours 3 minutes</param-value> //缓存到期时间设置为文件的修改时间 加上 5小时 3分钟
</init-param>
【什么样的情况response会被设置缓存头】
1、no expiration header is defined (Expires
header or the max-age
directive of the Cache-Control
header)
也就是说这俩个响应头没有被定义情况过滤器才会设置,如果我们已经设置了该响应头,那么就不会再重复设置了。
2、the response status code is not excluded by the directive ExpiresExcludedResponseStatusCodes
response的status没有包含在ExpiresExcludedResponseStatusCodes这个属性的配置当中。
这个属性可以在web.xml当中配置过滤器当中配置,定义哪些状态吗不需要设置缓存头,默认304的时候就不会被设置。
3、根据ExpiresByType
指定的 Content-Type 或者 使用了ExpiresDefault