servlet的url-pattern匹配規(guī)則

首先需要明確幾容易混淆的規(guī)則:

  1. servlet容器中的匹配規(guī)則既不是簡(jiǎn)單的通配,也不是正則表達(dá)式,而是特定的規(guī)則。所以不要用通配符或者正則表達(dá)式的匹配規(guī)則來(lái)看待servlet的url-pattern。
  2. 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ī)則;
  3. 當(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的映射匹配
  4. url-pattern映射匹配過(guò)程是有優(yōu)先順序的,而且當(dāng)有一個(gè)servlet匹配成功以后,就不會(huì)去理會(huì)剩下的servlet了。

四種匹配規(guī)則

  1. 精確匹配
      <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。

  1. 路徑匹配
      以“/”字符開(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>

匹配順序

  1. 精確匹配,
    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匹配
  2. 路徑匹配,先最長(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匹配
  3. 擴(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匹配
  4. 缺省匹配,以上都找不到servlet,就用默認(rèn)的servlet,配置為<url-pattern>/</url-pattern>

需要注意的問(wèn)題

  1. 路徑匹配和擴(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>是精確匹配,合法,這里的不是通配的含義
  1. "/*"和"/"含義并不相同
  • “/”屬于路徑匹配,并且可以匹配所有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.actionhttp://localhost:8080/appDemo/user/updateUser的格式的請(qǐng)求,但是并不會(huì)攔截http://localhost:8080/appDemo/user/users.jsphttp://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
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容