1. 程式人生 > >mvc:default-servlet-handler標籤的作用

mvc:default-servlet-handler標籤的作用

最近在複習 Spring MVC 的時候,通過官方的文件弄清楚了一個以前不太理解的標籤<mvc:default-servlet-handler/>,寫出來分享一下。

在開發 RESTful 架構的 URI 時,我們都會在web.xml中將前端控制器的對映請求設定為"/"。 

è¿éåå¾çæè¿°


關於配置成"/",在 Spring 的官方文件中這樣描述:

The caveat to overriding the “/” Servlet mapping is that the RequestDispatcher for the default Servlet must be retrieved by name rather than by path.

大概意思是預設 Servlet 的 RequestDispatcher 必須通過名稱而不是路徑來檢索。 換句話說就是 Spring MVC 將接收到的所有請求都看作是一個普通的請求,包括對於靜態資源的請求。這樣以來,所有對於靜態資源的請求都會被看作是一個普通的後臺控制器請求,導致請求找不到而報 404 異常錯誤。例如:請求訪問靜態資源 /static/css/index.css 檢視 tomcat 的日誌會報一個警告: 

è¿éåå¾çæè¿°


對於這個問題 Spring MVC 在全域性配置檔案中提供了一個<mvc:default-servlet-handler/>標籤。在 WEB 容器啟動的時候會在上下文中定義一個 DefaultServletHttpRequestHandler,它會對DispatcherServlet的請求進行處理,如果該請求已經作了對映,那麼會接著交給後臺對應的處理程式,如果沒有作對映,就交給 WEB 應用伺服器預設的 Servlet 處理,從而找到對應的靜態資源,只有再找不到資源時才會報錯。

一般 WEB 應用伺服器預設的 Servlet 都是 default。如果預設 Servlet 用不同名稱自定義配置,或者在預設 Servlet 名稱未知的情況下使用了不同的 Servlet 容器,則必須顯式提供預設 Servlet 的名稱,如下:

<mvc:default-servlet-handler default-servlet-name="myCustomDefaultServlet"/>