![](https://i-blog.csdnimg.cn/blog_migrate/33f9f130b7e71f2f757d1c3828b30ef0.png)
FreeMarker是一个模板引擎,一个基于模板生成文本输出的通用工具,使用纯Java编写
FreeMarker被设计用来生成HTML Web页面,特别是基于MVC模式的应用程序
虽然FreeMarker具有一些编程的能力,但通常由Java程序准备要显示的数据,由FreeMarker生成页面,通过模板显示准备的数据(如下图)
![](https://i-blog.csdnimg.cn/blog_migrate/11d7382deb1bdf5b62e597ee475380a7.png)
FreeMarker不是一个Web应用框架,而适合作为Web应用框架一个组件
FreeMarker与容器无关,因为它并不知道HTTP或Servlet;FreeMarker同样可以应用于非Web应用程序环境
FreeMarker更适合作为Model2框架(如Struts)的视图组件,你也可以在模板中使用JSP标记库
FreeMarker是免费的
而且你还可以通过Eclipse的插件来编辑FreeMarker。
FreeMarker特性
1、通用目标
能够生成各种文本:HTML、XML、RTF、Java源代码等等
易于嵌入到你的产品中:轻量级;不需要Servlet环境
插件式模板载入器:可以从任何源载入模板,如本地文件、数据库等等
你可以按你所需生成文本:保存到本地文件;作为Email发送;从Web应用程序发送它返回给Web浏览器
2、强大的模板语言
所有常用的指令:include、if/elseif/else、循环结构
在模板中创建和改变变量
几乎在任何地方都可以使用复杂表达式来指定值
命名的宏,可以具有位置参数和嵌套内容
名字空间有助于建立和维护可重用的宏库,或者将一个大工程分成模块,而不必担心名字冲突
输出转换块:在嵌套模板片段生成输出时,转换HTML转义、压缩、语法高亮等等;你可以定义自己的转换
3、通用数据模型
FreeMarker不是直接反射到Java对象,Java对象通过插件式对象封装,以变量方式在模板中显示
你可以使用抽象(接口)方式表示对象(JavaBean、XML文档、SQL查询结果集等等),告诉模板开发者使用方法,使其不受技术细节的打扰
4、为Web准备
在模板语言中内建处理典型Web相关任务(如HTML转义)的结构
能够集成到Model2 Web应用框架中作为JSP的替代
支持JSP标记库
为MVC模式设计:分离可视化设计和应用程序逻辑;分离页面设计员和程序员
5、智能的国际化和本地化
字符集智能化(内部使用UNICODE)
数字格式本地化敏感
日期和时间格式本地化敏感
非US字符集可以用作标识(如变量名)
多种不同语言的相同模板
6、强大的XML处理能力
<#recurse> 和<#visit>指令(2.3版本)用于递归遍历XML树
在模板中清楚和直觉的访问XML对象模型
具体实例:怎么使用FreeMarker根据相应数据生成静态HTML页面呢?(小例子不妨参考下)
1、使用NetBeans建立WEB工程,将下载的jar包放到lib目录(下载地址:http://freemarker.sourceforge.net/freemarkerdownload.html);
2、建立模版文件,在Web页下面建立templates文件夹,然后将新建扩展名为.ftl的模版放该文件夹下;
1)、创建test.ftl,代码如下:
<html>
<head>
<title>${title}</title>
<meta http-equiv="Content-Type" content="text/html; charset=GBK">
</head>
<body>
<h1 style="color: red;">内容:${content}!</h1>
<h3>作者:${author}</h3>
</body>
</html>
3、在src目录下创建com.xyl.servlet包,并在该包下创建TestServlet.java文件,代码如下:
package com.xyl.servlet;
import freemarker.template.Configuration;
import freemarker.template.Template;
import freemarker.template.TemplateException;
import java.io.BufferedWriter;
import java.io.File;
import java.io.FileWriter;
import java.io.IOException;
import java.io.PrintWriter;
import java.text.SimpleDateFormat;
import java.util.Calendar;
import java.util.Date;
import java.util.HashMap;
import java.util.Map;
import java.util.logging.Level;
import java.util.logging.Logger;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.HttpSession;
/**
* 测试
* @author Xu yan li
*/
public class TestServlet extends HttpServlet {
private Configuration cfg;
protected void processRequest(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
//初始化FreeMarker配置,创建Configuration实例
cfg = new Configuration();
cfg.setDefaultEncoding("UTF-8");
//设置FreeMarker的模版文件位置
cfg.setServletContextForTemplateLoading(getServletContext(), "templates");
//建立数据模型
Map root = new HashMap();
//放入对应数据
root.put("title", "使用Freemarker生成静态页面实例!");
root.put("content", "FreeMarker是一个模板引擎,一个基于模板生成文本输出的通用工具,使用纯Java编写FreeMarker被设计用来生成HTML Web页面,特别是基于MVC模式的应用程序虽然FreeMarker具有一些编程的能力,但通常由Java程序准备要显示的数据,由FreeMarker生成页面,通过模板显示准备的数据(如下图)");
root.put("author", "贝贝");
//获得模版文件
Template t = cfg.getTemplate("hello.ftl");
//开始准备生成输出,使用模版文件的charset作为本页面的charset
//response.setContentType("text/html;charset=" + t.getEncoding());
PrintWriter out = response.getWriter();
try {
//合并数据模型和模版,并将结果输出到out中
//用模版来开发servlet可以只在代码里面加入动态的数据
t.process(root, out);
//文件名称
/*
long htmlName = Calendar.getInstance().getTimeInMillis();
Date date = new Date(htmlName);
SimpleDateFormat f = new SimpleDateFormat("yyyy-MM-dd");
String dirName = f.format(date);
//存放生成后的静态页面的目录 eg:2008-9-9
String saveDirectory = getServletContext().getRealPath("/") + dirName + "//";
File dir = new File(saveDirectory);
//如果目录不存在,则创建目录
if (!dir.exists()) {
dir.mkdir();
}
//生成静态文件
File newHtml = new File(dir + "/" + htmlName + ".html");
doWrite(t, newHtml.getPath(), root);
out.print("<a href='"+dirName+"/"+newHtml.getName()+"'>"+newHtml.getName()+"</a>");
String path = dirName+"/"+newHtml.getName();
HttpSession session = request.getSession(true);
session.setAttribute("path", path);
*/
} catch (Exception ex) {
//Logger.getLogger(TestServlet.class.getName()).log(Level.SEVERE, null, ex);
throw new ServletException("处理Template模版中出现错误", ex);
}
}
/**
* 生成静态文件
* @param t : 模版
* @param path : 静态页面路径
* @param root : 数据模型
*/
private void doWrite(Template t, String path, Map<String, Object> root) {
BufferedWriter bw = null;
try {
bw = new BufferedWriter(new FileWriter(path));
t.setEncoding(cfg.getDefaultEncoding());
t.process(root, bw);
bw.flush();
} catch (TemplateException ex) {
Logger.getLogger(TestServlet.class.getName()).log(Level.SEVERE, null, ex);
} catch (IOException ex) {
Logger.getLogger(TestServlet.class.getName()).log(Level.SEVERE, null, ex);
} finally {
try {
bw.close();
} catch (IOException ex) {
Logger.getLogger(TestServlet.class.getName()).log(Level.SEVERE, null, ex);
}
}
}
@Override
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
processRequest(request, response);
}
@Override
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
processRequest(request, response);
}
@Override
public String getServletInfo() {
return "Short description";
}// </editor-fold>
}
4、在web页下面新建index.html,代码如下:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Freemarker模版使用</title>
</head>
<body>
<h1><a href="TestServlet">调用hello模版</a></h1>
</body>
</html>
5、将项目部署上,查看index.html页,点击超链,是不是生成了一个静态页面了呢?呵呵..