代码生成框架Velocity

代码生成框架Velocity

Velocity是一个基于Java的模板引擎，用户可以使用模板语言VTL来引用由Java代码定义的对象。
Velocity通常可以作为动态生成页面而广泛使用，还是一种功能强大的代码生成工具。
Velocity模板类似于JSP文件，当客户端发送请求后，Velocity引擎江根据模板产生动态地页面。如果要使用Velocity生成动态页面，需要扩展VelocityServlet类来实现请求的处理，并通过handleRequest方法返回一个模板变量，Velocity会负责模板到页面的转换。
它还可以从模板产生SQL脚本、XML及Java代码等。
1）模板文件
扩展名为“.vm”，是一个文本文件。
2）Java程序
可以为VelocityServlet的子类。
例：
（1）helloworld.vm

## test  assign
# set ($ name  =   " gan.shu.man " )
Employee name:  $ gan . shu . man

## test condition
# if ($ name  ==   " gan.shu.man " )
$ name: very good!!
# else
$ name: sorry!!
# end

Product information
## test circular
# foreach ($ product in  $ productList )
$ product . Name     $$ product . Price
# end

## test program  assign
Total Price:  $$ totalPrice

 

（2）HelloWorldVTL.java

import  java.io.StringWriter;
import  java.io.Writer;
import  java.util.ArrayList;
import  java.util.Collection;
import  java.util.Iterator;

import  org.apache.velocity.Template;
import  org.apache.velocity.VelocityContext;
import  org.apache.velocity.app.Velocity;
public   class  HelloWorldVTL  ... {
 public static void main(String[] args) throws Exception...{
  Velocity.init();
  Template template = Velocity.getTemplate("./src/helloworld.vm");
  VelocityContext ctx = new VelocityContext();
  Collection products = new ArrayList();
  products.add(new Product("Product 1",12.99));
  products.add(new Product("Product 2",13.99));
  products.add(new Product("Product 3",11.99));
  ctx.put("productList", products);
  Iterator itr = products.iterator();
  double total = 0.00;
  while(itr.hasNext())...{
   Product p = (Product)itr.next();
   total+=p.getPrice();
  }
  ctx.put("totalPrice", new Double(total));
  Writer writer = new StringWriter();
  template.merge(ctx, writer);
  System.out.println(writer.toString());
 }
}

 

（3）Product.java

public   class  Product  ... {
 private String name;
 private double price;
 public Product(String name, double price) ...{
  super();
  this.name = name;
  this.price = price;
 }
 public String getName() ...{
  return name;
 }
 public void setName(String name) ...{
  this.name = name;
 }
 public double getPrice() ...{
  return price;
 }
 public void setPrice(double price) ...{
  this.price = price;
 }
}

 

输出：
2008-3-10 2:45:12 org.apache.velocity.runtime.log.JdkLogChute log
信息: FileResourceLoader : adding path '.'
2008-3-10 2:45:12 org.apache.velocity.runtime.log.JdkLogChute log
信息: Null reference [template './src/helloworld.vm', line 3, column 16] : $gan.shu.man cannot be resolved.
Employee name: $gan.shu.man

gan.shu.man: very good!!

Product information
Product 1    $12.99
Product 2    $13.99
Product 3    $11.99

Total Price: $38.97

3）处理流程：
使用Velocity生成过程如下：
（1）初始化模板引擎；
（2）加载模板文件；
（3）创建模板上下文；
（4）给模板变量赋值；
（5）替换模板中的值生成代码。
通过模板生成代码是比较好的选择，模板在某种意义上来说就是配置文件的一种，当生成文件内容修改后，用户不需要修改源程序，只需要修改模板文件即可，提高了代码的可维护性。