Spring MVC靜態資源訪問

時間 2019-11-17

標籤 spring mvc 靜態資源訪問欄目 Spring 简体版

原文原文鏈接

優雅REST風格的資源URL不但願帶 .html 或 .do 等後綴.因爲早期的Spring MVC不能很好地處理靜態資源，因此在web.xml中配置DispatcherServlet的請求映射，每每使用 *.do 、 *.xhtml等方式。這就決定了請求URL必須是一個帶後綴的URL，而沒法採用真正的REST風格的URL。javascript

若是將DispatcherServlet請求映射配置爲"/"，則Spring MVC將捕獲Web容器全部的請求，包括靜態資源的請求，Spring MVC會將它們當成一個普通請求處理，所以找不到對應處理器將致使錯誤。css

如何讓Spring框架可以捕獲全部URL的請求，同時又將靜態資源的請求轉由Web容器處理，是可將DispatcherServlet的請求映射配置爲"/"的前提。因爲REST是Spring3.0最重要的功能之一，因此Spring團隊很看重靜態資源處理這項任務，給出了堪稱經典的兩種解決方案。html

先調整web.xml中的DispatcherServlet的配置，使其能夠捕獲全部的請求：java

    <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截獲。web

這裏給 servlet-name定義的名稱是springMVC,這樣的話會在web-inf下spring會自動掃描一個XML文件名叫springMVC-servlet.xml文件，這裏都是spring自動掃描的，若是你沒有提供，將會報一個文件查找不到的異常。可是，能夠在<servlet>標籤裏添加：spring

<init-param>    
        <!-- Spring MVC 核心配置文件，讀取路徑設置，默認在 WEB-INF/下-->  
        <param-name>contextConfigLocation</param-name>    
        <param-value>classpath:conf/SpringDispatcherServlet.xml</param-value>    
    </init-param>

以指定讀取特定的xml文件。瀏覽器

方式一：<mvc:default-servlet-handler />

在springMVC-servlet.xml中配置<mvc:default-servlet-handler />後，會在Spring MVC上下文中定義一個org.springframework.web.servlet.resource.DefaultServletHttpRequestHandler，它會像一個檢查員，對進入DispatcherServlet的URL進行篩查，若是發現是靜態資源的請求，就將該請求轉由Web應用服務器默認的Servlet處理，若是不是靜態資源的請求，才由DispatcherServlet繼續處理。spring-mvc

通常Web應用服務器默認的Servlet名稱是"default"，所以DefaultServletHttpRequestHandler能夠找到它。若是你全部的Web應用服務器的默認Servlet名稱不是"default"，則須要經過default-servlet-name屬性顯示指定：緩存

<mvc:default-servlet-handler default-servlet-name="所使用的Web服務器默認使用的Servlet名稱" />服務器

方式二：<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 進行引用。

demo

springMVC-servlet.xml文件

<?xml version="1.0" encoding="UTF-8"?>  
<beans xmlns="http://www.springframework.org/schema/beans"    
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    
    xmlns:mvc="http://www.springframework.org/schema/mvc"  
    xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd     
    http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd">     
  
    <mvc:resources mapping="/javascript/**" location="/static_resources/javascript/"/>  
    <mvc:resources mapping="/styles/**" location="/static_resources/css/"/>  
    <mvc:resources mapping="/images/**" location="/static_resources/images/"/>  
    <mvc:default-servlet-handler />        
      
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">  
        <property name="prefix" value="/WEB-INF/views/"/>  
        <property name="suffix" value=".jsp"/>  
    </bean>    
</beans>

這裏能夠看到我全部的頁面引用到/styles/**的資源都從/static_resources/css裏面進行查找。

頁面的一段靜態資源訪問的代碼。

<%@ taglib prefix="c" uri="http://java.sun.com/jstl/core"%>  
<HTML>  
<HEAD>  
  <TITLE> ABCDEFG </TITLE>  
<link type="text/css" rel="stylesheet" href="<c:url value='/styles/siteboard.css'/>">  
...  
...  
...