dispatcher元素
2.4版本的servlet规范在部属描述符中新增加了一个<dispatcher>
元素,这个元素有四个可能的值:即REQUEST,FORWARD,INCLUDE和ERROR,可以在一个<filter-mapping>
元素中加入任意数目的<dispatcher>
,使得filter将会作用于直接从客户端过来的request(REQUEST),通过forward过来的request(FORWARD),通过include过来的request(INCLUDE)和通过<error-page>
过来的request(ERROR)。如果没有指定任何< dispatcher >
元素,默认值是REQUEST。
注意:<dispatcher></dispatcher>
必须写在filter-mapping的最后。dispatcher的前提条件当然是要先满足url-pattern,然后dispatcher有四种可能的属性:
1、REQUEST
只要发起的操作是一次HTTP请求,比如请求某个URL、发起了一个GET请求、表单提交方式为POST的POST请求、表单提交方式为GET的GET请求。一次重定向则前后相当于发起了两次请求,这些情况下有几次请求就会走几次指定过滤器。
2、FOWARD只有当当前页面是通过请求转发转发过来的情形时,才会走指定的过滤器
3、INCLUDE只要是通过<jsp:include page="xxx.jsp" />
,嵌入进来的页面,每嵌入的一个页面,都会走一次指定的过滤器。
<error-page></error-page>
:
<error-page>
<error-code>400</error-code>
<location>/filter/error.jsp</location>
</error-page>
<error-page>
<error-code>404</error-code>
<location>/filter/error.jsp</location>
</error-page>
<error-page>
<error-code>500</error-code>
<location>/filter/error.jsp</location>
</error-page>
意思是HTTP请求响应的状态码只要是400、404、500三种状态码之一,容器就会将请求转发到error.jsp下,这就触发了一次error,走进了配置的DispatchFilter。需要注意的是注意一点的是,虽然把请求转发到error.jsp是一次forward的过程,但是配置成<dispatcher>FORWARD</dispatcher>
并不会走DispatchFilter这个过滤器。
这四种dispatcher方式可以单独使用,也可以组合使用,配置多个<dispatcher></dispatcher>
即可。