Velocity的中文指南（3）－整理
7.3. 方法
方法在JAVA代码中定义，并作一些有用的事情，比如运行一个计算器或者作出一个决定。方法是实际上也是引用，由前导符"$"后跟一个VTL 标识符，后跟一个VTL 方法体（Method Body）。 VTL 方法体由一个VTL 标识符后跟一个左括号，再跟可选的参数列表，最后是右括号。下面是一些有效的方法示例：
| $customer.getAddress() $purchase.getTotal() $page.setTitle( "My Home Page" ) $person.setAttributes( ["Strange", "Weird", "Excited"] ) |
前面两个例子-- $customer.getAddress() 和 $purchase.getTotal() – 看起来有点象上面属性一节中所用的样子， $customer.Address 和 $purchase.Total.。如果你想这些例子在某些方面相关，那你就对了。
VTL 属性可以为VTL方法用作简略标记。属性$customer.Address 具有和方法$customer.getAddress() 完全一样的效果。属性和方法的主要不同点是方法中可以添加参数列表。
简略标记可以用在下面的方法中：
| sun.getPlanets() $annelid.getDirt() $album.getPhoto() |
我们或许希望方法可以为我们放回属于太阳系的行星的名字，喂养我们的蚯蚓，或者从相册中返回一张照片。下面只有长的那个标记是可以工作的方法：
| $sun.getPlanet( ["Earth", "Mars", "Neptune"] ) ## 不能将参数列表传递给$sun.Planets
$sisyphus.pushRock() ## Velocity 假定我意思是$sisyphus.getRock()
$book.setTitle( "Homage to Catalonia" ) ## 不能传递一个参数列表
|
7.4. 形式引用符Formal Reference Notation
引用的简略符号如上所述，但是另外还有一种引用的形式符号，示例如下：
| ${mudSlinger} ${customer.Address} ${purchase.getTotal()} |
在大多数情况下，我们将使用引用的简略符号，但在一些情况下，也需要拥戴哦形式引用符以便正确处理。
假定你正在纸片上构件一个句子，将使用$vice 作为句子中名词的词根。我们的目标是允许人们选择词根，然后产生以下两种结果之一：
"Jack is a pyromaniac."
或者 "Jack is a kleptomaniac."。
在这种情况下，使用简略符号是不太充分的。考虑到下面的例子：
| Jack is a $vicemaniac. |
这里有个不确定性， Velocity 假定 $vicemaniac，（而不是 $vice） 是一个你想要使用的标识符。 找不到$vicemaniac的值，他将返回$vicemaniac。使用形式符号便可解决这个问题：
| Jack is a ${vice}maniac |
现在Velocity 知道 $vice（而不是 $vicemaniac） 是一个引用。形式符号常用在饮用咋模板中和文本直接邻近的地方。
7.5. 安静引用符Quiet Reference Notation
当 Velocity 遇到一个位定义的引用时，其通常行为是输出这个引用的映像。比如，假设下面的引用出现在模板中的一部分：
| <input type="text" name="email" value="$email"/> |
当表单初次装入时，变量引用$email 无值，你宁愿是一个空白域而不是具有值"$email"。使用安静引用符可以绕过Velocity的常规行为，在VTL中不用$email 而是用$!email 符号。 所以，上面的例子将会看起来像下面的样子：
| <input type="text" name="email" value="$!email"/> |
现在，当表单初次装入时， $email 仍然没有值，但是将输出空字符串而不是"$email"。
形式和安静引用符可以一起使用，如下所示：
| <input type="text" name="email" value="$!{email}"/> |