神马文学网Velocity用户指南（中文版）(2)
来源：百度文库 编辑：神马文学网 时间：2024/06/28 09:16:08
author:http://blog.csdn.net/chenyun2000/archive/2004/07/08/36764.aspx
引用(References)
VTL有3种类型的引用：变量、属性和方法。作为一个设计者，必须和Java工程师在VTL引用的名称（标识符）上一致，以便在模板中使用它们。引用是作为String对象处理的。
（1）变量
变量的格式：$VTL标识符
VTL标识符以字母开始，由字母、数字、横划线(-)或下划线(_)组成。变量或者从模板中的set指令获得值（如前面的例子），或者Java代码（同名变量）中获得值。Velocity只处理已定义的变量引用，对于没有定义的变量引用，Velocity原样返回。例如下面的例子：
#set( $foo = "gibbous" )$moon = $foo
输出结果是：$moon = gibbous
（2）属性
属性的格式：$VTL标识符. VTL标识符
下面是属性引用的例子：
$customer.Address$purchase.Total
拿第一例子来说，有两种意思：
l 返回Hashtable对象customer中键值为Address的值
l $customer.getAddress()方法引用的缩写（JavaBean属性的getter方法）
至于是哪种情况，Velocity会做决定，返回合适的值。
（3）方法
方法的格式：$VTL标识符(参数列表)
下面是方法引用的例子：
$customer.getAddress()$purchase.getTotal()$page.setTitle( "My Home Page" )$person.setAttributes( ["Strange", "Weird", "Excited"] )
前面两个例子可以缩写成属性引用（如属性引用的例子）。属性引用和方法引用的主要区别是方法引用可以指定参数列表。
（4）正式引用符号：{}
正式引用符号在使用变量引用含糊的地方进行区分。看下面的例子：
#set( $vice = "klepto" )Jack is a $vicemaniac.
输出结果是：Jack is a $vicemaniac.（$vicemaniac没有定义，原样输出）
#set( $vice = "klepto" )Jack is a ${vice}maniac.
输出结果是：Jack is a kleptomaniac.（使用正式引用符号将$vice和其它文本区分开）
（5）Quit引用符号：!
看下面的例子：
初始时，$email没有值，所以文本框中会显示值$email，而更希望是空白。下面是使用Quit引用符号的例子：
当$email没有值时，Velocity会用空串替代$email。
（6）特殊字符转义
对于$、#等特殊字符要正常显示，可以使用\进行转义，\\转义为\。下面是一个例子：
#set( $email = "foo" )$email\$email\\$email\\\$email
输出结果是：
foo$email\foo\$email
引用(References)
VTL有3种类型的引用：变量、属性和方法。作为一个设计者，必须和Java工程师在VTL引用的名称（标识符）上一致，以便在模板中使用它们。引用是作为String对象处理的。
（1）变量
变量的格式：$VTL标识符
VTL标识符以字母开始，由字母、数字、横划线(-)或下划线(_)组成。变量或者从模板中的set指令获得值（如前面的例子），或者Java代码（同名变量）中获得值。Velocity只处理已定义的变量引用，对于没有定义的变量引用，Velocity原样返回。例如下面的例子：
#set( $foo = "gibbous" )$moon = $foo
输出结果是：$moon = gibbous
（2）属性
属性的格式：$VTL标识符. VTL标识符
下面是属性引用的例子：
$customer.Address$purchase.Total
拿第一例子来说，有两种意思：
l 返回Hashtable对象customer中键值为Address的值
l $customer.getAddress()方法引用的缩写（JavaBean属性的getter方法）
至于是哪种情况，Velocity会做决定，返回合适的值。
（3）方法
方法的格式：$VTL标识符(参数列表)
下面是方法引用的例子：
$customer.getAddress()$purchase.getTotal()$page.setTitle( "My Home Page" )$person.setAttributes( ["Strange", "Weird", "Excited"] )
前面两个例子可以缩写成属性引用（如属性引用的例子）。属性引用和方法引用的主要区别是方法引用可以指定参数列表。
（4）正式引用符号：{}
正式引用符号在使用变量引用含糊的地方进行区分。看下面的例子：
#set( $vice = "klepto" )Jack is a $vicemaniac.
输出结果是：Jack is a $vicemaniac.（$vicemaniac没有定义，原样输出）
#set( $vice = "klepto" )Jack is a ${vice}maniac.
输出结果是：Jack is a kleptomaniac.（使用正式引用符号将$vice和其它文本区分开）
（5）Quit引用符号：!
看下面的例子：
初始时，$email没有值，所以文本框中会显示值$email，而更希望是空白。下面是使用Quit引用符号的例子：
当$email没有值时，Velocity会用空串替代$email。
（6）特殊字符转义
对于$、#等特殊字符要正常显示，可以使用\进行转义，\\转义为\。下面是一个例子：
#set( $email = "foo" )$email\$email\\$email\\\$email
输出结果是：
foo$email\foo\$email
Velocity用户指南（中文版）(2)
Velocity用户指南中文版
Velocity用户手册---中文版
Velocity用户手册---中文版
Velocity用户手册---中文版
Velocity 《VTL语法参考指南》中文版
HDFS用户指南(翻译）
velocity
（中文版）
HDFS用户指南(翻译） - 企业应用 - Java - JavaEye论坛
HDFS用户指南(翻译） - 企业应用 - Java - JavaEye论坛
HDFS用户指南(翻译） - 企业应用 - Java - JavaEye论坛
云清用户指南——抛光材料（2007版）
云清用户指南第一分册（2008版）
velocity简介
Velocity用户手册
Velocity入门
Velocity用户手册
小王子（中文版）
《断背山》（中文版小说）
中文版传播理论书目（2008年2月）
中文版传播理论书目（2008年2月）
标准C++ 库用户指南
《海龟交易法则》中文版2