首先需要明確幾容易混淆的規(guī)則:
- servlet容器中的匹配規(guī)則既不是簡(jiǎn)單的通配,也不是正則表達(dá)式,而是特定的規(guī)則。所以不要用通配符或者正則表達(dá)式的匹配規(guī)則來(lái)看待servlet的url-pattern。
- Servlet 2.5開(kāi)始,一個(gè)servlet可以使用多個(gè)url-pattern規(guī)則,<servlet-mapping>標(biāo)簽聲明了與該servlet相應(yīng)的匹配規(guī)則,每個(gè)<url-pattern>標(biāo)簽代表1個(gè)匹配規(guī)則;
- 當(dāng)servlet容器接收到瀏覽器發(fā)起的一個(gè)url請(qǐng)求后,容器會(huì)用url減去當(dāng)前應(yīng)用的上下文路徑,以剩余的字符串作為servlet映射,假如url是http://localhost:8080/appDemo/index.html,其應(yīng)用上下文appDemo,容器會(huì)將http://localhost:8080/appDemo去掉,用剩下的/index.html部分拿來(lái)做servlet的映射匹配
- url-pattern映射匹配過(guò)程是有優(yōu)先順序的,而且當(dāng)有一個(gè)servlet匹配成功以后,就不會(huì)去理會(huì)剩下的servlet了。
四種匹配規(guī)則
- 精確匹配
<url-pattern>中配置的項(xiàng)必須與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>
當(dāng)在瀏覽器中輸入如下幾種url時(shí),都會(huì)被匹配到該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,不會(huì)被當(dāng)作http://localhost:8080/appDemo/user/addUser識(shí)別。
另外上述url后面可以跟任意的查詢條件,都會(huì)被匹配,如http://localhost:8080/appDemo/user/addUser?username=Tom&age=23 會(huì)被匹配到MyServlet。
- 路徑匹配
以“/”字符開(kāi)頭,并以“/*”結(jié)尾的字符串用于路徑匹配
<servlet-mapping>
<servlet-name>MyServlet</servlet-name>
<url-pattern>/user/*</url-pattern>
</servlet-mapping>
路徑以/user/開(kāi)始,后面的路徑可以任意。比如下面的url都會(huì)被匹配。
http://localhost:8080/appDemo/user/users.html
http://localhost:8080/appDemo/user/addUser.action
http://localhost:8080/appDemo/user/updateUser.actionl
3 擴(kuò)展名匹配
以“*.”開(kāi)頭的字符串被用于擴(kuò)展名匹配
<servlet-mapping>
<servlet-name>MyServlet</servlet-name>
<url-pattern>*.jsp</url-pattern>
<url-pattern>*.action</url-pattern>
</servlet-mapping>
則任何擴(kuò)展名為jsp或action的url請(qǐng)求都會(huì)匹配,比如下面的url都會(huì)被匹配
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>。當(dāng)一個(gè)請(qǐng)求http://localhost:8080/appDemo/user/users.html來(lái)的時(shí)候,servlet-mapping1匹配到,不再用servlet-mapping2匹配 - 路徑匹配,先最長(zhǎng)路徑匹配,再最短路徑匹配
servlet-mapping1:<url-pattern>/user/*</url-pattern>,servlet-mapping2:<url-pattern>/*</url-pattern>。當(dāng)一個(gè)請(qǐng)求http://localhost:8080/appDemo/user/users.html來(lái)的時(shí)候,servlet-mapping1匹配到,不再用servlet-mapping2匹配 - 擴(kuò)展名匹配,
servlet-mapping1:<url-pattern>/user/*</url-pattern>,servlet-mapping2:<url-pattern>*.action</url-pattern>。當(dāng)一個(gè)請(qǐng)求http://localhost:8080/appDemo/user/addUser.action來(lái)的時(shí)候,servlet-mapping1匹配到,不再用servlet-mapping2匹配 - 缺省匹配,以上都找不到servlet,就用默認(rèn)的servlet,配置為<url-pattern>/</url-pattern>
需要注意的問(wèn)題
- 路徑匹配和擴(kuò)展名匹配無(wú)法同時(shí)設(shè)置
- 匹配方法只有三種,要么是路徑匹配(以“/”字符開(kāi)頭,并以“/”結(jié)尾),要么是擴(kuò)展名匹配(以“.”開(kāi)頭),要么是精確匹配,三種匹配方法不能進(jìn)行組合,不要想當(dāng)然使用通配符或正則規(guī)則。
- 如<url-pattern>/user/*.action</url-pattern>是非法的
- 另外注意:<url-pattern>/aa//bb</url-pattern>是精確匹配,合法,這里的不是通配的含義
- "/*"和"/"含義并不相同
- “/”屬于路徑匹配,并且可以匹配所有request,由于路徑匹配的優(yōu)先級(jí)僅次于精確匹配,所以“/”會(huì)覆蓋所有的擴(kuò)展名匹配,很多404錯(cuò)誤均由此引起,所以這是一種特別惡劣的匹配模式,一般只用于filter的url-pattern
- “/”是servlet中特殊的匹配模式,切該模式有且僅有一個(gè)實(shí)例,優(yōu)先級(jí)最低,不會(huì)覆蓋其他任何url-pattern,只是會(huì)替換servlet容器的內(nèi)建default servlet ,該模式同樣會(huì)匹配所有request。
- 配置“/”后,一種可能的現(xiàn)象是myServlet會(huì)攔截諸如
http://localhost:8080/appDemo/user/addUser.action、http://localhost:8080/appDemo/user/updateUser的格式的請(qǐng)求,但是并不會(huì)攔截http://localhost:8080/appDemo/user/users.jsp、http://localhost:8080/appDemo/index.jsp,這是應(yīng)為servlet容器有內(nèi)置的“*.jsp”匹配器,而擴(kuò)展名匹配的優(yōu)先級(jí)高于缺省匹配,所以才會(huì)有上述現(xiàn)象。
Tomcat在%CATALINA_HOME%\conf\web.xml文件中配置了默認(rèn)的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>
- “/”和“/”均會(huì)攔截靜態(tài)資源的加載,需要特別注意,其中"/"會(huì)攔截jsp文件的加載,因?yàn)槁窂狡ヅ鋬?yōu)先級(jí)大于.jsp后綴匹配。"/"則不會(huì)攔截jsp文件加載,因?yàn)檫@種匹配優(yōu)先級(jí)低于后綴匹配。但是能夠攔截.html,.css等靜態(tài)資源。
舉例
| 映射的URL | 對(duì)應(yīng)的Servlet |
|---|---|
| /hello | servlet1 |
| /bbs/admin/* | servlet2 |
| /bbs/* | servlet3 |
| *.jsp | servlet4 |
| / | servlet5 |
實(shí)際匹配
| 去掉上下文路徑的剩余路徑 | 處理請(qǐng)求的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 |