当前位置: 首页 > 工具软件 > Pattern Web > 使用案例 >

web.xml中的url-pattern

阎成天
2023-12-01

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匹配规则

 类似资料: