Apache Velocity实现模板化

zhouyi

1.参考文献
　　http://www.iyunv.com/zhuboxingzbx/articles/1225103.html
　　http://www.iyunv.com/amboyna/archive/2008/06/19/1225105.html

2.概述
2.1.Velocity模板引擎
　　模板引擎的设计思想最早由Webmacro提出，并被应用在一个著名的搜索引擎www.altavista.com上。后来，这种思想渐渐被Apache开发小组所采用，并作为一个子项目被提出来，这就是现在的Velocity。
　　模板引擎与MVC中视图部分的关系更为密切。Velocity可以应用在任何需要格式化数据显示的Java程序中。那么Velocity到底是什么呢？它的官方解释是：“Velocity是一种基于Java的模板引擎，它允许任何人使用简单而强大的模板语言来引用定义在Java代码中的对象。”
　　
2.2.使用Velocity的优点在于：

• 很容易集成在各种各样的程序领域中；
  
• 为网页制作人员提供了一种清晰而简单的语法；
  
• 因为模板和代码是分离的，所以可以分别独立的开发和维护它们；
  
• Velocity引擎可以很容易地集成到一些Java运行环境，特别是Servlet中；
  
• Velocity使得模板可以访问任何环境对象中的共有方法。
  

Velocity的强大之处还在于它严格地区分程序开发功能的职责划分。它通过限制模板可能访问的对象（即后台程序允许其得到的对象）来实现这一点。这意味着网页设计人员可以只把精力放在数据的显示部分（View），而程序员则只要关注如何写好程序的控制层（Controller）、商业逻辑与数据管理（Model）。这就是典型的MVC开发模式，它简化了开发和日益复杂的应用和维护工作。
2.3.Velocity最擅长做的工作包括：

• ◆ 基于Servlet的网站制作；
  
• ◆ Java和SQL代码生成；
  
• ◆ XML处理和转换；
  
• ◆ 文字处理，比如生成trf文件等。
  

不过，Velocity用得最多的还是在基于Java Servlet的网页程序中做生成网页的引擎，以替代JSP等技术。除了使用比较容易外，它提供了强大的模板语言来显示和操作数据。注意，不是生成数据，这点很重要，因为生成工作应该是程序逻辑的部分。　　
　　Velocity非常适合在J2EE（Java 2 Platform，Enterprise Edition）的网站开发中替代JSP，做输出页面的技术工作。虽然JSP包含在J2EE规范中，但是J2EE本身并不需要JSP。

3.实例
3.1.实例1
　　模板(hellosite.vm)只是提供一些静态的字符，中间加杂着一些类如$title的“通配符”，这是要在HelloWorld.java中替换的。下面是hellosite.vm的代码：
　　
Hello $name! Welcome to $site world!　　
　　HelloWorld.java就是处理程序了，其中注释写的很清楚了，下面是HelloWorld.java的代码：

　　
import java.io.StringWriter;import org.apache.velocity.app.VelocityEngine;import org.apache.velocity.Template;import org.apache.velocity.VelocityContext;public class HelloWorld {public static void main(String[] args) throws Exception {/* first, get and initialize an engine */VelocityEngine ve = new VelocityEngine();ve.init();/* next, get the Template */Template t = ve.getTemplate("hellosite.vm");/* create a context and add data */VelocityContext context = new VelocityContext();context.put("name", "xuwei");context.put("site", "http://blog.iyunv.com/xw13106209");/* now render the template into a StringWriter */StringWriter writer = new StringWriter();t.merge(context, writer);/* show the World */System.out.println(writer.toString());}}　　
3.2.实例2
　　这里模板和实例1的相同，java代码有所不如，代码如下。
import java.io.StringWriter;import org.apache.velocity.app.VelocityEngine;import org.apache.velocity.Template;import org.apache.velocity.VelocityContext;public class HelloWorld2 {public static void main(String[] args) throws Exception {// 初始化Velocity模板引擎VelocityEngine ve = new VelocityEngine();ve.init("D:\\Documents\\workspace\\VelocityTest\\a.properties");// Velocity获取模板文件，得到模板引用Template t = ve.getTemplate("hellosite.vm");// 初始化环境，并将数据放入环境VelocityContext context = new VelocityContext();context.put("name", "xuwei");context.put("site", "http://blog.iyunv.com/xw13106209");// 将环境变量和输出部分结合StringWriter writer = new StringWriter();t.merge(context, writer);System.out.println(writer.toString());}} 在这里，配置文件主要的作用就是提供a.properties文件的路径，不多说了，下面是a.properties的代码：
runtime.log = velocity_example.loginput.encoding=gbk  output.encoding=gbk  file.resource.loader.path=D:\\Documents\\workspace\\VelocityTest