一 简介

Velocity 是一个基于 Java 的模板引擎，它允许任何人仅仅简单的使用模板语言来引用由 Java 代码定义的对象，从而实现界面和 Java 代码的分离，使得界面设计人员可以和 Java 程序开发人员同步开发一个遵循 MVC 架构的 web 站点。

二 一个简单示例

（1）从官网下载最新的jar包，然后新建一个普通的Java工程，然后导入下载下来的zip文件中的jar包。当然也可以使用我用过的jar包，链接：http://pan.baidu.com/s/1PXu5g

（2）新建一个包：cn.zifangsky，然后新建文件Hellovelocity.vm，里面的内容如下：

#set($domain="http://www.zifangsky.cn")
whoami: $name

today is $date.
#foreach($i in $list)
$i
#end

website:$domain

（3）在同一个包下新建文件HelloVelocity.java，内容如下：

package cn.zifangsky;

import java.io.StringWriter;
import java.text.SimpleDateFormat;
import java.util.ArrayList;
import java.util.Date;
import java.util.List;

import org.apache.velocity.Template;
import org.apache.velocity.VelocityContext;
import org.apache.velocity.app.VelocityEngine;
import org.apache.velocity.runtime.RuntimeConstants;
import org.apache.velocity.runtime.resource.loader.ClasspathResourceLoader;

public class HelloVelocity {
	public static void main(String[] args){
		//初始化引擎
		VelocityEngine vEngine = new VelocityEngine();
		vEngine.setProperty(RuntimeConstants.RESOURCE_LOADER, "classpath");
		vEngine.setProperty("classpath.resource.loader.class", ClasspathResourceLoader.class.getName());
		
		vEngine.init();
		//读取Hellovelocity.vm这个模板生成的Template这个类
		Template template = vEngine.getTemplate("cn/zifangsky/Hellovelocity.vm");
		VelocityContext context = new VelocityContext();
		
		context.put("name", "zifangsky");
		context.put("date", new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date()));
		
		List list = new ArrayList();
		list.add("hello");
		list.add("velocity");
		context.put("list", list);
		
		StringWriter writer = new StringWriter();
		template.merge(context, writer);
		System.out.println(writer.toString());
	}
}

（4）输出如下：

whoami: zifangsky

today is 2016-03-10 15:37:49.
hello
velocity

website:http://www.zifangsky.cn

实际上，这个模板引擎的工作原理还是比较容易理解的，就是先定义一系列的.vm模板，然后在Java文件中读取这些模板文件将值传进去以此生成动态页面



附：Velocity语法：


一、基本语法
 
1、”#”用来标识Velocity的脚本语句，包括#set、#if 、#else、#end、#foreach、#end、#iinclude、#parse、#macro等；
 如:
 #if($info.imgs)
 
 #else
 
 #end

2、”$”用来标识一个对象(或理解为变量)；如
 如：$i、$msg、$TagUtil.options(…)等。

3、”{}”用来明确标识Velocity变量；
 比如在页面中，页面中有一个$someonename，此时，Velocity将把someonename作为变量名，若我们程序是想在someone这个变量的后面紧接着显示name字符，则上面的标签应该改成${someone}name。

4、”!”用来强制把不存在的变量显示为空白。
 如当页面中包含$msg，如果msg对象有值，将显示msg的值，如果不存在msg对象同，则在页面中将显示$msg字符。这是我们不希望的，为了把不存在的变量或变量值为null的对象显示为空白，则只需要在变量名前加一个“!”号即可。
 如：$!msg
 
二、在EasyJWeb中的最佳实践
 
  　　理论上你可以在EasyjWeb模板使用所有Velocity的脚本及功能，但我们不推荐你在界面模板中使用过多过复杂的脚本表达方式，在万不得已的情况下，不要在界面模板中加入任何复杂的逻辑，更不要在界面模板中加入变量声明、逻辑运算符等等。 
在EasyJWeb中，我们提供了五条基本的模板脚本语句，基本上就能满足所有应用模板的要求。这四条模板语句很简单，可以直接由界面设计人员来添加。在当前很多EasyJWeb的应用实践中，我们看到，所有界面模板中归纳起来只有下面四种简单模板脚本语句即可实现：
1、$!obj 　直接返回对象结果。
 如：在html标签中显示java对象msg的值。

$!msg


在html标签中显示经过HtmlUtil对象处理过后的msg对象的值　　

$!HtmlUtil.doSomething($!msg)

2、#if($!obj) #else #end 判断语句
 如：在EasyJWeb各种开源应用中，我们经常看到的用于弹出提示信息msg的例子。
#if($msg)
 
 #end
上面的脚本表示当对象msg对象存在时，输出