servlet的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了。

一、四種匹配規則

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>

 

二、匹配順序

1. 精確匹配，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匹配
2. 路徑匹配，先最長路徑匹配，再最短路徑匹配servlet-mapping1：<url-pattern>/user/*</url-pattern>，servlet-mapping2：<url-pattern>/*</url-pattern>。當一個請求http://localhost:8080/appDemo/user/users.html來的時候，servlet-mapping1匹配到，不再用servlet-mapping2匹配
3. 擴展名匹配，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匹配
4. 缺省匹配，以上都找不到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>

    <!-- The mappings for the JSP servlet -->
<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
• “/*”和“/”均會攔截靜態資源的加載，需要特別注意

 

四、舉例

映射的URL	對應的Servlet
/hello	servlet1
/bbs/admin/*	servlet2
/bbs/*	servlet3
*.jsp	servlet4
/	servlet5

 

 

 

 

 

 

 

實際請求映射的結果

去掉上下文路徑的剩余路徑	處理請求的Servlet
/hello	servlet1
/bbs/admin/login	servlet2
/bbs/admin/index.jsp	servlet2
/bbs/display	servlet3
/bbs/index.jsp	servlet3
/bbs	servlet3
/index.jsp	servler4
/hello/index.jsp	servlet4
/hello/index.html	servlet5
/news	servlet5