servlet的url-pattern匹配規則詳細描述

1、概述

在利用servlet或Filter進行url請求的匹配時，很關鍵的一點就是匹配規則，但servlet容器中的匹配規則既不是簡單的通配，也不是正則表達式，而是由本身的規則，比較容易混淆。本文來詳細舉例介紹下。下面的說明都是在tomcat服務器中獲得驗證的。

先介紹一下匹配的概念，上例子代碼。在一個app（如名字爲myapp）的web.xml文件中，有以下信息：

<servlet>
    <servlet-name>MyServlet</servlet-name>
    <servlet-class>com.nau.MyServlet</servlet-class>
  </servlet>
  
  <servlet-mapping>
    <servlet-name>MyServlet</servlet-name>
    <url-pattern>xxxxxx</url-pattern>
   <url-pattern>yyyyyyy</url-pattern>
  </servlet-mapping>

上面的配置信息，其中<servlet>標籤首先配置聲明一個servlet，包括servlet的名字和對應的java類名。
其中<servlet-mapping>標籤聲明瞭與該servlet相應的匹配規則，每一個<url-pattern>標籤表明1個匹配規則。

當瀏覽器發起一個url請求後，該請求發送到servlet容器的時候，容器先會將請求的url減去當前應用上下文的路徑做爲servlet的映射url，好比url是http://10.43.11.143/myapp/kata/detail.html，其應用上下文是myapp，容器會將http://10.43.11.143/myapp去掉，剩下的/kata/detail.html部分拿來作servlet的映射匹配。這個映射匹配過程是有優先順序的(具體的優先順序規則後面介紹)，並且當有一個servlet匹配成功之後，就不會去理會剩下的servlet了。

注意Filter的匹配規則與servlet同樣，但對於filter，不會像servlet那樣只匹配一個servlet，由於filter的集合是一個鏈，因此只會有處理的順序不一樣，而不會出現只選擇一個filter。Filter的處理順序和filter-mapping在web.xml中定義的順序相同。 

下面咱們詳細介紹各類匹配規則

2、精確匹配

<url-pattern>中配置的項必須與url徹底精確匹配。

如配置信息以下：

<servlet-mapping>
    <servlet-name>MyServlet</servlet-name>
    <url-pattern>/kata/detail.html</url-pattern>
    <url-pattern>/demo.html</url-pattern>
    <url-pattern>/table</url-pattern>
</servlet-mapping>

當在瀏覽器中輸入以下幾種url時，都會被匹配到該servlet
http://10.43.11.143/myapp/kata/detail.html
http://10.43.11.143/myapp/demo.html
http://10.43.11.143/myapp/table

注意：

http://10.43.11.143/myapp/table/ 是非法的url，不會被看成http://10.43.11.143/myapp/table識別

另外上述url後面能夠跟任意的查詢條件，都會被匹配，如

http://10.43.11.143/myapp/table?hello 這個請求就會被匹配到MyServlet。

 

3、擴展名匹配

若是匹配規則以下

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

則任何擴展名爲jsp（文件名和路徑任意）的url請求都會匹配，好比下面的url都會被匹配
http://10.43.11.143/myapp/demo.jsp
http://10.43.11.143/myapp/test.jsp

 

4、路徑匹配

若是匹配規則以下

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

則請求的ulr只要前面（myapp以後）的路徑是/kata，然後面的路徑能夠任意。好比下面的url都會被匹配。
http://10.43.11.143/myapp/kata/demo.html
http://10.43.11.143/myapp/kata/test.jsp
http://10.43.11.143/myapp/kata/test/detail.html

http://10.43.11.143/myapp/kata/action

http://10.43.11.143/myapp/kata/action/

注意：路徑和擴展名匹配沒法同時設置，好比下面的三個<url-pattern>都是非法的，若是設置，啓動tomcat服務器會報錯。

<url-pattern>/kata/*.jsp</url-pattern>

<url-pattern>/*.jsp</url-pattern>

<url-pattern>he*.jsp</url-pattern>

另外注意：<url-pattern>/aa/*/bb</url-pattern>
這個是精確匹配，url必須是 /aa/*/bb，這裏的*不是通配的含義

 

5、匹配任意的url

若是<url-pattern>配置成以下兩種的任意一種

<url-pattern>/</url-pattern>

<url-pattern>/*</url-pattern>

則全部的url均可以被匹配上。其中/*是路徑匹配，只是路徑就是/。

 

6、優先順序

當一個url與多個servlet的匹配規則能夠匹配時，則按照 「 精確路徑 > 最長路徑>擴展名」這樣的優先級匹配到對應的servlet。舉例以下：

例1：好比servletA 的url-pattern爲 /test，servletB的url-pattern爲 /* ，這個時候，若是我訪問的url爲http://localhost/test ，這個時候容器就會先進行精確路徑匹配，發現/test正好被servletA精確匹配，那麼就去調用servletA，不會去管servletB。

例2：好比servletA的url-pattern爲/test/*，而servletB的url-pattern爲/test/a/*，此時訪問http://localhost/test/a時，容器會選擇路徑最長的servlet來匹配，也就是這裏的servletB。 

例3: 好比servletA的url-pattern：*.action ，servletB的url-pattern爲 /* ，這個時候，若是我訪問的url爲http://localhost/test.action，這個時候容器就會優先進行路徑匹配，而不是去匹配擴展名，這樣就去調用servletB。

 

7、小結

本文咱們詳細介紹了servlet的匹配規則。總的來講就是分爲精確、路徑和擴展名三種匹配方式，而且介紹了優先級。