Servlet 、Filter 的url-pattern

url-pattern

在web.xml中< servlet-mapping > 、< filter-mapping >中都需要配置< url-pattern >，他们的作用都是用于匹配一次请求是否会执行这个Servlet或Filter。

url-pattern 何时匹配

• Servlet的匹配： 一个请求最终被分配到一个Servlet，是由org.apache.tomcat.util.http.Mapper类完成，这个类会根据请求的URL 来匹配 每个Servlet中配置的< url-pattern >，所以，一个请求被创建时就已经匹配完成了
• Filter 的 匹 配： Filter对< url-pattern >的匹配是在创建ApplicationFilterChain对象时进行的，该对象会把所有定义并注册的 Filter的< url-pattern >与当前请求的URL 匹配。如果匹配成功就将这个Filter保存到ApplicationFilterChain 的 filters 数组中，然后再FilterChain中依次调用

url-pattern 检查规则

在web.xml 加载时，会首先检查< url-pattern >配置是否符合规则，这个检查是在StandardContext （Servlet在Tomcat中的包装类StandardWrapper的直接容器） 的validateURLPattern方法中检查的，如果检查不成功，StandardContext容器会启动失败，并报出java.lang.IllegalArgumentException:Invalid< url-pattern >/a/*.htm in Servlet mapping 错误

< url-pattern >的解析规则，对Servlet和Filter都是一样的：

• 精确匹配： 例如 /hello.html 只会匹配hello.html 这个URL
• 路径匹配： 例如 /hello/* 会匹配以hello为前缀的URL

• 后缀匹配： 例如 *.html 会匹配所有以.html为后缀的URL

  注意：< url-pattern >的其他写法（如 /hello/ 、/.html 、 /hello ）都是错误的

Servlet与Filter匹配的不同

• Servlet ： Servlet的匹配原则定义在org.apache.tomcat.util.http.mapper.Mapper.internalMapWrapper中。对于Servlet来说，如果同时定义了多个< url-pattern >，那么匹配会按照以下原则：（1）、首先进行 精确匹配 ，如web.xml中定义了两个Servlet，Servlet1的< url-pattern >为/hello.html，Servlet2的< url-pattern >为/* ，请求的URL为http:localhost:8080/hello.html，那么只有Servlet1匹配成功；如果精确匹配失败，则使用第二个原则 （2）、最长路径匹配，如Servlet2为/*，Servlet3为/hello/hello.html，请求的URL为http:localhost:8080/hello/hello.html，则Servlet3匹配成功；如果（1）（2）均未匹配到一个Servlet，则最后进行（3）、后缀匹配

  注意：一次请求只会成功匹配到一个Servlet

• Filter ： Filter的匹配原则定义在ApplicationFilterFactory.matchFiltersURL方法中。Filter的匹配与Servlet有些不同，只要Filter的< url-pattern >与URL匹配成功，这些Filter都会在请求链上被调用

参考：《深入分析java web 技术内幕》