Velocity模板引擎详解(一)

Java Velocity模板引擎详解

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();
    }
}