web.xml里的filter-mapping 中的dispatcher

关键字: xml里<filter-mapping>中的<dispatcher>作用

2.4版本的servlet规范在部属描述符中新增加了一个<dispatcher>元素，这个元素有四个可能的值：即REQUEST,FORWARD,INCLUDE和ERROR，可以在一个<filter-mapping>元素中加入任意数目的<dispatcher>，使得filter将会作用于直接从客户端过来的request，通过forward过来的request，通过include过来的request和通过<error-page>过来的request。如果没有指定任何< dispatcher >元素，默认值是REQUEST。可以通过下面几个例子来辅助理解。
例1：

Xml代码

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

<filter-mapping> 
<filter-name>Logging Filter</filter-name> 
<url-pattern>/products/*</url-pattern> 
</filter-mapping>

 

这种情况下，过滤器将会作用于直接从客户端发过来的以/products/…开始的请求。因为这里没有制定任何的< dispatcher >元素，默认值是REQUEST。

例2：

Xml代码

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

<filter-mapping> 
<filter-name>Logging Filter</filter-name> 
<servlet-name>ProductServlet</servlet-name> 
<dispatcher>INCLUDE</dispatcher> 
</filter-mapping> 

这种情况下，如果请求是通过request dispatcher的include方法传递过来的对ProductServlet的请求，则要经过这个过滤器的过滤。其它的诸如从客户端直接过来的对ProductServlet的请求等都不需要经过这个过滤器。
指定filter的匹配方式有两种方法：直接指定url-pattern和指定servlet，后者相当于把指定的servlet对应的url-pattern作为filter的匹配模式
filter的路径匹配和servlet是一样的，都遵循servlet规范中《SRV.11.2 Specification of Mappings》一节的说明

例3：

Xml代码

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>   

<filter-mapping> 
<filter-name>Logging Filter</filter-name> 
<url-pattern>/products/*</url-pattern> 
<dispatcher>FORWARD</dispatcher> 
<dispatcher>REQUEST</dispatcher> 
</filter-mapping> 

 

在这种情况下，如果请求是以/products/…开头的，并且是通过request dispatcher的forward方法传递过来或者直接从客户端传递过来的，则必须经过这个过滤器。

我项目中配置urlrewrite的时候 由于在struts中配置的过滤器为默认的

<filter-name>
            struts2
        </filter-name>
        <url-pattern>
            /*
        </url-pattern>
</filter-name>

 

没有加
        <dispatcher>FORWARD</dispatcher>
     <dispatcher>INCLUDE</dispatcher>
     <dispatcher>REQUEST</dispatcher>

 

而我的urlrewrite的时候用的方式是forword因此那个filter接收不到那个请求

<rule>
      <note>
       Resource Details Part Rule from /resourceAction/subjectDetail/6
                  to /resourceAction/subjectDetail.action?language=en_US&resID=6
      </note>
     <from>^/resourceAction/([a-zA-Z0-9 ]+).html$</from>
     <to type="redirect">resourceAction/subjectDetail.action?language=zh_CN &amp; resID=$1</to>

</rule>

只要加上<dispatcher>FORWARD</dispatcher>即可.