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 技术内幕》