velocity的基本使用 && 实例讲解

velocity的简介

Velocity是一个基于java的模板引擎（template engine）。它容许任何人仅仅简单的使用模板语言（template language）来引用由java代码定义的对象，这样的话其实在先后端分离而言又是一个较为合理的可选方案，
Velocity也能够配合其余的语言来完成使用，Velocity.js就是不错的选择，这样的话能够依靠nodejs和浏览器环境来实现模版的功能。

• 什么是Velocity模版?

  Velocity模版能够是任意的文本文件,只要里面包含专门的模板语言(VTL)标记,就能够被Velocity模板引擎解析;

• Velocity模版的工做机制:

  Velocity能够经过获取Java对象的函数返回值、属性值,用于替换模板文件中的VTL变量标记,从而生成新的文件,模板文件的扩展名能够是".vm"、".htm"、".html"、".asp"、".sql",等等任

语法简介

大部分的模版引擎都是有本身的书写方式，不过{}这个大括号基本都是他们的通用符号，这里介绍语法的顺序是：

• 变量定义、使用

• 控制语句 if for之类

• 指令

• 宏

变量

变量是任何语言都不可缺乏的；

变量定义和使用

变量的定义和赋值基本方法：#set (<$变量名> = <"变量值">)
#set ($name = "Sankhya") ##字符串
#set ($age = 30) ##数字
#set ($list = ["Sankara", ${name}, "Shankara"]) ##数组
#set ($dict = ["A":"va", "B":234, "C":${value}]) ##HashTable
在双引号之间的字符串将被Velocity引擎解释和从新解释;在velocity中使用$2.5这样的货币标识是没有问题得的，由于velocity中的变量老是以一个大写或者小写的字母开始的。

使用：
${name} ，也能够写成：$name。提倡用前面的写法。
例如：你但愿经过一个变量$vice来动态的组织一个字符串。
Jack is a $vicemaniac.
原本变量是$vice如今却变成了$vicemaniac，这样Veloctiy就不知道您到底要什么了。因此，应该使用规范的格式书写 ： Jack is a ${vice}maniac
如今Velocity知道变量是$vice而不是$vicemaniac。
例如:
#set ($desc = "${name} is ${age} years old;")
执行这条语句以后,输出$desc的值将是:Sankhya is 30 years old;
同时还须要注意：
(1).Velocity模版中的变量是弱类型的;等号"="右边的值能够是引用、字符串、数字、Array、Vector、HashTable或表达式;
(2).若是等号"="右边的值是null,则左边的变量不会被赋值,且仍然保留之前的值;
(3).模板中没有被定义的变量将被认为是一个字符串;
(4).模板引擎不会将reference解释为对象的实例变量;如:$foo.Name将被解释为对象Foo的getName()方法,而不是Foo对象的Name实例变量;$foo.getBar()就等价于$foo.Bar;

注释：

• 单行注释使用“##”开头就可： ## 这好似注释

• 多行注释 #* 多行注释 *#

• 文档注释： #** 文档编写 **#

控制语句

if条件控制语句

#if (<condition>)
  ##statement segment
 #elseif (<condition>)
  ##statement segment
 #else
  ##statement segment
 #end

做为condition,Velocity引擎也支持关系运算符(>、>=、<、<=、!=)和逻辑运算符(&&->AND、||->OR、!->NOT);
"!"用来强制把不存在的变量显示为空白。
如当页面中包含$msg，若是msg对象有值，将显示msg的值，若是不存在msg对象同，则在页面中将显示$msg字符。这是咱们不但愿的，为了把不存 在的变量或变量值为null的对象显示为空白，则只须要在变量名前加一个“!”号便可。
如：$!msg

循环控制

#foreach ($element in $list)
  ##your statement
  $velocityCount
#end

指令

#parse和#include指令:
这二者都是导入本地模板文件;
#parse指令只能导入一个文件,同时,被导入的文件的内容将会被Velocity模板引擎解析,意思就是把被导入的文件的内容copy到当前文件中;该指令也能够被递归调用;

#include指令能够导入一个或多个文件,当导入多个文件时,能够用逗号分隔;并且,被导入的文件的内容不会被Velocity模版引擎解析;
例如:
#include ("one.gif", "two.txt", "three.htm") ##不会被模版引擎解释;
#include (${file1}, ${file2}, ${file3}) ##不会被模版引擎解释;
#parse ("server.conf") ##会被模版引擎解释;

#stop中止执行模板引擎并返回,把它应用于debug是颇有帮助的;
Velocity中的转义字符也是使用符号"";这就意味着执行"\"将会输出"",而执行"&dollar;"将会输出"$",执行"#"会输出"#";

参考：http://bdxnote.blog.163.com/b...
http://www.blogjava.net/alexw...
http://www.cnblogs.com/likwo/...