<servlet-mapping>元素在Servlet和URL樣式之間定義一個映射。它包含了兩個子元素<servlet- name>和<url-pattern>,<servlet-name>元素給出的Servlet名字必須是在<servlet>元素中聲明過的Servlet的名字。<url-pattern>元素指定對應于Servlet的URL路徑,該路徑是相對于Web應用程序上下文根的路徑。例如:
<servlet-mapping> <servlet-name>helloworld</servlet-name> <url-pattern>/hello</url-pattern> </servlet-mapping> |
Servlet 2.5規范允許<servlet-mapping>的<url-pattern>子元素出現多次,之前的規范只允許一個<servlet-mapping>元素包含一個<url-pattern>子元素。我們看下面的例子:
<servlet-mapping> <servlet-name>welcome</servlet-name> <url-pattern>/en/welcome</url-pattern> <url-pattern>/zh/welcome</url-pattern> </servlet-mapping> |
在配置了Servlet與URL樣式之間的映射后,當Servlet容器接收到一個請求,它首先確定該請求應該由哪一個Web應用程序來響應。這是通過比較請求URI的開始部分與Web應用程序的上下文路徑來確定的。映射到Servlet的路徑是請求URI減去上下文的路徑,Web應用程序的Context對象在去掉請求URI的上下文路徑后,將按照下面的路徑映射規則的順序對剩余部分的路徑進行處理,并且在找到第一個成功的匹配后,不再進行下一個匹配。
容器試著對請求的路徑和Servlet映射的路徑進行精確匹配,如果匹配成功,則調用這個Servlet來處理請求。
容器試著匹配最長的路徑前綴,以斜杠(/)為路徑分隔符,按照路徑樹逐級遞減匹配,選擇最長匹配的Servlet來處理請求。
如果請求的URL路徑最后有擴展名,如.jsp,Servlet容器會試著匹配處理這個擴展名的Servlet。
如果按照前面3條規則沒有找到匹配的Servlet,容器會調用Web應用程序默認的Servlet來對請求進行處理,如果沒有定義默認的Servlet,容器將向客戶端發送HTTP 404錯誤信息(請求資源不存在)。
在部署描述符中,可以使用下面的語法來定義映射。
以/開始并且以 /* 結束的字符串用來映射路徑,例如:
<url-pattern>/admin/*</url-pattern> |
如果沒有精確匹配,那么對/admin/路徑下的資源的所有請求將由映射了上述URL樣式的Servlet來處理。
以 *. 為前綴的字符串用來映射擴展名,例如:
<url-pattern>*.do</url-pattern> |
如果沒有精確匹配和路徑匹配,那么對具有.do擴展名的資源的請求將由映射了上述URL樣式的Servlet來處理。
以一個單獨的/指示這個Web應用程序是默認的Servlet,例如:
<url-pattern>/</url-pattern> |
如果對某個請求沒有找到匹配的Servlet,那么將使用Web應用程序的默認Servlet來處理。
所有其他的字符被用于精確匹配,例如:
<url-pattern>/login</url-pattern> |
如果請求/login,那么將由映射了URL樣式/login的Servlet來處理。