servlet的url-pattern匹配规则

 目录

​​1 url-pattern匹配规则说明​​

​​2 四种匹配规则优先顺序​​

​​2.1 精确匹配​​

​​2.2 路径匹配​​

​​2.3 扩展名匹配​​

​​2.4 缺省匹配​​

​​3 需要注意的问题​​

​​3.1 路径匹配和扩展名匹配无法同时设置​​

​​3.2  "/*"和"/"含义并不相同​​

​​3.3 tomcat默认配置的servlet​​

​​4 举例​​

​​5、其它参考文献​​

1 url-pattern匹配规则说明

1. servlet容器中的匹配规则既不是简单的通配，也不是正则表达式，而是特定的规则。所以不要用通配符或者正则表达式的匹配规则来看待servlet的url-pattern。
2. Servlet 2.5开始，一个servlet可以使用多个url-pattern规则，<servlet-mapping>标签声明了与该servlet相应的匹配规则，每个<url-pattern>标签代表1个匹配规则；
3. 当servlet容器接收到浏览器发起的一个url请求后，容器会用url减去当前应用的上下文路径，以剩余的字符串作为servlet映射，假如url是http://localhost:8080/appDemo/index.html，其应用上下文是appDemo，容器会将http://localhost:8080/appDemo去掉，用剩下的/index.html部分拿来做servlet的映射匹配
4. url-pattern映射匹配过程是有优先顺序的，后面详细说明。
5. 而且当有一个servlet匹配成功以后，就不会去理会剩下的servlet了。

2 四种匹配规则优先顺序

1精确匹配 > 2 路径匹配 > 3 扩展名匹配 > 4 缺省匹配

2.1 精确匹配

<url-pattern>中配置的项必须与url完全精确匹配。

<servlet-mapping>
    <servlet-name>MyServlet</servlet-name>
    <url-pattern>/user/users.html</url-pattern>
    <url-pattern>/index.html</url-pattern>
    <url-pattern>/user/addUser.action</url-pattern>
</servlet-mapping>

　　当在浏览器中输入如下几种url时，都会被匹配到该servlet
​​​ 　　http://localhost:8080/appDemo/user/users.html​​​ 　　http://localhost:8080/appDemo/index.html
　　http://localhost:8080/appDemo/user/addUser.action

　　注意：

• 空串属于精确匹配，只匹配项目根路径  http://localhost:8080/appDemo/  或 http://localhost:8080/appDemo
• http://localhost:8080/appDemo/user/addUser/ 是非法的url，不会被当作http://localhost:8080/appDemo/user/addUser识别
• 另外上述url后面可以跟任意的查询条件，都会被匹配，如 http://localhost:8080/appDemo/user/addUser?username=Tom&age=23 会被匹配到MyServlet。

2.2 路径匹配

　　以“/”字符开头，并以“/*”结尾的字符串用于路径匹配

<servlet-mapping>
    <servlet-name>MyServlet</servlet-name>
    <url-pattern>/user/*</url-pattern>
</servlet-mapping>

　　路径以/user/开始，后面的路径可以任意。比如下面的url都会被匹配。
​​​ 　　http://localhost:8080/appDemo/user/users.html​​​ 　　http://localhost:8080/appDemo/user/addUser.action
　　http://localhost:8080/appDemo/user/updateUser.actionl

2.3 扩展名匹配

　　以“*.”开头的字符串被用于扩展名匹配

<servlet-mapping>
    <servlet-name>MyServlet</servlet-name>
    <url-pattern>*.jsp</url-pattern>
    <url-pattern>*.action</url-pattern>
</servlet-mapping>

　　则任何扩展名为jsp或action的url请求都会匹配，比如下面的url都会被匹配
​​​ 　　http://localhost:8080/appDemo/user/users.jsp​​ 　　http://localhost:8080/appDemo/toHome.action

2.4 缺省匹配

<servlet-mapping>
    <servlet-name>MyServlet</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

3 需要注意的问题

3.1 路径匹配和扩展名匹配无法同时设置

　　匹配方法只有三种，要么是路径匹配（以“/”字符开头，并以“/*”结尾），要么是扩展名匹配（以“*.”开头），要么是精确匹配，三种匹配方法不能进行组合，不要想当然使用通配符或正则规则。

如<url-pattern>/user/*.action</url-pattern>是非法的

　　另外注意：<url-pattern>/aa/*/bb</url-pattern>是精确匹配，合法，这里的*不是通配的含义

3.2  "/*"和"/"含义并不相同

• “/*”属于路径匹配，并且可以匹配所有request，由于路径匹配的优先级仅次于精确匹配，所以“/*”会覆盖所有的扩展名匹配，很多404错误均由此引起，所以这是一种特别恶劣的匹配模式，一般只用于filter的url-pattern
• “/”是servlet中特殊的匹配模式，切该模式有且仅有一个实例，优先级最低，不会覆盖其他任何url-pattern，只是会替换servlet容器的内建default servlet ，该模式同样会匹配所有request。
• 配置“/”后，一种可能的现象是myServlet会拦截诸如http://localhost:8080/appDemo/user/addUser.action、http://localhost:8080/appDemo/user/updateUser的格式的请求，但是并不会拦截http://localhost:8080/appDemo/user/users.jsp、http://localhost:8080/appDemo/index.jsp，这是应为servlet容器有内置的“*.jsp”匹配器，而扩展名匹配的优先级高于缺省匹配，所以才会有上述现象。
• tomcat 默认情况 “/*”是拦截所有请求，“/”拦截除了“.jsp”、“.jspx”的所有请求，原因见【 3.3tomcat默认配置的servlet】。而SpringMVC的DispatcherServlet配置的正式“/”，拦截了除了jsp、jspx以外的所有请求，把静态资源html、css都拦截了

3.3 tomcat默认配置的servlet

Tomcat在%CATALINA_HOME%\conf\web.xml文件中配置了默认的Servlet，配置代码如下，

<servlet>
        <servlet-name>default</servlet-name>
        <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
        <init-param>
            <param-name>debug</param-name>
            <param-value>0</param-value>
        </init-param>
        <init-param>
            <param-name>listings</param-name>
            <param-value>false</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>default</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

    <servlet>
        <servlet-name>jsp</servlet-name>
        <servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class>
        <init-param>
            <param-name>fork</param-name>
            <param-value>false</param-value>
        </init-param>
        <init-param>
            <param-name>xpoweredBy</param-name>
            <param-value>false</param-value>
        </init-param>
        <load-on-startup>3</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>jsp</servlet-name>
        <url-pattern>*.jsp</url-pattern>
        <url-pattern>*.jspx</url-pattern>
    </servlet-mapping>

4 举例

实际请求映射的结果

5、其它参考文献

​​Servlet的历史与规范_「有且仅有」_servlet规范一、Servlet历史1. Servlet的由来背景 上世纪90年代，随着Internet和浏览器的飞速发展，基于浏览器的B/S模式随之火爆发展起来。 最初，用户使用浏览器向WEB服务器发送的请求都是请求静态的资源，比如html、css等。 但是可以想象：根据用户请求的不同动态的处理并返回资源是理所当然必须的要求。CGI 必须要满足上述需求，所以CGI

​​servlet的url-pattern匹配规则 - canger -首先需要明确几容易混淆的规则： 一、四种匹配规则 1 精确匹配 <url-pattern>中配置的项必须与url完全精确匹配。 当在浏览器中输入如下几种url时，都会被匹配到该