此文做記錄交流，如有不當(dāng)，還望指正。

配置freemarker

SpringBoot配置freemarker非常簡單，我們只用在pom中添加freemarker依賴就ok了，SpringBoot默認(rèn)的freemarker的頁面位置位于 /src/main/resources/templates下面

首先添加依賴

     <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
      <modelVersion>4.0.0</modelVersion>
    
      <groupId>com.demo</groupId>
      <artifactId>springboot-helloword</artifactId>
      <version>0.0.1-SNAPSHOT</version>
      <packaging>jar</packaging>
      <name>springboot-helloword</name>
      <url>http://maven.apache.org</url>
      <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
      </properties>
      <parent>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-starter-parent</artifactId>
         <version>1.4.0.RELEASE</version>
      </parent>
      <dependencies>
        <dependency>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-freemarker</artifactId>
        </dependency>


        <dependency>
          <groupId>junit</groupId>
          <artifactId>junit</artifactId>
          <scope>test</scope>
        </dependency>
      </dependencies>
    </project>

在resources下面創(chuàng)建templates文件夾，并且在文件夾下面創(chuàng)建一個(gè)hello.ftl的文件

image.png

在hello.ftl 中添加

image.png

    import org.springframework.stereotype.Controller;
    import org.springframework.web.bind.annotation.RequestMapping;
    
    @Controller
    public class HelloController {
        @RequestMapping("/hello")
        public String hello(){
            return "hello";
        }
    }

啟動(dòng)項(xiàng)目訪問http://localhost:8080/hello看看效果

配置其他模版的方式和配置freemarker的方式是一樣的，Spring boot 支持 Thymeleaf FreeMarker Velocity Groovy Mustache

靜態(tài)資源配置

Spring Boot 默認(rèn)配置的/映射到/static（或/public ，/resources，/META-INF/resources），/webjars/會(huì)映射到classpath:/META-INF/resources/webjars/。
上面的 /public /resources /META-INF/resource 都位于classpath:下面，如 /src/main/resources/static
靜態(tài)資源我們一般會(huì)放在/static 下面，
比如我們?cè)趕tatic中創(chuàng)建img文件夾，后在里面放一張名為logo.png的圖片

image.png

啟動(dòng)項(xiàng)目訪問http://localhost:8080/img/logo.png看看效果

使用WebJars

添加jquery依賴：
<dependency>
<groupId>org.webjars</groupId>
<artifactId>jquery</artifactId>
<version>1.11.3</version>
</dependency>
然后可以如下使用：
<script type="text/javascript" src="/webjars/jquery/1.11.3/jquery.js"></script>
你可能注意到href中的1.11.3版本號(hào)了，如果僅僅這么使用，那么當(dāng)我們切換版本號(hào)的時(shí)候還要手動(dòng)修改href，怪麻煩的，我們可以用如下方式解決。

先在pom.xml中添加依賴：

<dependency>
    <groupId>org.webjars</groupId>
    <artifactId>webjars-locator</artifactId>
</dependency>

增加一個(gè)WebJarController：

@Controller
public class WebJarController {
    private final WebJarAssetLocator assetLocator = new WebJarAssetLocator();

    @ResponseBody
    @RequestMapping("/webjarslocator/{webjar}/**")
    public ResponseEntity locateWebjarAsset(@PathVariable String webjar, HttpServletRequest request) {
        try {
            String mvcPrefix = "/webjarslocator/" + webjar + "/";
            String mvcPath = (String) request.getAttribute(HandlerMapping.PATH_WITHIN_HANDLER_MAPPING_ATTRIBUTE);
            String fullPath = assetLocator.getFullPath(webjar, mvcPath.substring(mvcPrefix.length()));
            return new ResponseEntity(new ClassPathResource(fullPath), HttpStatus.OK);
        } catch (Exception e) {
            return new ResponseEntity<>(HttpStatus.NOT_FOUND);
        }
    }
}

然后使用的時(shí)候按照如下方式：

<script type="text/javascript" src="/webjarslocator/jquery/jquery.js"></script>

注意：這里不需要在寫版本號(hào)了，但是注意寫url的時(shí)候，只是在原來url基礎(chǔ)上去掉了版本號(hào)，其他的都不能少！

靜態(tài)資源版本管理

Spring MVC 提供了靜態(tài)資源版本映射的功能。

用途：當(dāng)我們資源內(nèi)容發(fā)生變化時(shí)，由于瀏覽器緩存，用戶本地的靜態(tài)資源還是舊的資源，為了防止這種情況導(dǎo)致的問題，我們可能會(huì)手動(dòng)在請(qǐng)求url的時(shí)候加個(gè)版本號(hào)或者其他方式。

版本號(hào)如：

<script type="text/javascript" src="/js/sample.js?v=1.0.1"></script>

Spring MVC 提供的功能可以很容易的幫助我們解決類似問題。

Spring MVC 有兩種解決方式。

注意：下面的配置方式針對(duì)freemarker模板方式，其他的配置方式可以參考。

資源名-md5 方式

例如：

<link rel="stylesheet" type="text/css" href="/css/index-2b371326aa93ce4b611853a309b69b29.css">

Spring 會(huì)自動(dòng)讀取資源md5，然后添加到index.css的名字后面，因此當(dāng)資源內(nèi)容發(fā)生變化的時(shí)候，文件名發(fā)生變化，就會(huì)更新本地資源。

配置方式：

在application.properties中做如下配置：

spring.resources.chain.strategy.content.enabled=true
spring.resources.chain.strategy.content.paths=/**

這樣配置后，所有/**請(qǐng)求的靜態(tài)資源都會(huì)被處理為上面例子的樣子。

到這兒還沒完，我們?cè)趯戀Y源url的時(shí)候還要特殊處理。

首先增加如下配置：

@ControllerAdvice
public class ControllerConfig {

    @Autowired
    ResourceUrlProvider resourceUrlProvider;

    @ModelAttribute("urls")
    public ResourceUrlProvider urls() {
        return this.resourceUrlProvider;
    }

}

然后在頁面寫的時(shí)候用下面的寫法：

<link rel="stylesheet" type="text/css" href="${urls.getForLookupPath('/css/index.css')}">

使用urls.getForLookupPath('/css/index.css')來得到處理后的資源名。

版本號(hào) 方式

在application.properties中做如下配置：

spring.resources.chain.strategy.fixed.enabled=true
spring.resources.chain.strategy.fixed.paths=/js/**,/v1.0.0/**
spring.resources.chain.strategy.fixed.version=v1.0.0

這里配置需要特別注意，將version的值配置在paths中。原因我們?cè)谥vSpring MVC 處理邏輯的時(shí)候說。

在頁面寫的時(shí)候，寫法如下：

<script type="text/javascript" src="${urls.getForLookupPath('/js/index.js')}"></script>

注意，這里仍然使用了urls.getForLookupPath，urls配置方式見上一種方式。

在請(qǐng)求的實(shí)際頁面中，會(huì)顯示為：

<script type="text/javascript" src="/v1.0.0/js/index.js"></script>

可以看到這里的地址是/v1.0.0/js/index.js。

靜態(tài)資源版本管理 處理過程

在Freemarker模板首先會(huì)調(diào)用urls.getForLookupPath方法，返回一個(gè)/v1.0.0/js/index.js或/css/index-2b371326aa93ce4b611853a309b69b29.css。

這時(shí)頁面上的內(nèi)容就是處理后的資源地址。

這之后瀏覽器發(fā)起請(qǐng)求。

這里分開說。

第一種md5方式

請(qǐng)求/css/index-2b371326aa93ce4b611853a309b69b29.css，我們md5配置的paths=/**，所以Spring MVC 會(huì)嘗試url中是否包含-，如果包含會(huì)去掉后面這部分，然后去映射的目錄（如/static/）查找/css/index.css文件，如果能找到就返回。

第二種版本方式

請(qǐng)求/v1.0.0/js/index.js。

如果我們paths中沒有配置/v1.0.0，那么上面這個(gè)請(qǐng)求地址就不會(huì)按版本方式來處理，因此會(huì)找不到上面的資源。

如果配置了/v1.0.0，Spring 就會(huì)將/v1.0.0去掉再去找/js/index.js，最終會(huì)在/static/下面找到。

下面是模版的配置，引用使用Spring Boot開發(fā)WEB頁面

mvc

spring.mvc.async.request-timeout
設(shè)定async請(qǐng)求的超時(shí)時(shí)間，以毫秒為單位，如果沒有設(shè)置的話，以具體實(shí)現(xiàn)的超時(shí)時(shí)間為準(zhǔn)，比如tomcat的servlet3的話是10秒.
spring.mvc.date-format
設(shè)定日期的格式，比如dd/MM/yyyy.
spring.mvc.favicon.enabled
是否支持favicon.ico，默認(rèn)為: true
spring.mvc.ignore-default-model-on-redirect
在重定向時(shí)是否忽略默認(rèn)model的內(nèi)容，默認(rèn)為true
spring.mvc.locale
指定使用的Locale.
spring.mvc.message-codes-resolver-format
指定message codes的格式化策略(PREFIX_ERROR_CODE,POSTFIX_ERROR_CODE).

view

spring.view.prefix
設(shè)定mvc視圖的前綴.
spring.view.suffix
設(shè)定mvc視圖的后綴.

resource

spring.resources.add-mappings
是否開啟默認(rèn)的資源處理，默認(rèn)為true
spring.resources.cache-period
設(shè)定資源的緩存時(shí)效，以秒為單位.
spring.resources.chain.cache
是否開啟緩存，默認(rèn)為: true
spring.resources.chain.enabled
是否開啟資源 handling chain，默認(rèn)為false
spring.resources.chain.html-application-cache
是否開啟h5應(yīng)用的cache manifest重寫，默認(rèn)為: false
spring.resources.chain.strategy.content.enabled
是否開啟內(nèi)容版本策略，默認(rèn)為false
spring.resources.chain.strategy.content.paths
指定要應(yīng)用的版本的路徑，多個(gè)以逗號(hào)分隔，默認(rèn)為:[/**]
spring.resources.chain.strategy.fixed.enabled
是否開啟固定的版本策略，默認(rèn)為false
spring.resources.chain.strategy.fixed.paths
指定要應(yīng)用版本策略的路徑，多個(gè)以逗號(hào)分隔
spring.resources.chain.strategy.fixed.version
指定版本策略使用的版本號(hào)
spring.resources.static-locations
指定靜態(tài)資源路徑，默認(rèn)為classpath:[/META-INF/resources/,/resources/, /static/, /public/]以及context:/

freemarker

spring.freemarker.allow-request-override
指定HttpServletRequest的屬性是否可以覆蓋controller的model的同名項(xiàng)
spring.freemarker.allow-session-override
指定HttpSession的屬性是否可以覆蓋controller的model的同名項(xiàng)
spring.freemarker.cache
是否開啟template caching.
spring.freemarker.charset
設(shè)定Template的編碼.
spring.freemarker.check-template-location
是否檢查templates路徑是否存在.
spring.freemarker.content-type
設(shè)定Content-Type.
spring.freemarker.enabled
是否允許mvc使用freemarker.
spring.freemarker.expose-request-attributes
設(shè)定所有request的屬性在merge到模板的時(shí)候，是否要都添加到model中.
spring.freemarker.expose-session-attributes
設(shè)定所有HttpSession的屬性在merge到模板的時(shí)候，是否要都添加到model中.
spring.freemarker.expose-spring-macro-helpers
設(shè)定是否以springMacroRequestContext的形式暴露RequestContext給Spring’s macro library使用
spring.freemarker.prefer-file-system-access
是否優(yōu)先從文件系統(tǒng)加載template，以支持熱加載，默認(rèn)為true
spring.freemarker.prefix
設(shè)定freemarker模板的前綴.
spring.freemarker.request-context-attribute
指定RequestContext屬性的名.
spring.freemarker.settings
設(shè)定FreeMarker keys.
spring.freemarker.suffix
設(shè)定模板的后綴.
spring.freemarker.template-loader-path
設(shè)定模板的加載路徑，多個(gè)以逗號(hào)分隔，默認(rèn): ["classpath:/templates/"]
spring.freemarker.view-names
指定使用模板的視圖列表.

velocity

spring.velocity.allow-request-override
指定HttpServletRequest的屬性是否可以覆蓋controller的model的同名項(xiàng)
spring.velocity.allow-session-override
指定HttpSession的屬性是否可以覆蓋controller的model的同名項(xiàng)
spring.velocity.cache
是否開啟模板緩存
spring.velocity.charset
設(shè)定模板編碼
spring.velocity.check-template-location
是否檢查模板路徑是否存在.
spring.velocity.content-type
設(shè)定ContentType的值
spring.velocity.date-tool-attribute
設(shè)定暴露給velocity上下文使用的DateTool的名
spring.velocity.enabled
設(shè)定是否允許mvc使用velocity
spring.velocity.expose-request-attributes
是否在merge模板的時(shí)候，將request屬性都添加到model中
spring.velocity.expose-session-attributes
是否在merge模板的時(shí)候，將HttpSession屬性都添加到model中
spring.velocity.expose-spring-macro-helpers
設(shè)定是否以springMacroRequestContext的名來暴露RequestContext給Spring’s macro類庫使用
spring.velocity.number-tool-attribute
設(shè)定暴露給velocity上下文的NumberTool的名
spring.velocity.prefer-file-system-access
是否優(yōu)先從文件系統(tǒng)加載模板以支持熱加載，默認(rèn)為true
spring.velocity.prefix
設(shè)定velocity模板的前綴.
spring.velocity.properties
設(shè)置velocity的額外屬性.
spring.velocity.request-context-attribute
設(shè)定RequestContext attribute的名.
spring.velocity.resource-loader-path
設(shè)定模板路徑，默認(rèn)為: classpath:/templates/
spring.velocity.suffix
設(shè)定velocity模板的后綴.
spring.velocity.toolbox-config-location
設(shè)定Velocity Toolbox配置文件的路徑，比如 /WEB-INF/toolbox.xml.
spring.velocity.view-names
設(shè)定需要解析的視圖名稱.

thymeleaf

spring.thymeleaf.cache
是否開啟模板緩存，默認(rèn)true
spring.thymeleaf.check-template-location
是否檢查模板路徑是否存在，默認(rèn)true
spring.thymeleaf.content-type
指定Content-Type，默認(rèn)為: text/html
spring.thymeleaf.enabled
是否允許MVC使用Thymeleaf，默認(rèn)為: true
spring.thymeleaf.encoding
指定模板的編碼，默認(rèn)為: UTF-8
spring.thymeleaf.excluded-view-names
指定不使用模板的視圖名稱，多個(gè)以逗號(hào)分隔.
spring.thymeleaf.mode
指定模板的模式，具體查看StandardTemplateModeHandlers，默認(rèn)為: HTML5
spring.thymeleaf.prefix
指定模板的前綴，默認(rèn)為:classpath:/templates/
spring.thymeleaf.suffix
指定模板的后綴，默認(rèn)為:.html
spring.thymeleaf.template-resolver-order
指定模板的解析順序，默認(rèn)為第一個(gè).
spring.thymeleaf.view-names
指定使用模板的視圖名，多個(gè)以逗號(hào)分隔.

groovy模板

spring.groovy.template.allow-request-override
指定HttpServletRequest的屬性是否可以覆蓋controller的model的同名項(xiàng)
spring.groovy.template.allow-session-override
指定HttpSession的屬性是否可以覆蓋controller的model的同名項(xiàng)
spring.groovy.template.cache
是否開啟模板緩存.
spring.groovy.template.charset
指定Template編碼.
spring.groovy.template.check-template-location
是否檢查模板的路徑是否存在.
spring.groovy.template.configuration.auto-escape
是否在渲染模板時(shí)自動(dòng)排查model的變量，默認(rèn)為: false
spring.groovy.template.configuration.auto-indent
是否在渲染模板時(shí)自動(dòng)縮進(jìn)，默認(rèn)為false
spring.groovy.template.configuration.auto-indent-string
如果自動(dòng)縮進(jìn)啟用的話，是使用SPACES還是TAB，默認(rèn)為: SPACES
spring.groovy.template.configuration.auto-new-line
渲染模板時(shí)是否要輸出換行，默認(rèn)為false
spring.groovy.template.configuration.base-template-class
指定template base class.
spring.groovy.template.configuration.cache-templates
是否要緩存模板，默認(rèn)為true
spring.groovy.template.configuration.declaration-encoding
在寫入declaration header時(shí)使用的編碼
spring.groovy.template.configuration.expand-empty-elements
是使用
這種形式，還是
</br>這種展開模式，默認(rèn)為: false)
spring.groovy.template.configuration.locale
指定template locale.
spring.groovy.template.configuration.new-line-string
當(dāng)啟用自動(dòng)換行時(shí)，換行的輸出，默認(rèn)為系統(tǒng)的line.separator屬性的值
spring.groovy.template.configuration.resource-loader-path
指定groovy的模板路徑，默認(rèn)為classpath:/templates/
spring.groovy.template.configuration.use-double-quotes
指定屬性要使用雙引號(hào)還是單引號(hào)，默認(rèn)為false
spring.groovy.template.content-type
指定Content-Type.
spring.groovy.template.enabled
是否開啟groovy模板的支持.
spring.groovy.template.expose-request-attributes
設(shè)定所有request的屬性在merge到模板的時(shí)候，是否要都添加到model中.
spring.groovy.template.expose-session-attributes
設(shè)定所有request的屬性在merge到模板的時(shí)候，是否要都添加到model中.
spring.groovy.template.expose-spring-macro-helpers
設(shè)定是否以springMacroRequestContext的形式暴露RequestContext給Spring’s macro library使用
spring.groovy.template.prefix
指定模板的前綴.
spring.groovy.template.request-context-attribute
指定RequestContext屬性的名.
spring.groovy.template.resource-loader-path
指定模板的路徑，默認(rèn)為: classpath:/templates/
spring.groovy.template.suffix
指定模板的后綴
spring.groovy.template.view-names
指定要使用模板的視圖名稱.