(一) velocity语法与配置项-优快云博客

一、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配置项

（待续）