一、FreeMaker介绍

FreeMarker是一款免费的Java模板引擎，是一种基于模板和数据生成文本（HMLT、电子邮件、配置文件、源代码等）的工具，它不是面向最终用户的，而是一款程序员使用的组件。

FreeMarker最初设计是用来在MVC模式的Web开发中生成HTML页面的，所以没有绑定Servlet或任意Web相关的东西上，所以它可以运行在非Web应用环境中。

发展史

FreeMarker第一版在1999年未就发布了，2002年初使用JavaCC（Java Compiler Compiler是一个用Java开发的语法分析生成器）重写了FreeMarker的核心代码，2015年FreeMarker代码迁移到了Apache下。

GitHub地址：https://github.com/apache/freemarker

工作原理

FreeMarker模板存储在服务器上，当有用户访问的时候，FreeMarker会查询出相应的数据，替换模板中的标签，生成最终的HTML返回给用户，如下图：

二、FreeMarker基础使用

基础使用分为3部分，这3部分组成了FreeMarker：

• 指令
• 表达式

指令是FreeMarker用来识别转换的特殊标签，表达式是标签里具体的语法实现，其他部分是一些不好分类的模板。

2.1 指令

使用FTL（freemarker template language）标签来调用指令。

指令速览：

• assign
• attempt, recover
• compress
• escape, noescape
• flush
• ftl
• function, return
• global
• if, else, elseif
• import
• include
• list, else, items, sep, break
• local
• macro, nested, return
• noparse
• nt
• setting
• stop
• switch, case, default, break
• t, lt, rt
• visit, recurse, fallback
• 用户自定义标签

下来我们分别来看每个指令对应具体使用。

2.1.1 assign 代码声明

assign 分为变量和代码片段声明两种。

2.1.1.1 变量声明

可以是单变量声明，或多变量声明，下面是多变量声明的示例：

<#assign name="adam" age=18 "sex"="man"> ${name} - ${age} - ${"sex"}

单个变量的话，只写一个就可以了。

2.1.1.2 代码片段声明

<#assign code>     <#list ["java","golang"] as c>         ${c}     </#list> </#assign> ${code}

其中 ${code} 是用来执行方法的，如果不调用话，代码片段不会执行。

2.1.2 attempt, recover 异常指令

attempt（尝试）, recover（恢复）指令类似于程序的try catch，示例如下：

<#attempt>    i am ${name}    <#recover>    error name </#attempt>

如果有变量“name”就会正常显示，显示“i am xxx”，如果没有变量就会显示“error name”。

2.1.3 compress 压缩代码移除空白行

<#compress>   1 2  3   4    5         test only    I said, test only </#compress>  1 2  3   4    5   test only  I said, test only

效果如下：

对空白不敏感的格式，移除空白行还是挺有用的功能。

2.1.4 escape, noescape 转义，不转义

2.1.4.1 escape使用

<#escape x as x?