`

教你如何用FreeMarker生成静态页面

阅读更多

众所周知,FreeMarker适合于作为Web应用的表现层,那么我们就把把页面中所需要的样式放入FreeMarker文件中,然后将页面所需要的数据动态绑定,并放入Map中,通过调用FreeMarker模板文件解析类process()方法完成静态页面的生成。了解了上面的原理,接下来我就一步步带您实现FreeMarker生成静态页面。

package tool;

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.OutputStreamWriter;
import java.io.Writer;
import java.util.Map;

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

/*******************************************************************************
 * 
 * @author wuzhenzhong
 * 
 * @since Feb 5, 2010
 * 
 ******************************************************************************/
public class FreeMarkertUtil {
	/**
	 * templatePath模板文件存放路径,templateName 模板文件名称,filename 生成的文件名称
	 * @param templatePath
	 * @param templateName
	 * @param fileName
	 * @param root
	 */
	public static void analysisTemplate(String templatePath,
			String templateName, String fileName, Map<?, ?> root) {
		try {
			//初使化FreeMarker配置
			Configuration config = new Configuration();
			// 设置要解析的模板所在的目录,并加载模板文件
			config.setDirectoryForTemplateLoading(new File(templatePath));
			// 设置包装器,并将对象包装为数据模型
			config.setObjectWrapper(new DefaultObjectWrapper());

			// 获取模板,并设置编码方式,这个编码必须要与页面中的编码格式一致
			// 否则会出现乱码
			Template template = config.getTemplate(templateName, "UTF-8");
			// 合并数据模型与模板
			FileOutputStream fos = new FileOutputStream(fileName);
			Writer out = new OutputStreamWriter(fos, "UTF-8");
			template.process(root, out);
			out.flush();
			out.close();
		} catch (IOException e) {
			e.printStackTrace();
		} catch (TemplateException e) {
			e.printStackTrace();
		}
	}

}

 

package tool;

/*****************************************************
 * 
 * @author wuzhenzhong
 * 
 * @since Feb 5, 2010 
 *
 *****************************************************/
public class HtmlContent {
	private String userName;
	private String userPassword;
	/**
	 * @return the userName
	 */
	public String getUserName() {
		return userName;
	}
	/**
	 * @param userName the userName to set
	 */
	public void setUserName(String userName) {
		this.userName = userName;
	}
	/**
	 * @return the userPassword
	 */
	public String getUserPassword() {
		return userPassword;
	}
	/**
	 * @param userPassword the userPassword to set
	 */
	public void setUserPassword(String userPassword) {
		this.userPassword = userPassword;
	}


}

 

package tool;

import java.util.HashMap;
import java.util.Map;

/*******************************************************************************
 * 
 * @author wuzhenzhong
 * 
 * @since Feb 5, 2010
 * 
 ******************************************************************************/
public class CreateHtmlTest {
	public static void main(String[] args) {
		HtmlContent content = new HtmlContent();
		content.setUserName("张三");
		content.setUserPassword("123");

		Map<String, Object> root = new HashMap<String, Object>();
		root.put("content", content);
		String templatesPath = "E:/templates";
		String templateFile = "/createhtml.ftl";
		String htmlFile = templatesPath + "/firsthtml.html";
		FreeMarkertUtil.analysisTemplate(templatesPath, templateFile, htmlFile,
				root);
	}
}

 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>user.ftl</title>
</head>
  <body>
    ${content.userName}
    ${content.userPassword}
  </body>
</html>

 下面在说一下FreeMarker的优缺点吧:

优点:

1、易学易用
我是看了一天文档就用得挺熟练了,freemarker文档写得太好了,例子丰富,照做一遍全都会了。

2、功能强大
比Velocity强大多了,还支持JSP Tag。不过最有意义的是macro功能,可以自定义常用的macro,实现页面常规操作的可复用性。

3、报错信息友好
很多应用服务器的JSP报错信息是无法定位到源代码行的。不过freemarker报错定位很准确,丝毫不差,而且信息丰富,一看就知道怎么回事(虽然那个黄黄的页面看起来让人难受) 带着这种兴奋的心情来研究freemarker,但是用它做了几个项目以后问题来了,而且是很讨厌的问题.下面我就来说说FreeMarker的这几大罪状. 

 

 

缺点:
缺点一:freemarker的变量必须有值,没有被赋值的变量就会抛出异常,那个黄黄的freemarker出错页面,真是让人看了太难过了。
freemarker的FAQ上面冠冕堂皇的说,未赋值的变量强制抛错可以杜绝很多潜在的错误,如缺失潜在的变量命名,或者其他变量错误。但是实际的效果是:带来的是非常大的编程麻烦,程序里面几乎所有可能出现空值的变量统统需要加上${xxx?if_exists},有些循环条件还需要写if判断,这样不但没有杜绝应该杜绝的错误,反而极大增加了编程的麻烦。

缺点二:freemarker的map限定key必须是string,其他数据类型竟然无法操作!这一点就不讲了,JavaEye上面已经有人抱怨过了。连Webwork的开发人员Pat Lightboy都在抱怨这一点。


缺点三:freemarker为了编程方便把不可序列化的东西往session里面放!
freemarker支持在页面里面直接操作Session,request等,例如${Session[...]},方便确实很方便,但是一旦需要做群集,就会报错。
有朋友今天问起,他在做Tomcat群集的时候发现freemarker报错,HttpSessionHashModel不可序列化。他修改该类源代码,让他实现序列化接口,仍然报错。我一看,HttpSessionHashModel包含的属性:

分享到:
评论
17 楼 hjtracy1 2010-11-18  
请问楼主 这个例子应该运行那个文件
16 楼 hommy8 2010-02-11  
清晨阳光 写道
看来你用FreeMarker的时间不长,map的key和value都可以是对象
如果你使用
<#list map?keys as key>
  ${key}
</#list>
这种方式输出的话,页面会显示一个对象的地址,并且可以通过${map.get(key)}的方式,得到value对象
如果在freemarker.properties文件中配置classic_compatible=true之后,所有的变量不必写if_exists
session的问题也fix了
没有亲自测试过的结论,不要轻易发,否则会误导群众。


这个论坛的正确性正是需要你们这些优秀的大牛去保证,小弟学习了!
15 楼 清晨阳光 2010-02-06  
看来你用FreeMarker的时间不长,map的key和value都可以是对象
如果你使用
<#list map?keys as key>
  ${key}
</#list>
这种方式输出的话,页面会显示一个对象的地址,并且可以通过${map.get(key)}的方式,得到value对象
如果在freemarker.properties文件中配置classic_compatible=true之后,所有的变量不必写if_exists
session的问题也fix了
没有亲自测试过的结论,不要轻易发,否则会误导群众。
14 楼 san586 2010-02-06  
<p><img src="/images/smiles/icon_biggrin.gif" alt="">111111<br><br><img src="/images/smiles/icon_biggrin.gif" alt=""></p>
<p><img src="/images/smiles/icon_biggrin.gif" alt=""></p>
13 楼 fenglingcompany 2010-02-06  
lib 写道
<span>楼主帖子的内容怎么和robbin写过的帖子一样啊??</span>

<span style="color: #0000ff;"><br></span>

<span>robbin原文:</span>http://www.iteye.com/topic/17468

优缺点也是我以前在网上收集整理的,至于出处在哪,我还真不知道,只是闲时,自己做了一个小例子,与大家分享一下。
12 楼 lib 2010-02-06  
<p><span style="color: #0000ff;"><strong>楼主帖子的内容怎么和robbin写过的帖子一样啊??</strong></span></p>
<p><span style="color: #0000ff;"><strong><br></strong></span></p>
<p><span style="color: #0000ff;"><strong>robbin原文:</strong></span><a href="http://www.iteye.com/topic/17468">http://www.iteye.com/topic/17468</a></p>
11 楼 qlzgg 2010-02-06  
那几个优缺点都是robbin提过的。
10 楼 treblesoftware 2010-02-05  
ray_linn 写道
抛出异常的爱 写道
fenglingcompany 写道
ray_linn 写道
第三缺点,不就是robbin的某篇文章提的呗。这个问题早已经被fixed了。

哦,谢谢,这个只是我以前整理了一下,还真不知道,这个bug已经ok了,呵呵

应该把传送门发出来.



传送门

其实三个缺点都是robbin总结的,而且只对robbin是缺点,而不是freemarker的缺点。


最后一句,支持!
9 楼 ray_linn 2010-02-05  
抛出异常的爱 写道
fenglingcompany 写道
ray_linn 写道
第三缺点,不就是robbin的某篇文章提的呗。这个问题早已经被fixed了。

哦,谢谢,这个只是我以前整理了一下,还真不知道,这个bug已经ok了,呵呵

应该把传送门发出来.



传送门

其实三个缺点都是robbin总结的,而且只对robbin是缺点,而不是freemarker的缺点。
8 楼 zgxzowen 2010-02-05  
freemarker还是挺好用的。
7 楼 t152012 2010-02-05  
我也用freemarker做了静态页面,但是我我有几个疑问?如何直接访问静态页面,是设定了时间限制么,多少时间刷新一次么。还有,空值的问题,后台删除个数据,直接导致页面的报错,如何支持JSTL标签,我用的struct1+spring1.freemarker老要做判断
6 楼 fenglingcompany 2010-02-05  
nothinkinperson 写道
我在服务器上使用freemarker生成静态html的时候,有时候会出现用户访问不是最新生成的html.你们有出现过这样的情况吗?

我们这也遇到过,不过多刷新几次就行了,具体为什么,还不太清楚
5 楼 nothinkinperson 2010-02-05  
我在服务器上使用freemarker生成静态html的时候,有时候会出现用户访问不是最新生成的html.你们有出现过这样的情况吗?
4 楼 fenglingcompany 2010-02-05  
抛出异常的爱 写道
fenglingcompany 写道
ray_linn 写道
第三缺点,不就是robbin的某篇文章提的呗。这个问题早已经被fixed了。

哦,谢谢,这个只是我以前整理了一下,还真不知道,这个bug已经ok了,呵呵

应该把传送门发出来.

不好意思,我想问一下,什么是传关门,不太知道,你能告诉我一下吗?
3 楼 抛出异常的爱 2010-02-05  
fenglingcompany 写道
ray_linn 写道
第三缺点,不就是robbin的某篇文章提的呗。这个问题早已经被fixed了。

哦,谢谢,这个只是我以前整理了一下,还真不知道,这个bug已经ok了,呵呵

应该把传送门发出来.
2 楼 fenglingcompany 2010-02-05  
ray_linn 写道
第三缺点,不就是robbin的某篇文章提的呗。这个问题早已经被fixed了。

哦,谢谢,这个只是我以前整理了一下,还真不知道,这个bug已经ok了,呵呵
1 楼 ray_linn 2010-02-05  
第三缺点,不就是robbin的某篇文章提的呗。这个问题早已经被fixed了。

相关推荐

    教你如何用FreeMarker生成静态页面.doc

    以下是一个简单的Java代码示例,展示了如何使用FreeMarker生成静态页面: 1. 导入所需的FreeMarker库和IO相关的类。 2. 创建一个名为`FreeMarkerUtil`的公共类。 3. 定义一个静态方法`analysisTemplate`,接收模板...

    freemarker生成静态网页

    这可能是一个动态HTML的示例,或者是一个自定义的类,用于处理Freemarker生成静态页的过程。具体功能需要查看源代码才能明确。 通过以上步骤,你可以使用Freemarker轻松地将动态数据转化为静态网页。这种方式在网站...

    struts2+freemarker 生成静态页面

    5. **配置和优化**:在实际项目中,配置Struts2和FreeMarker生成静态页面时,需要考虑目录结构、文件命名规则、缓存控制等多个方面。例如,静态页面可能存储在特定的目录下,文件名可能包含URL参数以区分不同的动态...

    Struts2整合Freemarker生成静态页面

    以上就是Struts2整合Freemarker生成静态页面所涉及的主要知识点。通过熟练掌握这些,开发者可以有效地构建动态、高性能的Web应用。在提供的链接中,可能有更具体的示例和教程,帮助你深入理解和实践这一技术。

    FreeMarker教你如何生成html静态页面源码

    5. **生成静态文件**:一旦HTML源码生成,你可以将其写入到磁盘上的一个文件中,从而创建静态页面。确保选择合适的路径,并正确处理文件的创建和覆盖。 6. **优化和调试**:在实际应用中,你可能需要对模板进行优化...

    springboot整合freemarker生成静态html的demo.zip

    在本项目"springboot整合freemarker生成静态html的demo.zip"中,我们将探讨如何将SpringBoot框架与FreeMarker模板引擎结合,以实现动态数据驱动的静态HTML页面生成。FreeMarker是一个强大的、开源的模板语言,它允许...

    生成静态页面 freemarker模板

    在生成静态页面的场景中,Struts2可以作为数据和模板之间的桥梁,将处理后的业务数据传递给Freemarker,由Freemarker生成静态HTML。 **生成静态页面的流程** 1. **配置Struts2**: 首先,我们需要在Struts2的配置...

    freemarker生成静态页面------内含使用说明

    本篇文章将深入探讨Freemarker的工作原理、配置、语法以及在生成静态页面中的应用。 一、Freemarker的工作原理 Freemarker是一个基于Java的模板语言,它与后端服务器通过模板引擎进行交互。当用户请求页面时,...

    使用FreeMarker生成Html静态文件

    标题“使用FreeMarker生成Html静态文件”暗示了我们将探讨如何利用FreeMarker将动态数据转化为静态的HTML页面。这一过程通常涉及以下几个步骤: 1. **配置FreeMarker**: 首先,我们需要在Java项目中引入FreeMarker...

    freemarker生成静态html示例

    本示例项目是在Eclipse环境中创建的一个工程,目的是演示如何使用Freemarker来生成静态HTML页面。 在了解这个项目之前,首先需要知道什么是Freemarker。Freemarker是一个开源的Java库,它允许开发者通过定义模板(....

    freemarker生成静态HTML例子

    它采用声明式编程方式...通过上述步骤和示例,你可以了解并实现使用Freemarker生成静态HTML的基本过程。在实际开发中,这个功能可以用于构建静态站点、邮件模板或者API文档等场景,极大地提高了代码的可维护性和效率。

    httpclient,freemarker的静态化分页

    5. **保存HTML**:将生成的HTML文件保存到服务器的指定目录,作为静态页面。 6. **分页处理**:对于多页内容,重复以上步骤,生成每个分页对应的静态HTML。 7. **配置URL**:设置URL重写规则,使用户访问动态URL时...

    javaCMS 生成静态页面简单列子

    Java CMS(内容管理系统)生成静态页面是一种常见的优化网站性能和提升用户体验的方法。在这个过程中,原本由动态脚本生成的网页内容被转化为HTML文件,这些HTML文件可以被浏览器直接读取,减少了服务器处理请求的...

    通过freemarker模板 生成PDF

    在生成PDF的过程中,首先,你需要创建一个Freemarker模板,该模板定义了PDF的布局和样式。模板中包含占位符,这些占位符将在运行时被实际数据替换。例如,你可以创建一个`.ftl`文件,其中包含HTML元素和Freemarker...

    网站生成静态页面的方案和工具

    总结,网站生成静态页面是一个有效的优化手段,通过选用合适的工具和方法,结合FreeMarker模板引擎,能够实现高效且定制化的静态化过程。无论是个人博客还是大型企业网站,都可以从中受益,提升网站性能,增强用户...

    用java代码生成静态页面

    ### 使用Java代码生成静态页面的知识点 在当前的网络环境中,很多开发者会遇到需要通过程序自动生成静态HTML页面的需求。这种需求通常出现在博客系统、新闻网站或是任何需要定期更新大量内容且希望减轻服务器动态...

    jsp 静态引擎(freemarker)生成静态html案例

    2.freemarker 写出来的页面一般都是xml格式友好的,也就是说你可以写出很规范的xhtml,而且还可以直接使用一些xml的代码格式化工具直接美化.而且很容易发现其中缺少或者嵌套错误的tag 3. 个人觉得freemarker 和taglib...

    java生成静态页面——Freemarker实例教程.docx

    #### 三、Freemarker生成静态页面的工作原理 Freemarker生成静态页面的基本步骤如下: 1. **准备模板** 创建一个模板文件,该文件通常是一个包含HTML标记的普通文件,其中可能包含Freemarker的特殊标签或表达式...

Global site tag (gtag.js) - Google Analytics