页面静态化Freemaker

1、简介
网站的web前端要实现高效，第一个要解决的短板就是网络的延迟性对网站的加载效率的影响，网站本身的确是没法控制网络速度的能力，但是如果我们不降低网络对页面加载效率的影响，
大型动态网站之所以可以做到能快速响应高并发，它们都是尽量让自己的网站静态化，当然这种静态化绝不是把网站就做成静态网站，而是在充分理解了静态网站在提升网站响应速度的基础上对动态网站进行改良。网站静态化的关键点是动静分离，解决这个关键点的本质就是为了降低网速对网站加载效率的影响。
静态网页的资源基本是不会发生变化的。因此我们第一次访问一个静态网页和我们以后访问这个静态网页都是一个重复的请求，这种网站加载的速度基本都是由网络传输的速度，以及每个资源请求的大小所决定，既然访问的资源基本不会发生变化，那么我们重复请求这些资源，自己在那里空等不是很浪费时间吗？如是乎，浏览器出现了缓存技术，我们开发时候可以对那些不变的资源在http协议上编写相应指令，这些指令会让浏览器第一次访问到静态资源后缓存起这些静态资源，用户第二次访问这个网页时候就不再需要重复请求了，因为请求资源本地缓存，那么获取它的效率就变得异常高效。

2、Freemarker的介绍
Freemarker 是一款模板引擎，是一种基于模版生成静态文件的通用工具，它是为Java程序员提供的一个开发包，或者说是一个类库，它不是面向最终用户的，而是为程序员提供了一款可以嵌入他们开发产品的应用程序。
Freemarker 是使用纯java编写的，为了提高页面的访问速度，需要把页面静态化，
那么Freemarker就是被用来生成html页面。
使用:Freemarker的准备条件

<dependency>
<groupId>org.freemarker</groupId>
<artifactId>freemarker</artifactId>
<version>2.3.23</version>
</dependency>

3、Freemarker生成静态页面的原理
Freemarker 生成静态页面，首先需要使用自己定义的模板页面，这个模板页面可以是最最普通的html，也可以是嵌套freemarker中的取值表达式，标签或者自定义标签等等，然后后台读取这个模板页面，解析其中的标签完成相对应的操作，然后采用键值对的方式传递参数替换模板中的的取值表达式，做完之后根据配置的路径生成一个新的html页面，以达到静态化访问的目的。
4、Freemarker提供的标签
Freemarker提供了很多有用常用的标签，Freemarker标签都是<#标签名称>这样子命名的，${value} 表示输出变量名的内容，具体如下：
4.1、<#list>
该标签主要是进行迭代服务器端传递过来的List集合，比如：
<#list nameList as names>
${names}
</#list>

names是list循环的时候取的一个循环变量，freemarker在解析list标签的时候，等价于：
for (String names : nameList) {
System.out.println(names);
}

4.2、if
该标签主要是做if判断用的，比如：
<#if (names==“谢大脚”)>
开了个超市
</#if>
注意:if后面有空格

这个是条件判断标签，要注意的是条件等式必须用括号括起来，等价于：
if(names.equals(“陈靖仇”)){
System.out.println(“他的武器是: 十五~~”);
}

4.3、include
该标签用于导入文件用的。
<#include “include.html”/>

这个导入标签非常好用，特别是页面的重用。
4.4、使用$ {}取值
另外在静态文件中可以使用${} 获取值，取值方式和el表达式一样，非常方便。

下面举个例子（static.html）：

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
</head>
<body>
<h3>描述：${description} </h3>
<h3>集合大小:${nameList?size} </h3>
<h3>迭代list集合： </h3>
<#list nameList as names>
这是第${names_index+1}个人，叫做：<label style="color:red">${names}</label>
if判断：  <br/>
<#if (names=="陈靖仇")>
他的武器是: 十五~~
<#elseif (names=="宇文拓")>
<#--注意这里没有返回而是在最后面-->
他的武器是: 轩辕剑~·
<#else>
她的绝招是：蛊毒~~
</#if>
<br/>
</#list>
<h3>迭代map集合：  </h3>
<#list mytestmap?keys as key>
key--->${key}<br/>
value----->${mytestmap[key]!("null")}
<#--fremarker 不支持null, 可以用！ 来代替为空的值。
其实也可以给一个默认值
value-----${mytestmap[key]?default("null")}
还可以 在输出前判断是否为null
<#if mytestmap[key]??></#if>都可以  -->
</#list>
<h3>include导入文件：  </h3>
<#include "include.html"/>
</body>
</html>

JAVA代码：
package test;

import freemarker.template.Configuration;
import freemarker.template.DefaultObjectWrapper;
import freemarker.template.Template;
import freemarker.template.TemplateException;

import java.io.*;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

public class Demo1 {
public static void main(String[] args) {try {//创建一个Configration对象Configuration configuration = new Configuration();//设置模板加载的路径String path="F:\\1000phone\\BJ-2班\\workspace\\easyFreemarkertest\\src\\main\\java\\template";configuration.setDirectoryForTemplateLoading(new File(path));configuration.setObjectWrapper(new DefaultObjectWrapper());//设置编码方式（这个一定要设置，不然在生成的页面中 会乱码）configuration.setDefaultEncoding("UTF-8");//得到模板文件名称Template template = configuration.getTemplate("static.html");Map<String, Object> paramMap = new HashMap<String, Object>();paramMap.put("description", "我正在学习使用Freemarker生成静态文件！");List<String> nameList = new ArrayList<String>();nameList.add("陈靖仇");nameList.add("玉儿");nameList.add("宇文拓");paramMap.put("nameList", nameList);Map<String, Object> weaponMap = new HashMap<String, Object>();weaponMap.put("first", "轩辕剑");weaponMap.put("second", "崆峒印");weaponMap.put("third", "女娲石");weaponMap.put("fourth", "神农鼎");weaponMap.put("fifth", "伏羲琴");weaponMap.put("sixth", "昆仑镜");weaponMap.put("seventh", null);paramMap.put("mytestmap", weaponMap);Writer writer  = new OutputStreamWriter(new FileOutputStream("success.html"),"UTF-8");template.process(paramMap, writer);System.out.println("恭喜，生成成功~~");} catch (IOException e) {e.printStackTrace();} catch (TemplateException e) {e.printStackTrace();}}

}

结果:

<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>Title</title>
</head>
<body>
<h3>描述：我正在学习使用Freemarker生成静态文件！ </h3>
<h3>集合大小:3 </h3>
<h3>迭代list集合： </h3>
这是第1个人，叫做：<label style="color:red">陈靖仇</label>
if判断：  <br/>
他的武器是: 十五~~
<br/>
这是第2个人，叫做：<label style="color:red">玉儿</label>
if判断：  <br/>
她的绝招是：蛊毒~~
<br/>
这是第3个人，叫做：<label style="color:red">宇文拓</label>
if判断：  <br/>
他的武器是: 轩辕剑~·
<br/>
<h3>迭代map集合：  </h3>
key--->sixth<br/>
value----->昆仑镜
key--->third<br/>
value----->女娲石
key--->seventh<br/>
value----->null
key--->fifth<br/>
value----->伏羲琴
key--->fourth<br/>
value----->神农鼎
key--->first<br/>
value----->轩辕剑
key--->second<br/>
value----->崆峒印
<h3>include导入文件：  </h3>
<h1>我是include的内容
</h1>
</body>
</html>

5.freemarker常用命令总结
FTL指令常用标签及语法
注意：使用freemaker，要求所有标签必须闭合，否则会导致freemaker无法解析。

freemaker注释:<#-- 注释内容 -->格式部分,不会输出

---------------------------------- 基础语法 ----------------------------------
1、字符输出
${emp.name?if_exists}　　　　　　// 变量存在，输出该变量，否则不输出
${emp.name!}　　　　　　　　　　 // 变量存在，输出该变量，否则不输出

${emp.name?default(“xxx”)} // 变量不存在，取默认值xxx
${emp.name!“xxx”} 　　　　　　// 变量不存在，取默认值xxx
常用内部函数：

${“123
456”?html} 　　// 对字符串进行HTML编码，对html中特殊字符进行转义
${“str”?cap_first} 　　 // 使字符串第一个字母大写
${“Str”?lower_case} // 将字符串转换成小写
${“Str”?upper_case} // 将字符串转换成大写
${“str”?trim} // 去掉字符串前后的空白字符
字符串的两种拼接方式拼接：

$ {“hello${emp.name!}”} // 输出hello+变量名
${“hello”+emp.name!} // 使用+号来连接，输出hello+变量名
可以通过如下语法来截取子串:

<#assign str = “abcdefghijklmn”/>

// 方法1
${str?substring(0,4)} // 输出abcd

// 方法2
$ {str[0]}$ {str[4]} // 结果是ae
${str[1…4]} 　　　 // 结果是bcde

// 返回指定字符的索引
${str?index_of(“n”)}
2、日期输出
${emp.date?string(‘yyyy-MM-dd’)} //日期格式

date: 只显示日期，不显示时间.
如$ {createTime?date} 或$ {createTime?date(‘yyyy-MM-dd’)}
time: 只显示时间，不显示日期
如$ {createTime?time} 或$ {createTime?time(‘hh:mm:ss’)}
datetime: 时间和日期同时显示
如$ {createTime} 或$ {createTime?datetime(‘yyyy-MM-dd hh:mm:ss’)}或${createTime?string(‘yyyy-MM-dd hh:mm:ss’)}

3、数字输出(以数字20为例)
${emp.name?string.number} 　// 输出20
${emp.name?string.currency} // ￥20.00
${emp.name?string.percent} // 20%
${1.222?int} 　　　　　　　　　　 // 将小数转为int，输出1

<#setting number_format=“percent”/> // 设置数字默认输出方式(‘percent’,百分比)
<#assign answer=42/> 　　　　　　　　 // 声明变量 answer 42
#{answer} 　　　　　　　　 // 输出 4,200%
${answer?string} 　　　　 // 输出 4,200%
${answer?string.number} 　　// 输出 42
${answer?string.currency} // 输出￥42.00
${answer?string.percent} 　// 输出 4,200%
#{answer} 　　　　　　　　// 输出 42
数字格式化插值可采用#{expr;format}形式来格式化数字,其中format可以是:
mX:小数部分最小X位
MX:小数部分最大X位
如下面的例子:
<#assign x=2.582/>
<#assign y=4/>
#{x; M2} // 输出2.58
#{y; M2} // 输出4
#{x; m2} // 输出2.58
#{y; m2} // 输出4.0
#{x; m1M2} // 输出2.58
#{x; m1M2} // 输出4.0
4、申明变量
<#assign foo=false/> // 声明变量,插入布尔值进行显示,注意不要用引号
${foo?string(“yes”,“no”)} // 当为true时输出"yes",否则输出"no"
申明变量的几种方式

<#assign name=value>
<#assign name1=value1 name2=value2 … nameN=valueN>
<#assign same as above… in namespacehash>

<#assign name>
capture this
</#assign>

<#assign name in namespacehash>
capture this
</#assign>
5、比较运算符

表达式中支持的比较运算符有如下几个:
= 或 == ：判断两个值是否相等.
!= ：判断两个值是否不等.

或 gt ：判断左边值是否大于右边值
= 或 gte ：判断左边值是否大于等于右边值
< 或 lt ：判断左边值是否小于右边值
<= 或 lte ：判断左边值是否小于等于右边值

6、算术运算符
FreeMarker表达式中完全支持算术运算,
FreeMarker支持的算术运算符包括:+, - , * , / , %
注意：
（1）、运算符两边必须是数字
（2）、使用+运算符时,如果一边是数字,一边是字符串,就会自动将数字转换为字符串再连接,如:${3 + “5”},结果是:35

7、逻辑运算符
逻辑运算符有如下几个:
逻辑与:&&
逻辑或:||
逻辑运算符只能作用于布尔值,否则将产生错误

8、FreeMarker中的运算符优先级
FreeMarker中的运算符优先级如下(由高到低排列):
①、一元运算符:!
②、内建函数:?
③、乘除法:*, / , %
④、加减法:- , +
⑤、比较:> , < , >= , <= (lt , lte , gt , gte)
⑥、相等:== , = , !=
⑦、逻辑与:&&
⑧、逻辑或:||
⑨、数字范围:…
实际上,我们在开发过程中应该使用括号来严格区分,这样的可读性好,出错少

9、if 逻辑判断（注意：elseif 不加空格）
<#if condition>
…
<#elseif condition2>
…
<#elseif condition3>
…
<#else>
…
</#if>
if 空值判断

// 当 photoList 不为空时
<#if photoList??>…</#if>

值得注意的是,$ {…}只能用于文本部分,不能用于表达式,下面的代码是错误的:
<#if KaTeX parse error: Expected 'EOF', got '#' at position 15: {isBig}>Wow!</#̲if> <#if "{isBig}">Wow!</#if>

// 正确写法
<#if isBig>Wow!</#if>
10、switch (条件可为数字，可为字符串)
<#switch value>
<#case refValue1>
…
<#break>
<#case refValue2>
…
<#break>
<#case refValueN>
…
<#break>
<#default>
…
</#switch>
11、集合 & 循环
// 遍历集合:
<#list empList! as emp>
${emp.name!}
</#list>

// 可以这样遍历集合:
<#list 0…(empList!?size-1) as i>
${empList[i].name!}
</#list>

// 与jstl循环类似,也可以访问循环的状态。

empList?size 　　　// 取集合的长度
emp_index: 　　　　// int类型，当前对象的索引值
emp_has_next: // boolean类型，是否存在下一个对象

// 使用<#break>跳出循环
<#if emp_index = 0><#break></#if>

// 集合长度判断
<#if empList?size != 0></#if> // 判断=的时候,注意只要一个=符号,而不是==

<#assign l=0…100/> // 定义一个int区间的0~100的集合，数字范围也支持反递增,如100…2
<#list 0…100 as i> 　　// 等效于java for(int i=0; i <= 100; i++)
　　${i}
</#list>

// 截取子集合：
empList[3…5] //返回empList集合的子集合,子集合中的元素是empList集合中的第4-6个元素

// 创建集合：
<#list [“星期一”, “星期二”, “星期三”, “星期四”, “星期五”, “星期六”, “星期天”] as x>

// 集合连接运算,将两个集合连接成一个新的集合
<#list [“星期一”,“星期二”,“星期三”] + [“星期四”,“星期五”,“星期六”,“星期天”] as x>

// 除此之外,集合元素也可以是表达式,例子如下:
[2 + 2, [1, 2, 3, 4], “whatnot”]

// seq_contains：判断序列中的元素是否存在
<#assign x = [“red”, 16, “blue”, “cyan”]>
${x?seq_contains(“blue”)?string(“yes”, “no”)} // yes
${x?seq_contains(“yellow”)?string(“yes”, “no”)} // no
${x?seq_contains(16)?string(“yes”, “no”)} // yes
${x?seq_contains(“16”)?string(“yes”, “no”)} // no

// seq_index_of：第一次出现的索引
<#assign x = [“red”, 16, “blue”, “cyan”, “blue”]>
${x?seq_index_of(“blue”)} // 2

// sort_by：排序（升序）
<#list movies?sort_by(“showtime”) as movie></#list>

// sort_by：排序（降序）
<#list movies?sort_by(“showtime”)?reverse as movie></#list>

// 具体介绍：
// 不排序的情况：
<#list movies as moive>
　　${moive.name}
</#list>

//要是排序，则用
<#list movies?sort as movie>
　　${movie.name}
</#list>

// 这是按元素的首字母排序。若要按list中对象元素的某一属性排序的话，则用
<#list moives?sort_by([“name”]) as movie>
　　${movie.name}
</#list>

//这个是按list中对象元素的[name]属性排序的，是升序，如果需要降序的话，如下所示：
<#list movies?sort_by([“name”])?reverse as movie>
　　${movie.name}
</#list>
12、Map对象
// 创建map
<#assign scores = {“语文”:86,“数学”:78}>

// Map连接运算符
<#assign scores = {“语文”:86,“数学”:78} + {“数学”:87,“Java”:93}>

// Map元素输出
emp.name // 全部使用点语法
emp[“name”] // 使用方括号
13、FreeMarker支持如下转义字符:
" ：双引号(u0022)
’ ：单引号(u0027)
\ ：反斜杠(u005C)
\n ：换行(u000A)
\r ：回车(u000D)
\t ：Tab(u0009)
\b ：退格键(u0008)
\f ：Form feed(u000C)
\l ：<
\g ：>
\a ：&
{ ：{
\xCode ：直接通过4位的16进制数来指定Unicode码,输出该unicode码对应的字符.

如果某段文本中包含大量的特殊符号,FreeMarker提供了另一种特殊格式:可以在指定字符串内容的引号前增加r标记,在r标记后的文件将会直接输出.看如下代码:
$ {r"${foo}"} // 输出 ${foo}
${r"C:/foo/bar"} // 输出 C:/foo/bar

14、include指令
// include指令的作用类似于JSP的包含指令:
<#include “/test.ftl” encoding=“UTF-8” parse=true>

// 在上面的语法格式中,两个参数的解释如下:
encoding=“GBK” // 编码格式
parse=true 　　 // 是否作为ftl语法解析,默认是true，false就是以文本方式引入,注意:在ftl文件里布尔值都是直接赋值的如parse=true,而不是parse=“true”
15、import指令
// 类似于jsp里的import,它导入文件，然后就可以在当前文件里使用被导入文件里的宏组件
<#import “/libs/mylib.ftl” as my>
// 上面的代码将导入/lib/common.ftl模板文件中的所有变量,交将这些变量放置在一个名为com的Map对象中，"my"在freemarker里被称作namespace
16、compress 压缩
// 用来压缩空白空间和空白的行
<#compress>
…
</#compress>
<#t> // 去掉左右空白和回车换行

<#lt>// 去掉左边空白和回车换行

<#rt>// 去掉右边空白和回车换行

<#nt>// 取消上面的效果
17、escape,noescape 对字符串进行HTML编码
// escape指令导致body区的插值都会被自动加上escape表达式,但不会影响字符串内的插值,只会影响到body内出现的插值,使用escape指令的语法格式如下:
<#escape x as x?html>
　　First name: ${firstName}
<#noescape>Last name: ${lastName}</#noescape>
　　Maiden name: ${maidenName}
</#escape>

// 相同表达式
First name: ${firstName?html}
Last name: ${lastName}
Maiden name: ${maidenName?html}
---------------------------------- 高级语法 ----------------------------------
1、global全局赋值语法
<#global name=value>

<#global name1=value1 name2=value2 … nameN=valueN>

<#global name>
　　capture this
</#global>

// 利用这个语法给变量赋值，那么这个变量在所有的namespace中是可见的，如果这个变量被当前的assign语法覆盖如<#global x=2><#assign x=1>在当前页面里x=2将被隐藏，或者通过${.globals.x} 来访问
2、setting 语法
// 用来设置整个系统的一个环境
locale // zh_CN 中文环境
number_format
boolean_format
date_format , time_format , datetime_format
time_zone
classic_compatible
// 例1：
<#setting number_format=“percent”/> // 设置数字默认输出方式(‘percent’,百分比)

// 例2：
// 假如当前是匈牙利的设置，然后修改成美国
${1.2} // 输出1,2
<#setting locale=“en_US”>
${1.2} // 输出1.2,因为匈牙利是采用", “作为十进制的分隔符，美国是用”. "
3、macro宏指令
例子1：

<#-- 定义宏 -->
<#macro test foo bar=“Bar” baaz=-1>
　　Text: ${foo}, ${bar}, ${baaz}
</#macro>

<#-- 使用宏 -->
<@test foo=“a” bar=“b” baaz=55/> // 输出：Text: a, b, 25
<@test foo=“a” bar=“b”/> 　　　　// 输出：Text: a, b, -1
<@test foo=“a” baaz=55-2/> 　　　　// 输出：Text: a, Bar, 23
<@test foo=“a”/> // 输出：Text: a, Bar, -1
例子2：

<#-- 定义一个循环输出的宏 -->
<#macro list title items>
　　KaTeX parse error: Expected 'EOF', got '#' at position 12: {title} 　　<#̲list items as x…{x}
　　</#list>
</#macro>

<#-- 使用宏 -->
<@list items=[“mouse”, “elephant”, “python”] title=“Animals”/>
// 输出Animals *mouse *elephant *python
例子3：

<#-- 嵌套宏 -->

<#macro border>

< table>
　　　　 <#nested>
　　 < /table>
</#macro>

<#-- 嵌套宏使用 -->
<@border>
　　< tr>< td>hahaha< /td>< /tr>
/@border
输出结果：
< table>
　　< tr>< td>hahaha< /td>< /tr>
< /table>

例子4：在nested指令中使用循环变量时,可以使用多个循环变量,看如下代码:

<#-- 循环嵌套宏 -->
<#macro repeat count>
　　<#list 1…count as x>
　　　　<#nested x, x/2, x==count> // 使用nested指令时指定了三个循环变量
　　</#list>
</#macro>

<#-- 使用宏 -->
<@repeat count = 4; c, halfc, last>
　　${c}. ${halfc}<#if last> Last!</#if>
< /@repeat>
// 输出结果：
// 1. 0.5
// 2. 1
// 3. 1.5
// 4. 2 Last!
freemarker 宏嵌套nested 的使用:
http://blog.sina.com.cn/s/blog_7e5699790100z59g.html

4、结束macro指令
// return指令用于结束macro指令
<#-- 创建宏 -->
<#macro book>
　　spring
　　<#return>
　　j2ee
</#macro>

<#-- 使用宏 -->
<@book />
// 上面的代码输出:spring,而j2ee位于return指令之后,不会输出.

6.springboot整合freemarker
参考springboot笔记1–知识点15