web.xml中的url-pattern

最新推荐文章于 2025-10-10 14:49:05 发布

转载最新推荐文章于 2025-10-10 14:49:05 发布 · 5.4k 阅读

文章标签：

#url-pattern #web.xml

java web 专栏收录该内容

41 篇文章

订阅专栏

本文详细解析了web.xml文件中Servlet与Filter的URL匹配规则，包括精确匹配、路径匹配、扩展名匹配及缺省匹配等，阐述了各种匹配方式的特点及优先级。

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中的 url-pattern

Servlet 2.5开始，一个servlet可以使用多个url-pattern规则，标签声明了与该servlet相应的匹配规则，每个标签代表1个匹配规则；
当servlet容器接收到浏览器发起的一个url请求后，容器会用url减去当前应用的上下文路径，以剩余的字符串作为servlet映射，假如url是http://localhost:8080/appDemo/index.html，其应用上下文是appDemo，容器会将http://localhost:8080/appDemo去掉，用剩下的/index.html部分拿来做servlet的映射匹配；
url-pattern映射匹配过程是有 优先顺序 的，而且当有一个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，但优先级最低。
“/*”和“/”均会拦截静态资源的加载，需要特别注意。

Filter中的 url-pattern

其实上面已经把url-pattern 规则都讲完了。
对于filter，不会像servlet 那样只匹配一个servlet，因为filter的集合是一个链，所以只会有处理的顺序不同，而不会出现只选择一个filter。Filter的处理顺序和filter-mapping在web.xml中定义的顺序相同。

本博文参考了 servlet的url-pattern匹配规则