VTL(Velocity Templates Language,即Velocity模板语言)初识语法总结

时间:2022-03-23 06:12:39

1.velocity是一门基于Java语言的视图表现层模板引擎,它可以取代jsp,比jsp更高效。

2.velocity变量的定义与引用

(1).定义一个变量:#set ($a = "velocity"),变量名为 $a

(2).引用上面定义的变量:Hello $a

3.velocity中!号的含义及使用

(1).#if ($!msg) hello #end:若引用值 $msg 不为空则输出 hello,否则什么都不输出。

4.velocity中的循环语句语法

#foreach ($stu in $slist)

  ${stu.name}

  ${stu.age}

#end

以上$slist是从Java代码中引用的对象,$stu是$slist中的一个元素。

5.velocity中的注释

(1).单行注释:##注释内容

(2).多行注释:

#*

注释内容

*#

(3).文档格式:

#**

This is a VTL comment block and
may be used to store such information
as the document author and versioning
information:
@version 5
@author

*#

6.在VTL中有三种类型的references:变量(variables)、属性(properties)、方法(methods)。

${mudSlinger} 变量
${customer.Address} 属性
${purchase.getTotal()} 方法

7.注意:VTL中未被定义的变量将被认为是一个字符串,所以以下例子:

#set( $foo = “gibbous” )
$moon = $foo
的输出结果是:
$moon = gibbous

8.注意VTL中不会将reference解释为对象的实例变量。例如:$foo.Name将被解释

为Foo对象的getName()方法,而不是Foo对象的Name实例变量。

9.#set ( $monkey.Say = [“Not”, $my, “fault”] )

例子的取值方法为:$monkey.Say.get(0)

10.#if ( $foo )

<strong>Velocity!</strong>
#end
上例中的条件语句将在以下两种条件下成立:
$foo是一个boolean型的变量,且它的值为true
$foo变量的值不为null

11.if else语句例子:

#if( $foo < 10 )
<strong> Go North </strong>
#elseif( $foo == 10 )
<strong> Go East </strong>
#elseif( $foo == 6 )
<strong> Go South </strong>
#else
<strong> Go West </strong>
#end

12.velocity的逻辑运算符:

Velocity有AND、OR和NOT逻辑运算符。下面是一些例子:
## logical AND
#if( $foo && $bar )
<strong> This AND that </strong>
#end

## logical OR
#if ( $foo || $bar )
<strong>This OR That </strong>
#end

##logical NOT
#if ( !$foo )
<strong> NOT that </strong>
#end

13.Velocity还特别提供了得到循环次数的方法,以便你可以像下面这样作:

<table>
#foreach ( $customer in $customerList )
<tr><td>$velocityCount</td><td>$customer.Name</td></tr>
#end
</table>
$velocityCount变量的名字是Velocity默认的名字,你也可以通过修改velocity.properties文件来改变它。

默认情况下,计数从“1”开始,但是你可以在velocity.properties设置它是从“1”还是从“0”开始。

14.include 

#include script element允许模板设计者引入本地文件。被引入文件的内容将不会通过模板引擎被render。
为了安全的原因,被引入的本地文件只能在TEMPLATE_ROOT目录下。
#inclued ( “one.txt” )
如果您需要引入多个文件,可以用逗号分隔就行:
#include ( “one.gif”, “two.txt”, “three.htm” )
在括号内可以是文件名,但是更多的时候是使用变量的:
#inclue ( “greetings.txt”, $seasonalstock )

15.parse 

#parse script element允许模板设计者一个包含VTL的本地文件。Velocity将解析其中的VTL并render模板。
#parse( “me.vm” )
就像#include,#parse接受一个变量而不是一个模板。任何由#parse指向的模板都必须包含在
TEMPLATE_ROOT目录下。与#include不同的是,#parse只能指定单个对象。

16.#stop script element允许模板设计者停止执行模板引擎并返回。把它应用于debug是很有帮助的。 

17.#macro script element允许模板设计者定义一段可重用的VTL template。例如: 

#macro ( d )
<tr><td></td></tr>
#end
在上面的例子中Velocimacro被定义为d,然后你就可以在任何VTL directive中以如下方式调用它:
#d()

18.其他特性和杂项 

math 在模板中可以使用Velocity内建的算术函数,如:加、减、乘、除
#set ( $foo = $bar + 3 )
#set ( $foo = $bar - 4 )
#set ( $foo = $bar * 6 )
#set ( $foo = $bar / 2 )
当执行除法时将返回一个Integer类型的结果。而余数你可以使用%来得到:
#set ( $foo = $bar % 5 )

19.开发人员最常问的问题是我如何作字符拼接?在java中是使用“+”号来完成的。 

在VTL里要想实现同样的功能你只需要将需要联合的reference放到一起就行了。例如:
#set ( $size = “Big” )
#set ( $name = “Ben” )
The clock is $size$name.
输出结果将是:The clock is BigBen.。更有趣的情况是:
#set ( $size = “Big” )
#set ( $name = “Ben” )
#set ( $clokc = “$size$name” )
The clock is $clock.
上例也会得到同样的结果。