关于java: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/m...d">
<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>

<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>

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

<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.0.1</version>
</dependency>

</dependencies>

<build>
<finalName>freemarker</finalName>

<plugins>

<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/ja...d">

<servlet>
<servlet-name>freemarker</servlet-name>
<servlet-class>freemarker.ext.servlet.FreemarkerServlet</servlet-class>
<init-param>

<param-name>TemplatePath</param-name>

<param-value>/</param-value>
</init-param>
<init-param>

<param-name>default_encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
</servlet>

<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}

${flag?string}

${flag?string("yes","no")}

日期类型

在Servlet中设置日期类型的数据
// 日期类型
request.setAttribute("createDate",new Date());
获取数据
<#--
数据类型：日期类型
在freemarker中日期类型不能间接输入；如果输入要先转成日期型或字符串
1. 年月日 ?date
2. 时分秒 ?time
3. 年月日时分秒 ?datetime
4. 指定格局 ?string("自定义格局")
y：年 M：月 d：日
H：时 m：分 s：秒
-->
<#-- 输入日期格局 -->
${createDate?date}

<#-- 输入工夫格局 -->
${createDate?time}

<#-- 输入日期工夫格局 -->
${createDate?datetime}

<#-- 输入格式化日期格局 -->
${createDate?string("yyyy年MM月dd日 HH:mm:ss")}

数值类型

在Servlet设置数值型的数据
// 数值类型
request.setAttribute("age",18); // 数值型
request.setAttribute("salary",10000); // 数值型
request.setAttribute("avg",0.545); // 浮点型
获取数据
<#--
数据类型：数值类型
在freemarker中数值类型能够间接输入；
1. 转字符串
一般字符串 ?c
货币型字符串 ?string.currency
百分比型字符串 ?string.percent
1. 保留浮点型数值指定小数位（#示意一个小数位）
?string["0.##"]
-->
<#-- 间接输入数值型 -->
${age}

${salary}

<#-- 将数值转换成字符串输入 -->
${salary?c}

<#-- 将数值转换成货币类型的字符串输入 -->
${salary?string.currency}

<#-- 将数值转换成百分比类型的字符串输入 -->
${avg?string.percent}

<#-- 将浮点型数值保留指定小数位输入（##示意保留两位小数） -->
${avg?string["0.##"]}

字符串类型

在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}

${msg?string} - ${msg2?string}

<#-- 1. 截取字符串（左闭右开） ?substring(start,end) -->
${msg2?substring(1,4)}

<#-- 2. 首字母小写输入 ?uncap_first -->
${msg?uncap_first}

<#-- 3. 首字母大写输入 ?cap_first -->
${msg2?cap_first}

<#-- 4. 字母转小写输入 ?lower_case -->
${msg?lower_case}

<#-- 5. 字母转大写输入 ?upper_case -->
${msg?upper_case}

<#-- 6. 获取字符串长度 ?length -->
${msg?length}

<#-- 7. 是否以指定字符结尾（boolean类型） ?starts_with("xx")?string -->
${msg?starts_with("H")?string}

<#-- 8. 是否以指定字符结尾（boolean类型） ?ends_with("xx")?string -->
${msg?ends_with("h")?string}

<#-- 9. 获取指定字符的索引 ?index_of("xxx") -->
${msg?index_of("e")}

<#-- 10. 去除字符串前后空格 ?trim -->
${msg?trim?length}

<#-- 11. 替换指定字符串 ?replace("xx","xxx") -->
${msg?replace("o","a")}

字符串空值状况解决

FreeMarker 的变量必须赋值，否则就会抛出异样。而对于 FreeMarker 来说，null 值和不存在的变量是齐全一样的，因为 FreeMarker 无奈了解 null 值。

FreeMarker 提供两个运算符来防止空值：

① ! ：指定缺失变量的默认值

${value!}：如果value值为空，则默认值是空字符串

${value!"默认值"}：如果value值为空，则默认值是字符串"默认值"

② ?? ：判断变量是否存在

如果变量存在，返回 true，否则返回 false

${(value??)?string}

<#-- 如果值不存在，间接输入会报错 -->
<#--${str}-->
<#-- 应用!，当值不存在时，默认显示空字符串 -->
${str!}

<#-- 应用!"xx"，当值不存在时，默认显示指定字符串 -->
${str!"这是一个默认值"}

<#-- 应用??，判断字符串是否为空；返回布尔类型。如果想要输入，须要将布尔类型转换成字符串 -->
${(str??)?string}

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}

</#list>
数组的长度：${stars?size}

<#-- 获取第一个元素 -->
第一个元素：${stars?first}

<#-- 获取最初一个元素 -->
最初一个元素：${stars?last}

<#-- List操作 -->
<#list cityList as city >
${city}

</#list>
List的size：${cityList?size}

<#-- 倒序输入 -->
<#list cityList?reverse as city >
${city} -
</#list>

<#-- 升序输入 -->
<#list cityList?sort as city >
${city} -
</#list>

<#-- 降序输入 -->
<#list cityList?sort?reverse as city >
${city} -
</#list>

<#-- JavaBean汇合 -->
<#list userList as user>
编号：${user.userId}
姓名：${user.uname}
年龄：${user.uage}

</#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]}

</#list>

<#-- value遍历输入 -->
<#list cityMap?values as value>
${value} |
</#list>

FreeMarker 常见指令

assign 自定义变量指令

应用 assign 指令你能够创立一个新的变量，或者替换一个曾经存在的变量。

<#--
assign 自定义变量指令
语法：
<#assign 变量名=值>
<#assign 变量名=值变量名=值> （定义多个变量）
-->
<#assign str="hello">
${str}

<#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>
注：

condition, condition2等：将被计算成布尔值的表达式。
elseif 和 else 指令是可选的。

-->
<#assign score = 80>
<#if score < 60>
你个小渣渣！
<#elseif score == 60>
分不在高，及格就行！
<#elseif score gt 60 && score lt 80>
哎哟不错哦！
<#else>
你很棒棒哦！
</#if>

<#-- 判断数据是否存在 -->
<#assign list="">
<#if list??>
数据存在
<#else>
数据不存在
</#if>

list 遍历指令

能够应用 list 指令来对序列进行遍历。

<#--
list指令
格局1：
<#list sequence as item>

</#list>
格局2：
<#list sequence as item>

<#else>
当没有选项时，执行else指令
</#list>
注：

else 局部是可选的
sequence：想要迭代的项，能够是序列或汇合的表达式
item：循环变量的名称
当没有迭代项时，才应用 else 指令，能够输入一些非凡的内容而不只是空在那里

-->
<#assign users = ["张三","李四","王五"]>
<#-- 遍历序列 -->
<#list users as user>
${user}
</#list>

<#--判断数据不为空，再执行遍历（如果序列不存在，间接遍历会报错）-->
<#if users2??>
<#list users2 as user>
${user}
</#list>
</#if>

<#assign users3 = []>
<#-- 当序列没有数据项时，应用默认信息 -->
<#list users3 as user>
${user}
<#else>
以后没有数据！
</#list>

macro 自定义指令

能够应用 macro 指令来自定义一些自定义指令。

<#--
macro 自定义指令（宏）

根本应用

格局：
<#macro 指令名>
指令内容
</#macro>
应用：
<@指令名></@指令名>

有参数的自定义指令

格局：
<#macro 指令名参数名1 参数名2>
指令内容
</#macro>
应用：
<@指令名参数名1=参数值1 参数名2=参数值2></@指令名>

注：

指令能够被屡次应用。
自定义指令中能够蕴含字符串，也可蕴含内置指令

<#-- 定义有参数的自定义指令 -->
<#macro queryUserByName uname>
通过用户名查问用户信息 - ${uname}
</#macro>
<#-- 应用指令，并传递参数 -->
<@queryUserByName uname="admin"></@queryUserByName>

<#-- 定义有多个参数的自定义指令 -->
<#macro queryUserByParams uname uage>
通过多个餐宿查问用户信息 - ${uname} - ${uage}
</#macro>
<#-- 应用指令，并传递多个参数 -->
<@queryUserByParams uname="admin" uage=18></@queryUserByParams>

<#-- 自定义指令中蕴含内置指令 -->
<#macro cfb>
<#list 1..9 as i>
<#list 1..i as j>
${j}*${i}=${j*i}
</#list>

</#list>
</#macro>
<@cfb></@cfb>
<@cfb></@cfb>

<#-- 动态数据 -->
<#macro cfb2 num>
<#list 1..num as i>
<#list 1..i as j>
${j}*${i}=${j*i}
</#list>

</#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>

</#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
== ：等于
!= : 不等于
-->

空值运算符

<#--
空值运算符

??:判断是否为空，返回布尔类型

如果不为空返回 false，如果为空返回 true，不能间接输入
${(name??)?string}

!: 设置默认值，如果为空，则设置默认值
设置默认为空字符串：

${name!}

设置指定默认值

${name!'zhangsan'}
-->