一、Velocity Template Language (VTL)介绍
1、#set
用来定义页面内使用的变量。例如:
#set( $monkey = $bill ) ## variable reference
#set( $monkey.Friend = "monica" ) ## string literal
#set( $monkey.Blame = $whitehouse.Leak ) ## property reference
#set( $monkey.Plan = $spindoctor.weave($web) ) ## method reference
#set( $monkey.Number = 123 ) ##number literal
#set( $monkey.Say = ["Not", $my, "fault"] ) ## ArrayList
#set( $monkey.Map = {"banana" : "good", "roast beef" : "bad"}) ## Map
2、comment
注释语法为# ,#* *#,#** *#
3、References
References有三类,分别是variables, properties and methods,分别举例如下:
variables:
$foo
推荐写法 $!foo ,值不存在的时候,会用空字符串替代
properties :
$customer.Address
methods:
$customer.getAddress()
$purchase.getTotal()
$page.setTitle( "My Home Page" )
$person.setAttributes( ["Strange", "Weird", "Excited"] )
4、If / ElseIf / Else
逻辑分支判断,例如
#if( $foo < 10 )
<strong>Go North</strong>
#elseif( $foo == 10 )
<strong>Go East</strong>
#elseif( $bar == 6 )
<strong>Go South</strong>
#else
<strong>Go West</strong>
#end
5、#foreach
一下是该标签的常用代码实例片段,
一般的例子
<ul>
#foreach( $product in $allProducts )
<li>$product</li>
#end
</ul
Map循环的例子
<ul>
#foreach( $key in $allProducts.keySet() )
<li>Key: $key -> Value: $allProducts.get($key)</li>
#end
</ul>
通过$foreach.count获取循环计数器,类似的还有($foreach.index,$foreach.last, $foreach.first等)
<table>
#foreach( $customer in $customerList )
<tr><td>$foreach.count</td><td>$customer.Name</td></tr>
#end
</table>
通过$foreach.hasNext来判断是否是最后一次循环
#foreach( $customer in $customerList )
$customer.Name#if( $foreach.hasNext ),#end
#end
通过#break来中断循环
## list first 5 customers only
#foreach( $customer in $customerList )
#if( $foreach.count > 5 )
#break
#end
$customer.Name
#end
6、#include
该标签用来引入一个本地文件,引入的时候是静态引入,不会被Velocity Engine进行render.并且基于安全原因,被引入文件最好被放在TEMPLATE_ROOT下
简单例子如下:
#include( "one.txt" )
如果有多个文件需要引入,可以用逗号分隔
#include( "one.gif","two.txt","three.htm" )
同时引入两个文件,其中一个文件用变量来指定路径以及文件名
#include( "greetings.txt", $seasonalstock )
7、#parse
对比#include,该标签可以包含VTL,可以被Velocity Engine进行render。但是只接受一个参数
8、#stop
该标签后面的html将不进行解析和展现
9、#evaluate
对字符串进行render,感觉用处不大
10、#define
相当于一个“函数”,定义一个代码块,可在后续进行引用,例如:
#define($myfunc) $who,hello!#end
#set($who="kongxuan")
$myfunc
运行结果:
kongxuan,hello!
11、#macro
宏调用,是一个非常重要的指令。用来抽取页面中重复的VTL代码片段。
#macro( tablerows $color $somelist )
#foreach( $something in $somelist )
<tr><td bgcolor=$color>$something</td></tr>
#end
#end
#set( $greatlakes = ["Superior","Michigan","Huron","Erie","Ontario"] )
#set( $color = "blue" )
<table>
#tablerows( $color $greatlakes )
</table>
注意:宏可以写在文件VM_global_library.vm里面,resource根目录下,且需要新增配置项:
在velocity.properties中新增配置项velocimacro.library=VM_global_library.vm
二、velocity配置项
(待续)