FreeMarker技术指南.pdfVIP

FreeMarker 技术指南 一、什么是模板引擎，为什么要用模板引擎 在B/S 程式设计中，常常有美工和程序员二个角色，他们具有不同专业技能：美工专注于 表现——创建页面、风格、布局、效果等等可视元素；而程序员则忙于创建程式的商业流 程，生成设计页面要显示的数据等等。 很多时候，要显示的资料在设计的时候并不存在，它们一般是在运行时由程式产生的，比 如执行“价格不高于800NT 的USB Disk”查询的返回结果。这种技术需求产生了JSP 等 Scriptlet，JSP 十分强大，但是也常常被滥用，并导致一些不良的后果 1. 将逻辑和表现混合在一起。 2. 破坏了美工和程序员职责的正常分解。 3. 使JSP 页面难以阅读和维护。 模板引擎就是为了解决上面的问题而产生的。在设计HTML 的时候，我们加入一些特定指 令来指定要插入哪些数据，这些加了特殊指令的HTML 或者其他文本，我们称为模板 (Template)。而模板引擎会在输出页面时，用适当的数据替代这些代码。 模板和嵌入JSP 的HTML 是不同的，模板指令只有很有限的编程能力，可以避免混入商 业逻辑。 二、FreeMarker 与JSP 、Velocity 的对比 FreeMarker 优点： 1. 不能编写Java 代码，可以实现严格的MVC 分离 2. 美工和技术的工作分离 3. 页面是静态化的，这样方便有哪些信誉好的足球投注网站引擎的收录 4. 模板可以存在数据库，可以实现cms 定制功能 5. 性能不错，页面显示的速度非常快，省去了JSP 编译的过程 6. 内置许多功能强大的标记、以及大量常用的函数 7. 带有宏定义 （macro）功能，类似于JSP 自定义标签，但是更加简单方便 8. 支持JSP 标签 9. Struts2 对其支持效果不错 10. 不一定非要在Servlet 中去实现 FreeMarker 缺点： 1. 性能没有Velocity 高，学习起来没有Velocity 简单 2. 需要花费时间重新学习 3. FreeMarker 中不能读取值为null 的变量，会报错，必须要设置默认值或者判断 4. 模板修改之后，如果没有更新模板生成的HTML，会看到过期的页面 5. MyEclipse IDE 插件的效果不太好 三、一个简单的FreeMarker Demo 1.导入Jar 包： FreeMarker 需要freemarker-2.3.19.jar 包，Struts2 里面有这个Jar 包。 2.编写模板文件 FreeMarker 的模板文件的后缀名是 ftl 。这里是我写的一个 Example.ftl，我把它放在 WebRoot 下的Template 文件夹下。 html head titleExample/title /head body h1大家好,我的名字叫${name},我家住在${address},我今年${age}岁了!/h1 /body /html 3.模板的解析 模板需要被解析之后才能生成最终的文件，FreeMarker 的数据模型也是在模板中配置的。 ExampleResolution.java public class ExampleResolution { public void resolution(){ Writer out = null ; /** * 创建Configuration对象 * 设置模板文件的基路径 * 设置读取模板的编码方式 */ Configuration cfg = new Configuration(); cfg.setServletContextForTemplateLoading(ServletActionContext.getServletContext (), TemplateFiles); cfg.setDefaultEncoding(UTF-8); /** * 创建FreeMarker的数据模型 */ Map root = new HashMap (); root.put(name, 李鑫龙)