什么是FreeMarker舵稠？
FreeMarker 是一款 模板引擎： 即一種基于模板和要改變的數據， 并用來生成輸出文本(HTML網頁死姚，電子郵件爽丹，配置文件，源代碼等)的通用工具绿满。 它不是面向最終用戶的臂外，而是一個Java類庫，是一款程序員可以嵌入他們所開發(fā)產品的組件喇颁。
模板編寫為FreeMarker Template Language (FTL)漏健。它是簡單的，專用的語言橘霎， 不是 像PHP那樣成熟的編程語言蔫浆。 那就意味著要準備數據在真實編程語言中來顯示，比如數據庫查詢和業(yè)務運算姐叁， 之后模板顯示已經準備好的數據瓦盛。在模板中，你可以專注于如何展現(xiàn)數據外潜， 而在模板之外可以專注于要展示什么數據原环。
這種方式通常被稱為 MVC (模型 視圖 控制器) 模式，對于動態(tài)網頁來說处窥，是一種特別流行的模式嘱吗。 它幫助從開發(fā)人員(Java 程序員)中分離出網頁設計師(HTML設計師)。設計師無需面對模板中的復雜邏輯碧库， 在沒有程序員來修改或重新編譯代碼時柜与，也可以修改頁面的樣式。
而FreeMarker最初的設計嵌灰，是被用來在MVC模式的Web開發(fā)框架中生成HTML頁面的弄匕，它沒有被綁定到 Servlet或HTML或任意Web相關的東西上。它也可以用于非Web應用環(huán)境中沽瞭。
FreeMarker和springboot整合
首先迁匠，pom.xml中導入freemarker的依賴：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>
在application.properties(或yml)配置文件中加入freemarker相關配置：
# freemarker靜態(tài)資源配置
# 設定ftl文件路徑
spring.freemarker.tempalte-loader-path=classpath:/templates
# 關閉緩存，及時刷新驹溃，上線生產環(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（上面配置文件中已經指定了freemarker模板的文件后綴為ftl）：
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8"/>
<title></title>
</head>
<body>
<h1>hello,${var}</h1>
</body>
</html>
新建Controller包豌鹤，新建FreeMarkerController類：
```package com.example.springboot.Controller;
import org.springframework.stereotype.Controller;
import org.springframework.ui.ModelMap;
import org.springframework.web.bind.annotation.RequestMapping;
/**
* Created by Administrator on 2019/5/11.
*/
@Controller
@RequestMapping("/ftl")
public class FreeMarkerController {
@RequestMapping("/index")
public String index(ModelMap modelMap){
modelMap.addAttribute("var","FreeMarker");
return "freemarker/index";
}
}
這里的ModelMap就相當于SpringMVC中的ModelAndView亡哄，其中的很多方法也很類似，我們這里返回的字符串就是freemarker模板的路徑布疙，不用寫后綴蚊惯，因為配置文件中已經指定了后綴為.ftl
瀏覽器發(fā)起請求，得到結果：
這樣灵临，SpringBoot整合freemarker就好了截型。
FreeMarker的一些基本語法
-
取值
Freemarker中通過${}方式取值
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8"/>
<title></title>
</head>
<body>
<h1>FreeMarker取值</h1>
<ul>
<li>
整型: <font color="red">${int}</font>
</li>
<li>
長整型: <font color="red">${long}</font>
</li>
<li>
字符串: <font color="red">${str}</font>
</li>
</ul>
</body>
</html>
在controller中添加方法
@RequestMapping(value = "/list")
public String list(ModelMap modelMap){
modelMap.addAttribute("int",1000);
modelMap.addAttribute("long",100000000L);
modelMap.addAttribute("str","freemarker");
return "freemarker/list";
}
瀏覽器請求結果：
注意：在Freemarker中無法輸出Boolean類型，直接輸出會報如下錯誤：
可以用bool?string('true','false')來進行格式化
-
Date類型的格式化
Date類型是非常常見的一種數據格式儒溉，F(xiàn)reemarker中是無法進行直接輸出的宦焦，要對Date類型進行格式化。
Freemarker中格式化是以date?string('yyyy-MM-dd')這種方式實現(xiàn)的顿涣。
-
null和不存在的變量的取值
在開發(fā)中常常遇到空值的情況波闹，在Freemarker中直接通過 {}取空值或者不存在的變量會報錯。此時可以用!來進行空值判斷园骆，如${null!'我是空值'},其中舔痪！會判斷變量是不是為空，如果變量為空就輸出后面的默認值锌唾。(開發(fā)中可以在變量后面加锄码！，避免Freemarker報錯)
-
變量的賦值和運算
Freemarker中支持變量運算
<#assign var = 100>
var = <font color="#ff5142">${var}</font><br>
var + 100 = <font color="#ff5142">${var+100}</font>
如上代碼中晌涕，通過<#assign var = 100>定義一個變量var = 100滋捶，在${var+100}中進行了變量的加法運算
-
自定義對象取值
Freemarker中對于對象取值的方式是通過 . 來實現(xiàn)的，前面說余黎！可以判斷變量是否為空重窟，但是只判斷最近的一個變量，在這種object.val中就無法判斷惧财，可以用（object.val）!來判斷巡扇。
-
List和Map的遍歷
在controller中添加list和map
List list = new ArrayList();
list.add("Java");
list.add("python");
list.add("php");
modelMap.addAttribute("list",list);
Map map = new HashMap();
map.put("java","hello,java");
map.put("python","hello,python");
map.put("php","hello,php");
modelMap.put("map",map);
在ftl中遍歷
<#list list as item>
${item}<br/>
</#list>
<#list map?keys as key>
${key}:${map[key]}<br/>
</#list>
瀏覽器中訪問
-
if語法
Freemarker中表達式都是<#+表達式扭仁，F(xiàn)reemarker的if表達式和Java中類似。
<#assign var = 999>
<#if var == 999>
var = 999
<#elseif var == 888>
var = 888
<#else >
var = 111
</#if>
-
switch語法
Freemarker和Java一樣支持switch語法
<#switch var>
<#case 10>
10
<#break >
<#case 11>
11
<#break >
<#case 12>
12
<#break >
<#default>
</#switch>
-
字符串的基本操作指令
字符串常用的內建函數
- 字符串連接 +
<#assign vara = 'abc'>
<#assign varb = 'efg'>
${vara+varb}
- substring
<#assign varc = 'asdfghjkl'>
${varc?substring(2,5)}
- length
<#assign varc = 'asdfghjkl'>
${varc?length}
- 大小寫
<#assign varc = 'asdfghjkl'>
${varc?upper_case}
<#assign varc = 'asdfghjkl'>
${varc?lower_case}
-
Freemarker的自定義函數
整數排序sort_int
首先定義一個類并實現(xiàn)TemplateMethodModelEx
package com.example.springboot.util;
import freemarker.template.SimpleSequence;
import freemarker.template.TemplateMethodModelEx;
import freemarker.template.TemplateModelException;
import java.math.BigDecimal;
import java.util.Collection;
import java.util.Collections;
import java.util.Comparator;
import java.util.List;
/**
* Created by Administrator on 2019/5/12.
*/
public class SortMethod implements TemplateMethodModelEx {
@Override
public Object exec(List list) throws TemplateModelException {
SimpleSequence simpleSequence = (SimpleSequence) list.get(0);
//SimpleSequence 是Freemarker里的數據類型代表數組或list厅翔，Java從Freemarker取值時不能直接強轉
//必須先用Freemarker的數據類型取出來然后進行轉換
List<BigDecimal> lists = simpleSequence.toList();
Collections.sort(lists, new Comparator<BigDecimal>() {
@Override
public int compare(BigDecimal o1,BigDecimal o2){
return o1.intValue()-o2.intValue();//升序
}
});
return lists;
}
}
上面就實現(xiàn)了一個自定義的函數乖坠，那么怎么去使用呢？可以通過controller傳到Freemarker頁面
@RequestMapping(value = "/sortint")
public String testFunction(ModelMap modelMap){
modelMap.addAttribute("sort_int",new SortMethod());
return "freemarker/sortint";
}
傳到頁面之后的調用和Java中調用方法的方式有點類似
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8"/>
<title></title>
</head>
<body>
<#assign myList = [2,1,3,4,7,5,8,6,9]>
<h5>未排序</h5>
<#list myList as item>
${item}
</#list>
<h5>已排序</h5>
<#list sort_int(myList) as item>
${item}
</#list>
</body>
</html>
結果如下
-
List常用函數
上面介紹自定義的排序函數刀闷，其實Freemarker里面已經實現(xiàn)了排序函數,通過<#list myList?sort as item>來調用
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8"/>
<title></title>
</head>
<body>
<#assign myList = [2,1,3,4,7,5,8,6,9]>
<h5>未排序</h5>
<#list myList as item>
${item}
</#list>
<h5>已排序</h5>
<#list myList?sort as item>
${item}
</#list>
</body>
</html>
還有許多函數如 逆序排序<#list myList?sort熊泵？reverse as item>，取list長度{myList[3]}等等......
-
其他常用的內建函數
cap_first 首字母變大寫
ends_with 以...結尾
contains 包含
date 把字符串轉成date
datetime 把字符串轉成datetime
time 把字符串轉成time
甸昏？string('0.##') 把字符串變成兩位小數
is_string is_number 判斷變量是不是string是不是number
