關於spring mvc訪問靜態資源，包括html.js
阿新 • • 發佈：2019-01-21
優雅REST風格的資源URL不希望帶 .html 或 .do 等字尾.由於早期的Spring MVC不能很好地處理靜態資源，所以在web.xml中配置DispatcherServlet的請求對映，往往使用 *.do 、 *.xhtml等方式。這就決定了請求URL必須是一個帶字尾的URL，而無法採用真正的REST風格的URL。
如果將DispatcherServlet請求對映配置為"/"，則Spring MVC將捕獲Web容器所有的請求，包括靜態資源的請求，Spring MVC會將它們當成一個普通請求處理，因此找不到對應處理器將導致錯誤。
如何讓Spring框架能夠捕獲所有URL的請求，同時又將靜態資源的請求轉由Web容器處理，是可將DispatcherServlet的請求對映配置為"/"的前提。由於REST是Spring3.0最重要的功能之一，所以Spring團隊很看重靜態資源處理這項任務，給出了堪稱經典的兩種解決方案。
先調整web.xml中的DispatcherServlet的配置，使其可以捕獲所有的請求：
<servlet>
<servlet-name>springMVC</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>springMVC</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
通過上面url-pattern的配置，所有URL請求都將被Spring MVC的DispatcherServlet截獲。
採用<mvc:default-servlet-handler />
在springMVC-servlet.xml中配置<mvc:default-servlet-handler />後，會在Spring MVC上下文中定義一個org.springframework.web.servlet.resource.DefaultServletHttpRequestHandler，它會像一個檢查員，對進入DispatcherServlet的URL進行篩查，如果發現是靜態資源的請求，就將該請求轉由Web應用伺服器預設的Servlet處理，如果不是靜態資源的請求，才由DispatcherServlet繼續處理。
一般Web應用伺服器預設的Servlet名稱是"default"，因此DefaultServletHttpRequestHandler可以找到它。如果你所有的Web應用伺服器的預設Servlet名稱不是"default"，則需要通過default-servlet-name屬性顯示指定：
<mvc:default-servlet-handler default-servlet-name="所使用的Web伺服器預設使用的Servlet名稱" />
架構搭起後 為了實現 對靜態資原始檔的訪問 spring_mvc.xml 新增<mvc:default-servlet-handler /> 但卻再也無法訪問到controller
新增<mvc:annotation-driven />即可，
[html] view plain copy 在CODE上檢視程式碼片派生到我的程式碼片
<!-- 預設的註解對映的支援 -->
<mvc:annotation-driven />
<!-- 對靜態資原始檔的訪問 方案一 （二選一） -->
<mvc:default-servlet-handler />
特別註明，如果沒有 <mvc:annotation-driven /> ， <mvc:default-servlet-handler /> 是訪問不了spring mvc URL的
採用<mvc:resources />
<mvc:default-servlet-handler />將靜態資源的處理經由Spring MVC框架交回Web應用伺服器處理。而<mvc:resources />更進一步，由Spring MVC框架自己處理靜態資源，並新增一些有用的附加值功能。
首先，<mvc:resources />允許靜態資源放在任何地方，如WEB-INF目錄下、類路徑下等，你甚至可以將JavaScript等靜態檔案打到JAR包中。通過location屬性指定靜態資源的位置，由於location屬性是Resources型別，因此可以使用諸如"classpath:"等的資源字首指定資源位置。傳統Web容器的靜態資源只能放在Web容器的根路徑下，<mvc:resources />完全打破了這個限制。
其次，<mvc:resources />依據當前著名的Page Speed、YSlow等瀏覽器優化原則對靜態資源提供優化。你可以通過cacheSeconds屬性指定靜態資源在瀏覽器端的快取時間，一般可將該時間設定為一年，以充分利用瀏覽器端的快取。在輸出靜態資源時，會根據配置設定好響應報文頭的Expires 和 Cache-Control值。
在接收到靜態資源的獲取請求時，會檢查請求頭的Last-Modified值，如果靜態資源沒有發生變化，則直接返回303相應狀態碼，提示客戶端使用瀏覽器快取的資料，而非將靜態資源的內容輸出到客戶端，以充分節省頻寬，提高程式效能。
在springMVC-servlet中新增如下配置：
<mvc:resources location="/,classpath:/META-INF/publicResources/" mapping="/resources/**"/>
以上配置將Web根路徑"/"及類路徑下 /META-INF/publicResources/ 的目錄對映為/resources路徑。假設Web根路徑下擁有images、js這兩個資源目錄,在images下面有bg.gif圖片，在js下面有test.js檔案，則可以通過 /resources/images/bg.gif 和 /resources/js/test.js 訪問這二個靜態資源。
假設WebRoot還擁有images/bg1.gif 及 js/test1.js，則也可以在網頁中通過 /resources/images/bg1.gif 及 /resources/js/test1.js 進行引用。
最後一種方法
直接用容器的DefaultServlet來處理靜態資源請求，而不是這樣先通過Spring MVC來轉發呢？（相比效能上會好很多），答案是肯定的。
比如我們將資原始檔都放在resouces目錄下，那麼只需要在web.xml中配置：
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>/resource/*</url-pattern>
</servlet-mapping>
並將它放在所有Servlet的最前面（為了讓它最先匹配），這樣的話效能上應該比較好
如果將DispatcherServlet請求對映配置為"/"，則Spring MVC將捕獲Web容器所有的請求，包括靜態資源的請求，Spring MVC會將它們當成一個普通請求處理，因此找不到對應處理器將導致錯誤。
如何讓Spring框架能夠捕獲所有URL的請求，同時又將靜態資源的請求轉由Web容器處理，是可將DispatcherServlet的請求對映配置為"/"的前提。由於REST是Spring3.0最重要的功能之一，所以Spring團隊很看重靜態資源處理這項任務，給出了堪稱經典的兩種解決方案。
先調整web.xml中的DispatcherServlet的配置，使其可以捕獲所有的請求：
<servlet>
<servlet-name>springMVC</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>springMVC</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
通過上面url-pattern的配置，所有URL請求都將被Spring MVC的DispatcherServlet截獲。
採用<mvc:default-servlet-handler />
在springMVC-servlet.xml中配置<mvc:default-servlet-handler />後，會在Spring MVC上下文中定義一個org.springframework.web.servlet.resource.DefaultServletHttpRequestHandler，它會像一個檢查員，對進入DispatcherServlet的URL進行篩查，如果發現是靜態資源的請求，就將該請求轉由Web應用伺服器預設的Servlet處理，如果不是靜態資源的請求，才由DispatcherServlet繼續處理。
一般Web應用伺服器預設的Servlet名稱是"default"，因此DefaultServletHttpRequestHandler可以找到它。如果你所有的Web應用伺服器的預設Servlet名稱不是"default"，則需要通過default-servlet-name屬性顯示指定：
<mvc:default-servlet-handler default-servlet-name="所使用的Web伺服器預設使用的Servlet名稱" />
架構搭起後 為了實現 對靜態資原始檔的訪問 spring_mvc.xml 新增<mvc:default-servlet-handler /> 但卻再也無法訪問到controller
新增<mvc:annotation-driven />即可，
[html] view plain copy 在CODE上檢視程式碼片派生到我的程式碼片
<!-- 預設的註解對映的支援 -->
<mvc:annotation-driven />
<!-- 對靜態資原始檔的訪問 方案一 （二選一） -->
<mvc:default-servlet-handler />
特別註明，如果沒有 <mvc:annotation-driven /> ， <mvc:default-servlet-handler /> 是訪問不了spring mvc URL的
採用<mvc:resources />
<mvc:default-servlet-handler />將靜態資源的處理經由Spring MVC框架交回Web應用伺服器處理。而<mvc:resources />更進一步，由Spring MVC框架自己處理靜態資源，並新增一些有用的附加值功能。
首先，<mvc:resources />允許靜態資源放在任何地方，如WEB-INF目錄下、類路徑下等，你甚至可以將JavaScript等靜態檔案打到JAR包中。通過location屬性指定靜態資源的位置，由於location屬性是Resources型別，因此可以使用諸如"classpath:"等的資源字首指定資源位置。傳統Web容器的靜態資源只能放在Web容器的根路徑下，<mvc:resources />完全打破了這個限制。
其次，<mvc:resources />依據當前著名的Page Speed、YSlow等瀏覽器優化原則對靜態資源提供優化。你可以通過cacheSeconds屬性指定靜態資源在瀏覽器端的快取時間，一般可將該時間設定為一年，以充分利用瀏覽器端的快取。在輸出靜態資源時，會根據配置設定好響應報文頭的Expires 和 Cache-Control值。
在接收到靜態資源的獲取請求時，會檢查請求頭的Last-Modified值，如果靜態資源沒有發生變化，則直接返回303相應狀態碼，提示客戶端使用瀏覽器快取的資料，而非將靜態資源的內容輸出到客戶端，以充分節省頻寬，提高程式效能。
在springMVC-servlet中新增如下配置：
<mvc:resources location="/,classpath:/META-INF/publicResources/" mapping="/resources/**"/>
以上配置將Web根路徑"/"及類路徑下 /META-INF/publicResources/ 的目錄對映為/resources路徑。假設Web根路徑下擁有images、js這兩個資源目錄,在images下面有bg.gif圖片，在js下面有test.js檔案，則可以通過 /resources/images/bg.gif 和 /resources/js/test.js 訪問這二個靜態資源。
假設WebRoot還擁有images/bg1.gif 及 js/test1.js，則也可以在網頁中通過 /resources/images/bg1.gif 及 /resources/js/test1.js 進行引用。
最後一種方法
直接用容器的DefaultServlet來處理靜態資源請求，而不是這樣先通過Spring MVC來轉發呢？（相比效能上會好很多），答案是肯定的。
比如我們將資原始檔都放在resouces目錄下，那麼只需要在web.xml中配置：
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>/resource/*</url-pattern>
</servlet-mapping>
並將它放在所有Servlet的最前面（為了讓它最先匹配），這樣的話效能上應該比較好