servlet的url-pattern匹配规则

叁歲伎倆 2022-05-26 12:41 161阅读 0赞

来自https://www.cnblogs.com/canger/p/6084846.html

首先需要明确几容易混淆的规则： 
 
 
servlet容器中的匹配规则既不是简单的通配，也不是正则表达式，而是特定的规则。所以不要用通配符或者正则表达式的匹配规则来看待servlet的url-pattern。 
Servlet 2.5开始，一个servlet可以使用多个url-pattern规则，<servlet-mapping>标签声明了与该servlet相应的匹配规则，每个<url-pattern>标签代表1个匹配规则； 
当servlet容器接收到浏览器发起的一个url请求后，容器会用url减去当前应用的上下文路径，以剩余的字符串作为servlet映射，假如url是http://localhost:8080/appDemo/index.html，其应用上下文是appDemo，容器会将http://localhost:8080/appDemo去掉，用剩下的/index.html部分拿来做servlet的映射匹配 
url-pattern映射匹配过程是有优先顺序的 
而且当有一个servlet匹配成功以后，就不会去理会剩下的servlet了。 
一、四种匹配规则 
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/user/addUser/ 是非法的url，不会被当作http://localhost:8080/appDemo/user/addUser识别 
 
 
　　另外上述url后面可以跟任意的查询条件，都会被匹配，如 
 
 
　　http://localhost:8080/appDemo/user/addUser?username=Tom&age=23 会被匹配到MyServlet。 
 
 
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 
 
 
  
 
 
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 
 
 
4 缺省匹配 
　　 
 
 
<servlet-mapping> 
    <servlet-name>MyServlet</servlet-name> 
    <url-pattern>/</url-pattern> 
</servlet-mapping> 
  
 
 
二、匹配顺序 
精确匹配，servlet-mapping1：<url-pattern>/user/users.html</url-pattern>，servlet-mapping2：<url-pattern>/\*</url-pattern>。当一个请求http://localhost:8080/appDemo/user/users.html来的时候，servlet-mapping1匹配到，不再用servlet-mapping2匹配 
路径匹配，先最长路径匹配，再最短路径匹配servlet-mapping1：<url-pattern>/user/\*</url-pattern>，servlet-mapping2：<url-pattern>/\*</url-pattern>。当一个请求http://localhost:8080/appDemo/user/users.html来的时候，servlet-mapping1匹配到，不再用servlet-mapping2匹配 
扩展名匹配，servlet-mapping1：<url-pattern>/user/\*</url-pattern>，servlet-mapping2：<url-pattern>\*.action</url-pattern>。当一个请求http://localhost:8080/appDemo/user/addUser.action来的时候，servlet-mapping1匹配到，不再用servlet-mapping2匹配 
缺省匹配，以上都找不到servlet，就用默认的servlet，配置为<url-pattern>/</url-pattern> 
三、需要注意的问题 
1 路径匹配和扩展名匹配无法同时设置 
　　匹配方法只有三种，要么是路径匹配（以“/”字符开头，并以“/\*”结尾），要么是扩展名匹配（以“\*.”开头），要么是精确匹配，三种匹配方法不能进行组合，不要想当然使用通配符或正则规则。 
 
 
　　如<url-pattern>/user/\*.action</url-pattern>是非法的 
 
 
　　另外注意：<url-pattern>/aa/\*/bb</url-pattern>是精确匹配，合法，这里的\*不是通配的含义 
 
 
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在%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> 
        <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>default</servlet-name> 
        <url-pattern>/</url-pattern> 
</servlet-mapping> 
 
 
     
<servlet-mapping> 
        <servlet-name>jsp</servlet-name> 
        <url-pattern>\*.jsp</url-pattern> 
        <url-pattern>\*.jspx</url-pattern> 
</servlet-mapping> 
复制代码 
  
 
 
可以阅读http://stackoverflow.com/questions/4140448/difference-between-and-in-servlet-mapping-url-pattern 
“/\*”和“/”均会拦截静态资源的加载，需要特别注意 
  
 
 
四、举例

<table style="border:1px solid #C0C0C0;color:rgb(0,0,0);font-family:'微软雅黑', PTSans, Arial, sans-serif;font-size:15px;height:199px;width:397px;float:left;background-color:rgb(248,248,255);"> 
 <tbody> 
 <tr> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">映射的URL</td> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">对应的Servlet</td> 
 </tr> 
 <tr> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">/hello</td> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">servlet1</td> 
 </tr> 
 <tr> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">/bbs/admin/*</td> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">servlet2</td> 
 </tr> 
 <tr> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">/bbs/*</td> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">servlet3</td> 
 </tr> 
 <tr> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">*.jsp</td> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">servlet4</td> 
 </tr> 
 <tr> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">/</td> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">servlet5</td> 
 </tr> 
 </tbody> 
</table>

实际请求映射的结果

<table style="border:1px solid #C0C0C0;color:rgb(0,0,0);font-family:'微软雅黑', PTSans, Arial, sans-serif;font-size:15px;width:361px;background-color:rgb(255,250,205);"> 
 <tbody> 
 <tr> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">去掉上下文路径的剩余路径</td> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">处理请求的Servlet</td> 
 </tr> 
 <tr> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">/hello</td> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">servlet1</td> 
 </tr> 
 <tr> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">/bbs/admin/login</td> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">servlet2</td> 
 </tr> 
 <tr> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">/bbs/admin/index.jsp</td> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">servlet2</td> 
 </tr> 
 <tr> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">/bbs/display</td> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">servlet3</td> 
 </tr> 
 <tr> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">/bbs/index.jsp</td> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">servlet3</td> 
 </tr> 
 <tr> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">/bbs</td> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">servlet3</td> 
 </tr> 
 <tr> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">/index.jsp</td> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">servler4</td> 
 </tr> 
 <tr> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">/hello/index.jsp</td> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">servlet4</td> 
 </tr> 
 <tr> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">/hello/index.html</td> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">servlet5</td> 
 </tr> 
 <tr> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">/news</td> 
 <td style="border-color:#C0C0C0;border-collapse:collapse;padding:3px;">servlet5</td> 
 </tr> 
 </tbody> 
</table>