servlet的url-pattern匹配規則
首先需要明確幾容易混淆的規則:
- servlet容器中的匹配規則既不是簡單的通配,也不是正則表達式,而是特定的規則。所以不要用通配符或者正則表達式的匹配規則來看待servlet的url-pattern。
- Servlet 2.5開始,一個servlet可以使用多個url-pattern規則,標籤聲明瞭與該servlet相應的匹配規則,每個標籤代表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完全精確匹配。
<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.action/ 是非法的url,不會被當作http: //localhost:8080/appDemo/user/addUser.action識別
另外上述url後面可以跟任意的查詢條件,都會被匹配,如
http: //localhost:8080/appDemo/user/addUser.action?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:/user/users.html,servlet-mapping2:/*。當一個請求http: //localhost:8080/appDemo/user/users.html來的時候,servlet-mapping1匹配到,不再用servlet-mapping2匹配
- 路徑匹配,先最長路徑匹配,再最短路徑匹配servlet-mapping1:/user/,servlet-mapping2:/。當一個請求http: //localhost:8080/appDemo/user/users.html來的時候,servlet-mapping1匹配到,不再用servlet-mapping2匹配
- 擴展名匹配,servlet-mapping1:/user/,servlet-mapping2:.action。當一個請求http: //localhost:8080/appDemo/user/addUser.action來的時候,servlet-mapping1匹配到,不再用servlet-mapping2匹配
- 缺省匹配,以上都找不到servlet,就用默認的servlet,配置爲/
三、需要注意的問題
1 路徑匹配和擴展名匹配無法同時設置
匹配方法只有三種,要麼是路徑匹配(以“/”字符開頭,並以“/*”結尾),要麼是擴展名匹配(以“*.”開頭),要麼是精確匹配,三種匹配方法不能進行組合,不要想當然使用通配符或正則規則。
如/user/*.action是非法的
另外注意:/aa//bb是精確匹配,合法,這裏的不是通配的含義
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”匹配器,而擴展名匹配的優先級高於缺省匹配,所以纔會有上述現象。
四、舉例
映射的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 |
五、優先順序
當一個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。