FreeMarker
次要内容
FreeMarker 概述
FreeMarker概念
FreeMarker 是一款 模板引擎： 即一种基于模板和要扭转的数据， 并用来生成输入文本(HTML网页，电子邮件，配置文件，源代码等)的通用工具。 是一个Java类库。
FreeMarker 被设计用来生成 HTML Web 页面，特地是基于 MVC 模式的应用程序，将视图从业务逻辑中抽离解决，业务中不再包含视图的展现，而是将视图交给 FreeMarker 来输入。尽管 FreeMarker 具备一些编程的能力，但通常由 Java 程序筹备要显示的数据，由 FreeMarker 生成页面，通过模板显示筹备的数据（如下图）:
FreeMarker不是一个Web利用框架，而适宜作为Web利用框架一个组件。
FreeMarker与容器无关，因为它并不知道HTTP或Servlet。FreeMarker同样能够利用
于非Web应用程序环境。
FreeMarker更适宜作为Model2框架（如Struts）的视图组件，你也能够在模板中应用
JSP标记库。
FreeMarker个性
通用指标
可能生成各种文本：HTML、XML、RTF、Java 源代码等等
易于嵌入到你的产品中：轻量级；不须要 Servlet 环境
插件式模板载入器：能够从任何源载入模板，如本地文件、数据库等等
你能够按你所需生成文本：保留到本地文件；作为 Email 发送；从 Web 应用程序发送它返回给 Web 浏览器
弱小的模板语言
所有罕用的指令：include、if/elseif/else、循环构造
在模板中创立和扭转变量
简直在任何中央都能够应用简单表达式来指定值
命名的宏，能够具备地位参数和嵌套内容
名字空间有助于建设和保护可重用的宏库，或将大工程分成模块，而不用放心名字抵触
输入转换块：在嵌套模板片段生成输入时，转换HTML本义、压缩、语法高亮等等；你能够定义本人的转换
通用数据模型
FreeMarker不是间接反射到Java对象，Java对象通过插件式对象封装，以变量形式在模板中显示
你能够应用形象（接口）形式示意对象（JavaBean、XML文档、SQL查问后果集等等），通知模板开发者应用办法，使其不受技术细节的打搅
为Web筹备
在模板语言中内建解决典型Web相干工作（如HTML本义）的构造
可能集成到Model2 Web利用框架中作为JSP的代替
反对JSP标记库
为MVC模式设计：拆散可视化设计和利用程序逻辑；拆散页面设计员和程序员
智能的国际化和本地化
字符集智能化（外部应用UNICODE）
数字格局本地化敏感
日期和工夫格局本地化敏感
非US字符集能够用作标识（如变量名）
多种不同语言的雷同模板
弱小的XML解决能力
<#recurse> 和 <#visit> 指令（2.3版本）用于递归遍历XML树。在模板中分明和间接的拜访XML对象模型。开源论坛 JForum 就是应用了 FreeMarker 做为页面模板。
FreeMarker环境搭建
新建 Maven Web我的项目
配置坐标依赖和部署插件
pom.xml
<?xml version="1.0" encoding="UTF-8"?><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.xxxx</groupId> <artifactId>freemarker</artifactId> <version>1.0-SNAPSHOT</version> <packaging>war</packaging> <name>freemarker Maven Webapp</name> <!-- FIXME change it to the project's website --> <url>http://www.example.com</url> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <maven.compiler.source>1.8</maven.compiler.source> <maven.compiler.target>1.8</maven.compiler.target> </properties> <dependencies> <!-- freemarker的坐标依赖 --> <dependency> <groupId>org.freemarker</groupId> <artifactId>freemarker</artifactId> <version>2.3.23</version> </dependency> <!-- servlet-api的坐标依赖 --> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>3.0.1</version> </dependency> </dependencies> <build> <finalName>freemarker</finalName> <!-- 插件地址： Tomcat http://tomcat.apache.org/maven-plugin-2.2/ Jetty https://www.eclipse.org/jetty/documentation/current/jetty-maven-plugin.html --> <plugins> <!-- 配置jetty插件 --> <plugin> <groupId>org.eclipse.jetty</groupId> <artifactId>jetty-maven-plugin</artifactId> <version>9.2.1.v20140609</version> </plugin> </plugins> </build></project> 批改配置文件 web.xml
在我的项目的webapp/WEB-INF目录下的web.xml文件中，增加freemarker 相干 servlet 配置
<?xml version="1.0" encoding="UTF-8"?><web-app id="WebApp_ID" version="3.0" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"> <!-- FreeMarker 的Servlet配置 --> <servlet> <servlet-name>freemarker</servlet-name> <servlet-class>freemarker.ext.servlet.FreemarkerServlet</servlet-class> <init-param> <!-- 模板门路 --> <param-name>TemplatePath</param-name> <!-- 默认在webapp目录下查找对应的模板文件 --> <param-value>/</param-value> </init-param> <init-param> <!-- 模板默认的编码：UTF-8 --> <param-name>default_encoding</param-name> <param-value>UTF-8</param-value> </init-param> </servlet> <!-- 解决所有以.ftl结尾的文件；ftl是freemarker默认的文件后缀 --> <servlet-mapping> <servlet-name>freemarker</servlet-name> <url-pattern>*.ftl</url-pattern> </servlet-mapping></web-app> 编写Servlet类
package com.xxxx.controllter;import javax.servlet.ServletException;import javax.servlet.annotation.WebServlet;import javax.servlet.http.HttpServlet;import javax.servlet.http.HttpServletRequest;import javax.servlet.http.HttpServletResponse;import java.io.IOException;@WebServlet("/f01")public class FreeMarker01 extends HttpServlet { @Override protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // 增加数据 request.setAttribute("msg","Hello FreeMarker!"); // 申请转发跳转到ftl文件中 request.getRequestDispatcher("template/f01.ftl").forward(request,response); }} 新建模板文件 ftl
在webapp目录下新建template文件夹，创立f01.ftl文件
启动我的项目
拜访我的项目
浏览器地址栏输出：http://localhost:8989/f01
FreeMarker 数据类型
Freemarker 模板中的数据类型由如下几种：
- 布尔型：等价于 Java 的 Boolean 类型，不同的是不能间接输入，可转换为字符串输入
- 日期型：等价于 java 的 Date 类型，不同的是不能间接输入，须要转换成字符串再输入
- 数值型：等价于 java 中的 int,float,double 等数值类型
有三种显示模式：数值型(默认)、货币型、百分比型
- 字符型：等价于 java 中的字符串，有很多内置函数
- sequence 类型：等价于 java 中的数组，list，set 等汇合类型
- hash 类型：等价于 java 中的 Map 类型
布尔类型
在Servlet中设置布尔类型的数据
// 布尔类型request.setAttribute("flag", true);获取数据
<#-- 数据类型：布尔类型 在freemarker中布尔类型不能间接输入；如果输入要先转成字符串 形式一：?c 形式二：?string 或 ?string("true时的文本","false时的文本")-->${flag?c} <br>${flag?string} <br>${flag?string("yes","no")} <br>
日期类型
在Servlet中设置日期类型的数据
// 日期类型request.setAttribute("createDate",new Date());获取数据
<#-- 数据类型：日期类型 在freemarker中日期类型不能间接输入；如果输入要先转成日期型或字符串 1. 年月日 ?date 2. 时分秒 ?time 3. 年月日时分秒 ?datetime 4. 指定格局 ?string("自定义格局") y：年 M：月 d：日 H：时 m：分 s：秒--><#-- 输入日期格局 -->${createDate?date} <br> <#-- 输入工夫格局 -->${createDate?time} <br> <#-- 输入日期工夫格局 -->${createDate?datetime} <br> <#-- 输入格式化日期格局 -->${createDate?string("yyyy年MM月dd日 HH:mm:ss")} <br>
数值类型
在Servlet设置数值型的数据
// 数值类型request.setAttribute("age",18); // 数值型request.setAttribute("salary",10000); // 数值型request.setAttribute("avg",0.545); // 浮点型获取数据
<#-- 数据类型：数值类型 在freemarker中数值类型能够间接输入； 1. 转字符串 一般字符串 ?c 货币型字符串 ?string.currency 百分比型字符串 ?string.percent 2. 保留浮点型数值指定小数位（#示意一个小数位） ?string["0.##"]--><#-- 间接输入数值型 -->${age} <br>${salary} <br><#-- 将数值转换成字符串输入 -->${salary?c} <br><#-- 将数值转换成货币类型的字符串输入 -->${salary?string.currency} <br><#-- 将数值转换成百分比类型的字符串输入 -->${avg?string.percent} <br><#-- 将浮点型数值保留指定小数位输入 （##示意保留两位小数） -->${avg?string["0.##"]} <br>
字符串类型
在Servlet中设置字符串类型的数据
// 字符串类型request.setAttribute("msg","Hello ");request.setAttribute("msg2","freemarker");获取数据
<#-- 数据类型：字符串类型 在freemarker中字符串类型能够间接输入； 1. 截取字符串（左闭右开） ?substring(start,end) 2. 首字母小写输入 ?uncap_first 3. 首字母大写输入 ?cap_first 4. 字母转小写输入 ?lower_case 5. 字母转大写输入 ?upper_case 6. 获取字符串长度 ?length 7. 是否以指定字符结尾（boolean类型） ?starts_with("xx")?string 8. 是否以指定字符结尾（boolean类型） ?ends_with("xx")?string 9. 获取指定字符的索引 ?index_of("xx") 10. 去除字符串前后空格 ?trim 11. 替换指定字符串 ?replace("xx","xx")--><#-- 间接输入 -->${msg} - ${msg2} <br>${msg?string} - ${msg2?string} <br><#-- 1. 截取字符串（左闭右开） ?substring(start,end) -->${msg2?substring(1,4)} <br><#-- 2. 首字母小写输入 ?uncap_first -->${msg?uncap_first} <br><#-- 3. 首字母大写输入 ?cap_first -->${msg2?cap_first} <br><#-- 4. 字母转小写输入 ?lower_case -->${msg?lower_case} <br><#-- 5. 字母转大写输入 ?upper_case -->${msg?upper_case} <br><#-- 6. 获取字符串长度 ?length -->${msg?length} <br><#-- 7. 是否以指定字符结尾（boolean类型） ?starts_with("xx")?string -->${msg?starts_with("H")?string} <br><#-- 8. 是否以指定字符结尾（boolean类型） ?ends_with("xx")?string -->${msg?ends_with("h")?string} <br><#-- 9. 获取指定字符的索引 ?index_of("xxx") -->${msg?index_of("e")} <br><#-- 10. 去除字符串前后空格 ?trim -->${msg?trim?length} <br><#-- 11. 替换指定字符串 ?replace("xx","xxx") -->${msg?replace("o","a")}<br>
字符串空值状况解决
FreeMarker 的变量必须赋值，否则就会抛出异样。而对于 FreeMarker 来说，null 值和不存在的变量是齐全一样的，因为 FreeMarker 无奈了解 null 值。
FreeMarker 提供两个运算符来防止空值：
① ! ：指定缺失变量的默认值
${value!}：如果value值为空，则默认值是空字符串
${value!“默认值”}：如果value值为空，则默认值是字符串"默认值"
② ?? ：判断变量是否存在
如果变量存在，返回 true，否则返回 false
${(value??)?string}
<#-- 如果值不存在，间接输入会报错 --><#--${str}--><#-- 应用!，当值不存在时，默认显示空字符串 -->${str!}<br><#-- 应用!"xx"，当值不存在时，默认显示指定字符串 -->${str!"这是一个默认值"}<br><#-- 应用??，判断字符串是否为空；返回布尔类型。如果想要输入，须要将布尔类型转换成字符串 -->${(str??)?string}<br> sequence 类型
在Servlet中设置序列类型的数据
// 序列类型 （数组、List、Set）// 数组操作String[] stars = new String[]{"周杰伦","林俊杰","陈奕迅","五月天"};request.setAttribute("stars",stars);// List操作List<String> citys = Arrays.asList("上海","北京","杭州","深圳");request.setAttribute("cityList",citys);// JavaBean汇合List<User> userList = new ArrayList<>();userList.add(new User(1,"zhangsan",22));userList.add(new User(2,"lisi",18));userList.add(new User(3,"wangwu",20));request.setAttribute("userList",userList);获取数据
<#-- 数据类型：序列类型 （数组、List、Set） 通过list指令输入序列 <#list 序列名 as 元素名> ${名称} </#list> 获取序列的长度 ${序列名?size} 获取序列元素的下标 ${元素名?index} 获取第一个元素 ${序列名?first} 获取最初一个元素 ${序列名?last} 倒序输入 序列名?reverse 升序输入 序列名?sort 降序输入 序列名?sort?reverse 指定字段名排序 序列名?sort_by("字段名") 注：个别是JavaBean汇合，对应的字段名须要提供get办法--><#-- 数组操作 --><#list stars as star> 下标：${star?index} -- 名字：${star} <br></#list>数组的长度：${stars?size} <br><#-- 获取第一个元素 -->第一个元素：${stars?first} <br><#-- 获取最初一个元素 -->最初一个元素：${stars?last} <br><hr><#-- List操作 --><#list cityList as city > ${city} <br></#list>List的size：${cityList?size} <br><#-- 倒序输入 --><#list cityList?reverse as city > ${city} -</#list><br><#-- 升序输入 --><#list cityList?sort as city > ${city} -</#list><br><#-- 降序输入 --><#list cityList?sort?reverse as city > ${city} -</#list><hr><#-- JavaBean汇合 --><#list userList as user> 编号：${user.userId} 姓名：${user.uname} 年龄：${user.uage} <br></#list><#-- 依照指定字段名排序 --><#list userList?sort_by("uage") as user> ${user.uname} |</#list>
hash 类型
在Servlet中设置hash类型的数据
// Map操作Map<String,String> cityMap = new HashMap<>();cityMap.put("sh","上海");cityMap.put("bj","北京");cityMap.put("sz","深圳");request.setAttribute("cityMap",cityMap);获取数据
<#-- 数据类型：hash类型 key遍历输入 <#list hash?keys as key> ${key} -- ${hash[key]} </#list> value遍历输入 <#list hash?values as value> ${value} </#list>--><#-- key遍历输入 --><#list cityMap?keys as key> ${key} -- ${cityMap[key]} <br></#list><#-- value遍历输入 --><#list cityMap?values as value> ${value} |</#list>
FreeMarker 常见指令
assign 自定义变量指令
应用 assign 指令你能够创立一个新的变量， 或者替换一个曾经存在的变量。
<#-- assign 自定义变量指令 语法： <#assign 变量名=值> <#assign 变量名=值 变量名=值> （定义多个变量）--><#assign str="hello">${str} <br><#assign num=1 names=["zhangsan","lisi","wangwu"] >${num} -- ${names?join(",")} if elseif else 逻辑判断指令
能够应用 if， elseif 和 else 指令来条件判断是否满足某些条件。
<#-- if, else, elseif 逻辑判断指令 格局： <#if condition> ... <#elseif condition2> ... <#elseif condition3> ... <#else> ... </#if> 注： 1. condition, condition2等：将被计算成布尔值的表达式。 2. elseif 和 else 指令 是可选的。--><#assign score = 80><#if score < 60> 你个小渣渣！ <#elseif score == 60> 分不在高，及格就行！ <#elseif score gt 60 && score lt 80> 哎哟不错哦！ <#else> 你很棒棒哦！</#if><br><#-- 判断数据是否存在 --><#assign list=""><#if list??> 数据存在 <#else> 数据不存在</#if> list 遍历指令
能够应用 list 指令来对序列进行遍历。
<#-- list指令 格局1： <#list sequence as item> </#list> 格局2： <#list sequence as item> <#else> 当没有选项时，执行else指令 </#list> 注： 1. else 局部是可选的 2. sequence： 想要迭代的项，能够是序列或汇合的表达式 3. item： 循环变量 的名称 4. 当没有迭代项时，才应用 else 指令， 能够输入一些非凡的内容而不只是空在那里--><#assign users = ["张三","李四","王五"]><#-- 遍历序列 --><#list users as user> ${user}</#list><br><#--判断数据不为空，再执行遍历 （如果序列不存在，间接遍历会报错）--><#if users2??> <#list users2 as user> ${user} </#list></#if><br><#assign users3 = []><#-- 当序列没有数据项时，应用默认信息 --><#list users3 as user> ${user} <#else> 以后没有数据！</#list> macro 自定义指令
能够应用 macro 指令来自定义一些自定义指令。
<#-- macro 自定义指令 （宏） 1. 根本应用 格局： <#macro 指令名> 指令内容 </#macro> 应用： <@指令名></@指令名> 2. 有参数的自定义指令 格局： <#macro 指令名 参数名1 参数名2> 指令内容 </#macro> 应用： <@指令名 参数名1=参数值1 参数名2=参数值2></@指令名> 注： 1. 指令能够被屡次应用。 2. 自定义指令中能够蕴含字符串，也可蕴含内置指令--><#-- 定义根本的自定义指令 --><#macro address> © 1999–2015 The FreeMarker Project. All rights reserved.</#macro><#-- 应用指令 --><@address></@address> <br><@address></@address><hr><#-- 定义有参数的自定义指令 --><#macro queryUserByName uname> 通过用户名查问用户信息 - ${uname}</#macro><#-- 应用指令，并传递参数 --><@queryUserByName uname="admin"></@queryUserByName> <br><#-- 定义有多个参数的自定义指令 --><#macro queryUserByParams uname uage> 通过多个餐宿查问用户信息 - ${uname} - ${uage}</#macro><#-- 应用指令，并传递多个参数 --><@queryUserByParams uname="admin" uage=18></@queryUserByParams> <br><hr><#-- 自定义指令中蕴含内置指令 --><#macro cfb> <#list 1..9 as i> <#list 1..i as j> ${j}*${i}=${j*i} </#list> <br> </#list></#macro><@cfb></@cfb><@cfb></@cfb><#-- 动态数据 --><#macro cfb2 num> <#list 1..num as i> <#list 1..i as j> ${j}*${i}=${j*i} </#list> <br> </#list></#macro><@cfb2 num=5></@cfb2> nested 占位指令
nested 指令执行自定义指令开始和完结标签两头的模板片段。嵌套的片段能够蕴含模板中任意非法的内容。
<#-- nested 占位指令 nested 相当于占位符,个别联合macro指令一起应用。 能够将自定义指令中的内容通过nested指令占位，当应用自定义指令时，会将占位内容显示。--><#macro test> 这是一段文本！ <#nested> <#nested></#macro><@test><h4>这是文本前面的内容！</h4></@test> import 导入指令
import 指令能够引入一个库。也就是说，它创立一个新的命名空间， 而后在那个命名空间中执行给定门路的模板。能够应用引入的空间中的指令。
commons.ftl
<#macro cfb> <#list 1..9 as i> <#list 1..i as j> ${j}*${i}=${j*i} </#list> <br> </#list></#macro> 在其余ftl页面中通过import导入commons.ftl的命名空间，应用该命名空间中的指令
test.ftl
<#-- 导入命名空间 --><#import "commons.ftl" as common><#-- 应用命名空间中的指令 --><@common.cfb></@common.cfb> include 蕴含指令
能够应用 include 指令在你的模板中插入另外一个 FreeMarker 模板文件 。 被蕴含模板的输入格局是在 include 标签呈现的地位插入的。 被蕴含的文件和蕴含它的模板共享变量，就像是被复制粘贴进去的一样。
<#--蕴含指令(引入其余页面文件) include--><#--html文件--><#include "test.html"> <#--freemarker文件--><#include "test.ftl"> <#--text文件--><#include "test.txt"> FreeMarker 页面动态化
通过上述介绍可知 Freemarker 是一种基于模板的、用来生成输入文本的通用工具,所以
咱们必须要定制合乎本人业务的模板，而后生成本人的 html 页面。Freemarker 是通过
freemarker.template.Configuration 这个对象对模板进行加载的（它也解决创立和缓存预
解析模板的工作），而后咱们通过 getTemplate 办法取得你想要的模板，有一点要记住
freemarker.template.Configuration 在你整个利用必须保障惟一实例。
定义模板
news.ftl
<#-- 新闻标题 --><h1>${title}</h1><p> 新闻来源：${source} 公布工夫：${pubTime?sring("yyyy-MM-dd HH:mm")}</p><#-- 新闻内容 --><p> ${content}</p> 加载模板
@WebServlet("/news")public class NewsServlet extends HttpServlet { @Override protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // 实例化模板配置对象 Configuration configuration = new Configuration(); // 设置加载模板的上下文 以及 设置加载模板门路（模板寄存的门路） configuration.setServletContextForTemplateLoading(getServletContext(),"/template"); // 设置模板的编码格局 configuration.setDefaultEncoding("UTF-8"); // 加载模板文件，获取模板对象 Template template = configuration.getTemplate("news.ftl"); // 设置模型数据 Map<String,Object> map = new HashMap<>(); map.put("title", "特地待业季：稳待业状况如何? 哪些问题待解?"); map.put("source", "人民日报"); map.put("pubTime", new Date()); map.put("content", "中共中央政治局常务委员会近日召开会议强调，" + "要有针对性地发展援企、稳岗、扩待业工作，" + "做好高校毕业生、农民工等重点群体待业工作，" + "踊跃帮忙个体工商户纾困。疫情期间，稳待业状况如何？还有哪些问题待解？" + "记者采访了不同群体，记录这个特地的待业季。"); // 获取我的项目所在的根目录 String basePath = request.getServletContext().getRealPath("/"); // 设置页面寄存的目录 File htmlFile = new File(basePath + "/html"); // 判断目录是否存在 if (!htmlFile.exists()) { // 如果目录不存在，则新建目录 htmlFile.mkdir(); } // 获取文件名（随机生成不反复的文件名） String fileName = System.currentTimeMillis() + ".html"; // 创立html文件 File file = new File(htmlFile, fileName); // 获取文件输入流 FileWriter writer = new FileWriter(file); try { // 输入html 将模型数据填充到模板中 template.process(map, writer); // 输入胜利 System.out.println("新闻创立胜利！"); } catch (TemplateException e) { e.printStackTrace(); } finally { writer.flush(); writer.close(); } }} 生成对应的html文件
浏览器地址栏输出：
http://localhost:8989/news
生成的文件寄存在以后我的项目的webapp目录下的html目录中。
FreeMarker 运算符
算术运算符
<!-- 算术运算 +、-、*、/、%--><#assign a1 = 8 a2 = 2 >${a1} + ${a2} = ${a1 + a2} <br/>${a1} - ${a2} = ${a1 - a2} <br/>${a1} * ${a2} = ${a1 * a2} <br/>${a1} / ${a2} = ${a1 / a2} <br/>${a1} % ${a2} = ${a1 % a2} <br/><!--字符串运算-->${"hello" + "," + "freemarker"} 逻辑运算符
<#-- 逻辑运算符 &&、||、!--> 比拟运算符
<#-- 比拟运算符 > (gt): 大于号，举荐应用 gt < (lt)： 小于号，举荐应用 lt >= (gte): 大于等于， 举荐是用 gte <= (lte): 小于等于，举荐应用 lte == ： 等于 != : 不等于--> 空值运算符
<#-- 空值运算符 1. ??:判断是否为空，返回布尔类型 如果不为空返回 false， 如果为空返回 true，不能间接输入 ${(name??)?string} 2. !: 设置默认值，如果为空，则设置默认值 1. 设置默认为空字符串： ${name!} 2. 设置指定默认值 ${name!'zhangsan'}-->