1. 程式人生 > >web.xml裏<filter-mapping>中的<dispatcher>作用

web.xml裏<filter-mapping>中的<dispatcher>作用

沒有 style targe mapping filter ntc 默認 請求 map

轉自:http://hintcnuie.iteye.com/blog/226251/

2.4版本的servlet規範在部屬描述符中新增加了一個<dispatcher>元素,這個元素有四個可能的值:即REQUEST,FORWARD,INCLUDE和ERROR,可以在一個<filter-mapping>元素中加入任意數目的<dispatcher>,使得filter將會作用於直接從客戶端過來的request,通過forward過來的request,通過include過來的request和通過<error-page>過來的request。如果沒有指定任何< dispatcher >元素,默認值是REQUEST。可以通過下面幾個例子來輔助理解。

1 <filter-mapping>   
2 <filter-name>Logging Filter</filter-name>   
3 <url-pattern>/products/*</url-pattern>   
4 </filter-mapping>

這種情況下,過濾器將會作用於直接從客戶端發過來的以/products/…開始的請求。因為這裏沒有制定任何的< dispatcher >元素,默認值是REQUEST。

1 <filter-mapping>   
2 <filter-name
>Logging Filter</filter-name> 3 <servlet-name>ProductServlet</servlet-name> 4 <dispatcher>INCLUDE</dispatcher> 5 </filter-mapping>

這種情況下,如果請求是通過request dispatcher的include方法傳遞過來的對ProductServlet的請求,則要經過這個過濾器的過濾。其它的諸如從客戶端直接過來的對ProductServlet的請求等都不需要經過這個過濾器。
指定filter的匹配方式有兩種方法:直接指定url-pattern和指定servlet,後者相當於把指定的servlet對應的url-pattern作為filter的匹配模式
filter的路徑匹配和servlet是一樣的,都遵循servlet規範中《SRV.11.2 Specification of Mappings》一節的說明

1 <filter-mapping>   
2 <filter-name>Logging Filter</filter-name>   
3 <url-pattern>/products/*</url-pattern>   
4 <dispatcher>FORWARD</dispatcher>   
5 <dispatcher>REQUEST</dispatcher>   
6 </filter-mapping>   

在這種情況下,如果請求是以/products/…開頭的,並且是通過request dispatcher的forward方法傳遞過來或者直接從客戶端傳遞過來的,則必須經過這個過濾器。

web.xml裏<filter-mapping>中的<dispatcher>作用