web.xml
文件中,url-pattern
有两种,一种是Servlet
的,一种是Filter
的。常见的用法如下:
<filter>
<filter-name>characterEncodingFilter</filter-name>
<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
<init-param>
<param-name>forceEncoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>characterEncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<servlet>
<servlet-name>Spring</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!-- 表示启动容器时初始化该servlet -->
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:Spring-servlet.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>Spring</servlet-name>
<!-- 表示哪些请求需要交给Spring Web MVC处理,/是用来定义默认servlet映射的。也可以如“*.html”表示拦截所有以html为扩展名的请求 -->
<url-pattern>/</url-pattern>
</servlet-mapping>
下面来一个个分析这些url的使用场景吧。
Servlet 2.5
开始,一个servlet可以使用多个url-pattern规则,标签声明了与该servlet相应的匹配规则,每个标签代表1个匹配规则;http://localhost:8080/appDemo/index.html
,其应用上下文是appDemo
,容器会将http://localhost:8080/appDemo
去掉,用剩下的/index.html
部分拿来做servlet的映射匹配;优先顺序
的,而且当有一个servlet匹配成功以后,就不会去理会剩下的servlet了。这里主要值得分析的是第三点,即优先顺序
。在这之前,看看有哪些匹配规则。
url-pattern
中配置的项必须与 url
完全精确匹配。例如:
<servlet-mapping>
<servlet-name>MyServlet</servlet-name>
<url-pattern>/user/users.html</url-pattern>
<url-pattern>/index.html</url-pattern>
</servlet-mapping>
http://localhost:8080/appDemo/index.html
会被匹配到MyServlet
。
以“/”
字符开头,并以“/*”
结尾的字符串用于路径匹配。例如:
<servlet-mapping>
<servlet-name>MyServlet</servlet-name>
<url-pattern>/user/*</url-pattern>
</servlet-mapping>
路径以/user/
开始,后面的路径可以任意。比如 http://localhost:8080/appDemo/user/users.html
。
以“*.”
开头的字符串被用于扩展名匹配。例如:
<servlet-mapping>
<servlet-name>MyServlet</servlet-name>
<url-pattern>*.html</url-pattern>
</servlet-mapping>
则任何扩展名为html
的url请求都会匹配,比如 http://localhost:8080/appDemo/user/users.html
注意: 如<url-pattern>/user/*.action</url-pattern>
是非法的。路径匹配和扩展匹配不能同时使用。
另外,<url-pattern>/aa/*/bb</url-pattern>
是精确匹配,合法,这里的*不是通配的含义
<servlet-mapping>
<servlet-name>MyServlet</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
精确匹配 > 路径匹配 > 扩展名匹配 > 缺省匹配
,只要前面有一个匹配成功,就匹配结束。
"/*"
和"/"
比较“/*”
属于路径匹配
,并且可以匹配所有request,由于路径匹配的优先级仅次于精确匹配,所以“/*”会覆盖所有的扩展名匹配,很多404错误均由此引起,所以这是一种特别恶劣的匹配模式,一般只用于filter的url-pattern。“/”
是servlet中特殊的匹配模式,该模式同样会 匹配所有request,但优先级最低。“/*”
和“/”
均会拦截静态资源的加载,需要特别注意。其实上面已经把url-pattern
规则都讲完了。
对于filter
,不会像servlet
那样只匹配一个servlet,因为filter的集合是一个链,所以只会有处理的顺序不同,而不会出现只选择一个filter。Filter的处理顺序和filter-mapping在web.xml中定义的顺序相同。
本博文参考了 servlet的url-pattern匹配规则