Velocity是一个基于java的模板引擎（template engine），它允许任何人仅仅简单的使用模板语言（template language）来引用由java代码定义的对象。它作为一款成熟的基于java的模板引擎，能够帮我们实现页面静态化，同时它将Java代码与网页分开，使网站在其生命周期内更加可维护，并为Java Server Pages（JSP）或PHP提供了可行的替代方案。

引擎

Velocity Engine

这是实现所有工作的实际模板引擎。（目前的版本是1.7）
Velocity Tools

项目包含使用Velocity引擎构建Web和非Web应用程序的工具和其他有用的基础设施。在此找到例如Struts集成的代码或独立的VelocityViewServlet。

语法

1. 基本语法

# 关键字

Velocity关键字都是使用#开头的，如#set、#if、#else、#end、#foreach等

$ 变量

Velocity变量都是使用$开头的，如：$name、$msg

{}变量

Velocity对于需要明确表示的Velocity变量，可以使用{}将变量包含起来。如在页面中，需要有$someoneName这种内容，此时为了让Velocity能够区分，可以使用${someone}Name。

！变量

如果某个Velocity变量不存在，那么页面中就会显示$xxx的形式，为了避免这种形式，可以在变量名称前加上！如页面中含有$msg，如果msg有值，将显示msg的值；如果不存在就会显示$msg。这是我们不希望看到的，为了把不存在的变量显示为空白，可以使用$!msg。

2. 变量

变量定义


#set($root = "www")   #set($name = "index")   #set($template = "$root/$name")   $template


执行输出结果：


www/index


变量赋值

赋值的左边必须是一个变量，或者是属性的引用。右边可以是：变量引用、字面字符串、属性引用、方法引用、字面数字、数组


#set($name = $bill)   ##变量引用   #set($name.pre = "monica")  ##字符串   #set($name.last = $address.num) ##属性引用   #set($name.mid = $hotel.find($web)) ##方法引用   #set($name.num = 123) ##数字   #set($name.say = ["yes",$my,"yes"]) ##数组  


velocity会将属性解释为属性的get方法，如：


$foo.Bar   等同于 $foo.getBar() $foo.User("join")  等同于 $foo.getUser("join") $foo.Request.ServerName 等同于 $foo.getRequest().getServerName()


3. 转义字符'\'


#set($mail = "foo")   $mail   \$mail   \\$mail   \\\$mail


执行结果如下：


foo $mail \foo \$mail


4. 循环

语法定义如下：


#foreach( 单个元素名称 in 集合)            ....   #end


例子如下：


#foreach( $num in [2..-2])       this is $num.</br>   #end


执行结果如下：


this is 2. this is 1. this is 0. this is -1. this is -2


5. 条件

语法定义如下：


#if(condition)   ...... #elseif(condition)   ...... #else   ...... #end 


6. 关系和逻辑操作符


&& 并且 || 或者 ！ 取反


7. 注释

1. 单行注释##


##这里写注释


2. 多行注释#*  *#


#*       这个写注释 可以写多行的注释 *#  


8. 宏

语法定义如下：


#macro(宏的名称  $参数1  $参数2 .....)          语句体（即函数体）   #end


宏调用如下：


#宏的名称 ($参数1  $参数2 .....)  


例子

导入jar包：velocity-1.4.jar，velocity-dept.jar;log4j.jar


//test.java生成文件
public static void main(String[] args) {
    //获取模板引擎
    VelocityEngine ve = new VelocityEngine();
    //模板文件所在的路径
    String path = "D:/work/velocity/WebRoot";
    //设置参数
    ve.setProperty(Velocity.FILE_RESOURCE_LOADER_PATH, path);
    //处理中文问题
    ve.setProperty(Velocity.INPUT_ENCODING, "GBK");
    ve.setProperty(Velocity.OUTPUT_ENCODING, "GBK");
    try {
        //初始化模板
        ve.init();
        //获取模板(hello.html)
        Template template = ve.getTemplate("hello.html");
        //获取上下文
        VelocityContext root = new VelocityContext();
        //把数据填入上下文
        root.put("name", "world");
        //输出路径
        String outpath = "e:/helloworld.html";
        //输出
        Writer mywriter = new PrintWriter(new FileOutputStream(new File(outpath)));

        template.merge(root, mywriter);
        mywriter.flush();
    } catch(Exception e) {
        e.printStackTrace();
    }
}