Spring MVC靜態(tài)資源處理
優(yōu)雅REST風(fēng)格的資源URL不希望帶 .html 或 .do 等后綴.由于早期的Spring MVC不能很好地處理靜態(tài)資源终议,所以在web.xml中配置DispatcherServlet的請求映射,往往使用 *.do 蜕劝、 *.xhtml等方式忍些。這就決定了請求URL必須是一個帶后綴的URL鲁猩,而無法采用真正的REST風(fēng)格的URL。
如果將DispatcherServlet請求映射配置為"/"罢坝,則Spring MVC將捕獲Web容器所有的請求廓握,包括靜態(tài)資源的請求,Spring MVC會將它們當(dāng)成一個普通請求處理嘁酿,因此找不到對應(yīng)處理器將導(dǎo)致錯誤隙券。
如何讓Spring框架能夠捕獲所有URL的請求,同時又將靜態(tài)資源的請求轉(zhuǎn)由Web容器處理闹司,是可將DispatcherServlet的請求映射配置為"/"的前提娱仔。由于REST是Spring3.0最重要的功能之一,所以Spring團(tuán)隊很看重靜態(tài)資源處理這項任務(wù)开仰,給出了堪稱經(jīng)典的兩種解決方案。
先調(diào)整web.xml中的DispatcherServlet的配置薪铜,使其可以捕獲所有的請求:
[](javascript:void(0); "復(fù)制代碼")
<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; overflow-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;"> <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>
](javascript:void(0); "復(fù)制代碼")
通過上面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谓娃,它會像一個檢查員,對進(jìn)入DispatcherServlet的URL進(jìn)行篩查蜒滩,如果發(fā)現(xiàn)是靜態(tài)資源的請求滨达,就將該請求轉(zhuǎn)由Web應(yīng)用服務(wù)器默認(rèn)的Servlet處理奶稠,如果不是靜態(tài)資源的請求,才由DispatcherServlet繼續(xù)處理捡遍。
一般Web應(yīng)用服務(wù)器默認(rèn)的Servlet名稱是"default"锌订,因此DefaultServletHttpRequestHandler可以找到它。如果你所有的Web應(yīng)用服務(wù)器的默認(rèn)Servlet名稱不是"default"画株,則需要通過default-servlet-name屬性顯示指定:
<mvc:default-servlet-handler default-servlet-name="所使用的Web服務(wù)器默認(rèn)使用的Servlet名稱" />
采用<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包中诗祸。通過location屬性指定靜態(tài)資源的位置跑芳,由于location屬性是Resources類型,因此可以使用諸如"classpath:"等的資源前綴指定資源位置贬媒。傳統(tǒng)Web容器的靜態(tài)資源只能放在Web容器的根路徑下聋亡,<mvc:resources />完全打破了這個限制。
其次际乘,<mvc:resources />依據(jù)當(dāng)前著名的Page Speed坡倔、YSlow等瀏覽器優(yōu)化原則對靜態(tài)資源提供優(yōu)化。你可以通過cacheSeconds屬性指定靜態(tài)資源在瀏覽器端的緩存時間脖含,一般可將該時間設(shè)置為一年罪塔,以充分利用瀏覽器端的緩存。在輸出靜態(tài)資源時养葵,會根據(jù)配置設(shè)置好響應(yīng)報文頭的Expires 和 Cache-Control值征堪。
在接收到靜態(tài)資源的獲取請求時,會檢查請求頭的Last-Modified值关拒,如果靜態(tài)資源沒有發(fā)生變化佃蚜,則直接返回303相應(yīng)狀態(tài)碼,提示客戶端使用瀏覽器緩存的數(shù)據(jù)着绊,而非將靜態(tài)資源的內(nèi)容輸出到客戶端谐算,以充分節(jié)省帶寬,提高程序性能归露。
在springMVC-servlet中添加如下配置:
<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; overflow-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;"><mvc:resources location="/,classpath:/META-INF/publicResources/" mapping="/resources/**"/></pre>
以上配置將Web根路徑"/"及類路徑下 /META-INF/publicResources/ 的目錄映射為/resources路徑洲脂。假設(shè)Web根路徑下?lián)碛衖mages、js這兩個資源目錄,在images下面有bg.gif圖片剧包,在js下面有test.js文件恐锦,則可以通過 /resources/images/bg.gif 和 /resources/js/test.js 訪問這二個靜態(tài)資源往果。
假設(shè)WebRoot還擁有images/bg1.gif 及 js/test1.js,則也可以在網(wǎng)頁中通過 /resources/images/bg1.gif 及 /resources/js/test1.js 進(jìn)行引用一铅。