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、四種匹配規則

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>

 

2、匹配順序

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>

3、須要注意的問題

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
• 「/*」和「/」均會攔截靜態資源的加載，須要特別注意

 

4、舉例

映射的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