1. 背景
優(yōu)雅REST風(fēng)格的資源URL不希望帶 .html 或 .do 等后綴.由于早期的Spring MVC不能很好地處理靜態(tài)資源痛单,所以在web.xml中配置DispatcherServlet的請(qǐng)求映射,往往使用 *.do 忘渔、 *.xhtml等方式。這就決定了請(qǐng)求URL必須是一個(gè)帶后綴的URL俐巴,而無(wú)法采用真正的REST風(fēng)格的URL综芥。
如果將DispatcherServlet請(qǐng)求映射配置為"/"泰演,則Spring MVC將捕獲Web容器所有的請(qǐng)求,包括靜態(tài)資源的請(qǐng)求搁凸,Spring MVC會(huì)將它們當(dāng)成一個(gè)普通請(qǐng)求處理媚值,因此找不到對(duì)應(yīng)處理器將導(dǎo)致錯(cuò)誤。
如何讓Spring框架能夠捕獲所有URL的請(qǐng)求护糖,同時(shí)又將靜態(tài)資源的請(qǐng)求轉(zhuǎn)由Web容器處理褥芒,是可將DispatcherServlet的請(qǐng)求映射配置為"/"的前提。由于REST是Spring3.0最重要的功能之一嫡良,所以Spring團(tuán)隊(duì)很看重靜態(tài)資源處理這項(xiàng)任務(wù)锰扶,給出了堪稱經(jīng)典的兩種解決方案。
先調(diào)整web.xml中的DispatcherServlet的配置寝受,使其可以捕獲所有的請(qǐng)求:
<pre><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></pre>
通過(guò)上面url-pattern的配置坷牛,所有URL請(qǐng)求都將被Spring MVC的DispatcherServlet截獲。
2. 解決方案一:使用<mvc:default-servlet-handler />
<mvc:default-servlet-handler />
在springMVC-servlet.xml中配置<mvc:default-servlet-handler />后很澄,會(huì)在Spring MVC上下文中定義一個(gè)org.springframework.web.servlet.resource.DefaultServletHttpRequestHandler京闰,它會(huì)像一個(gè)檢查員,對(duì)進(jìn)入DispatcherServlet的URL進(jìn)行篩查甩苛,如果發(fā)現(xiàn)是靜態(tài)資源的請(qǐng)求蹂楣,就將該請(qǐng)求轉(zhuǎn)由Web應(yīng)用服務(wù)器默認(rèn)的Servlet處理,如果不是靜態(tài)資源的請(qǐng)求浪藻,才由DispatcherServlet繼續(xù)處理捐迫。
一般Web應(yīng)用服務(wù)器默認(rèn)的Servlet名稱是"default",因此DefaultServletHttpRequestHandler可以找到它爱葵。如果你所有的Web應(yīng)用服務(wù)器的默認(rèn)Servlet名稱不是"default"施戴,則需要通過(guò)default-servlet-name屬性顯示指定:
<mvc:default-servlet-handler default-servlet-name="所使用的Web服務(wù)器默認(rèn)使用的Servlet名稱" />
3.解決方案二:使用<mvc:resources />
<mvc:default-servlet-handler />將靜態(tài)資源的處理經(jīng)由Spring MVC框架交回Web應(yīng)用服務(wù)器處理反浓。而<mvc:resources />更進(jìn)一步,由Spring MVC框架自己處理靜態(tài)資源赞哗,并添加一些有用的附加值功能雷则。
首先,<mvc:resources />允許靜態(tài)資源放在任何地方肪笋,如WEB-INF目錄下月劈、類路徑下等,你甚至可以將JavaScript等靜態(tài)文件打到JAR包中藤乙。通過(guò)location屬性指定靜態(tài)資源的位置猜揪,由于location屬性是Resources類型,因此可以使用諸如"classpath:"等的資源前綴指定資源位置坛梁。傳統(tǒng)Web容器的靜態(tài)資源只能放在Web容器的根路徑下而姐,<mvc:resources />完全打破了這個(gè)限制。
其次划咐,<mvc:resources />依據(jù)當(dāng)前著名的Page Speed拴念、YSlow等瀏覽器優(yōu)化原則對(duì)靜態(tài)資源提供優(yōu)化。你可以通過(guò)cacheSeconds屬性指定靜態(tài)資源在瀏覽器端的緩存時(shí)間褐缠,一般可將該時(shí)間設(shè)置為一年政鼠,以充分利用瀏覽器端的緩存。在輸出靜態(tài)資源時(shí)队魏,會(huì)根據(jù)配置設(shè)置好響應(yīng)報(bào)文頭的Expires 和 Cache-Control值公般。
在接收到靜態(tài)資源的獲取請(qǐng)求時(shí),會(huì)檢查請(qǐng)求頭的Last-Modified值器躏,如果靜態(tài)資源沒(méi)有發(fā)生變化俐载,則直接返回303相應(yīng)狀態(tài)碼,提示客戶端使用瀏覽器緩存的數(shù)據(jù)登失,而非將靜態(tài)資源的內(nèi)容輸出到客戶端遏佣,以充分節(jié)省帶寬,提高程序性能揽浙。
在springMVC-servlet中添加如下配置:
<mvc:resources location="/,classpath:/META-INF/publicResources/" mapping="/resources/**"/>
以上配置將Web根路徑"/"及類路徑下 /META-INF/publicResources/ 的目錄映射為/resources路徑状婶。假設(shè)Web根路徑下?lián)碛衖mages、js這兩個(gè)資源目錄,在images下面有bg.gif圖片馅巷,在js下面有test.js文件膛虫,則可以通過(guò) /resources/images/bg.gif 和 /resources/js/test.js 訪問(wèn)這二個(gè)靜態(tài)資源。
假設(shè)WebRoot還擁有images/bg1.gif 及 js/test1.js钓猬,則也可以在網(wǎng)頁(yè)中通過(guò) /resources/images/bg1.gif 及 /resources/js/test1.js 進(jìn)行引用稍刀。