SpringBoot整合freemarker的講解

更新時間：2019年01月16日 11:32:06 作者：Haozz_1994

今天小編就為大家分享一篇關(guān)于SpringBoot整合freemarker的講解，小編覺得內(nèi)容挺不錯的，現(xiàn)在分享給大家，具有很好的參考價值，需要的朋友一起跟隨小編來看看吧

freemarker和thymeleaf是模板引擎。在早前我們使用Struts或者SpringMVC等框架的時候，使用的都是jsp，jsp的本質(zhì)其實就是一個Servlet，其中的數(shù)據(jù)需要在后端進(jìn)行渲染，然后再在客戶端顯示，效率比較低下。而模板引擎恰恰相反，其中的數(shù)據(jù)渲染是在客戶端，效率方面比較理想一點。前后端不分離的話用模板引擎比較好，前后端分離的話其實用處并不大很大。Spring官方比較推薦的是thymeleaf，其文件后綴是html。本篇文章我們主要來看看SpringBoot整合freemarker，SpringBoot整合thymeleaf我們將在后面的文章中講解。

先來看一下項目文件目錄：

首先，pom.xml中導(dǎo)入freemarker的依賴：

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>

在application.properties(或yml)配置文件中加入freemarker相關(guān)配置：

#  freemarker靜態(tài)資源配置
#    設(shè)定ftl文件路徑
spring.freemarker.tempalte-loader-path=classpath:/templates
#    關(guān)閉緩存，及時刷新，上線生產(chǎn)環(huán)境需要修改為true
spring.freemarker.cache=false
spring.freemarker.charset=UTF-8
spring.freemarker.check-template-location=true
spring.freemarker.content-type=text/html
spring.freemarker.expose-request-attributes=true
spring.freemarker.expose-session-attributes=true
spring.freemarker.request-context-attribute=request
spring.freemarker.suffix=.ftl

這里指定了freemarker文件的路徑是classpath/templates，在resources文件夾下的templates新建freemarker文件夾，并且在其中新建index.ftl（上面配置文件中已經(jīng)指定了freemarker模板的文件后綴為ftl）：

<!DOCTYPE html>
<html>
<head lang="en">
  <meta charset="UTF-8"/>
  <title></title>
</head>
<body>
FreeMarker模板引擎
<h1>${resource.name}</h1>
<h1>${resource.website}</h1>
<h1>${resource.language}</h1>
</body>
</html>

我們在resources下新建resource.properties：

com.haozz.opensource.name=wangshu
com.haozz.opensource.website=www.haozz.top:18158/
com.haozz.opensource.language=chinese

在SpringBoot啟動類統(tǒng)計目錄下新建utils包，在其中新建Resources類（此處使用配置文件引入相關(guān)數(shù)據(jù)）：

package com.haozz.freemarkerdemo.utils;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.PropertySource;
//表示這個類是一個讀取配置文件的類
@Configuration
//指定配置的一些屬性,其中的prefix表示前綴
@ConfigurationProperties(prefix = "com.haozz.opensource")
//指定所讀取的配置文件的路徑
@PropertySource(value = "classpath:resource.properties")
public class Resource {
  private String name;
  private String website;
  private String language;
  //...setter and getter
}

新建Controller包，新建FreeMarkerCtrl類：

package com.haozz.freemarkerdemo.controller;
import com.haozz.freemarkerdemo.utils.Resource;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.ModelMap;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
@RequestMapping(value = "/ftl")
public class FreeMarkerCtrl {
  @Autowired
  private Resource resource;
  @RequestMapping(value = "index")
  public String index(ModelMap map){
    map.addAttribute("resource",resource);
    return "freemarker/index";
  }
}

這里的ModelMap就相當(dāng)于SpringMVC中的ModelAndView，其中的很多方法也很類似，我們這里返回的字符串就是freemarker模板的路徑，不用寫后綴，因為配置文件中已經(jīng)指定了后綴為.ftl

瀏覽器發(fā)起請求，得到結(jié)果：

這樣，SpringBoot整合freemarker就好了。

我們再來試一下表格的形式。

FreeMarkerCtrl中新增方法：

@RequestMapping(value ="center")
  public String center(ModelMap map){
    map.put("users",parseUsers());
    map.put("title","用戶列表");
    return "freemarker/center/center";
  }
  private List<Map> parseUsers(){
    List<Map> list= new ArrayList<>();
    for(int i=0;i<10;i++){
      Map map= new HashMap();
      map.put("name","kevin_"+i);
      map.put("age",10+i);
      map.put("phone","1860291105"+i);
      list.add(map);
    }
    return list;
  }

在resources/templates/freemarker下新建center文件夾，新建center.ftl：

<html lang="zh-CN">
<head>
  <meta charset="UTF-8"/>
  <title>${title}</title>
  <style>
    table {
      width: 50%;
      font-size: .938em;
      border-collapse: collapse;/*邊框合并*/
    }
    th {
      text-align: left;
      padding: .5em .5em;
      font-weight: bold;
      background: #66677c;color: #fff;
    }
    td {
      padding: .5em .5em;
      border-bottom: solid 1px #ccc;
    }
    table,table tr th, table tr td { border:1px solid #0094ff; }/*設(shè)置邊框*/
  </style>
</head>
<body>
<table>
  <tr>
    <th>Name</th>
    <th>Age</th>
    <th>Phone</th>
  </tr>
    <#list users as user>
      <tr>
        <td>${user.name}</td>
        <td>${user.age}</td>
        <td>${user.phone}</td>
      </tr>
    </#list>
</table>
</body>
</html>

瀏覽器請求：