15.4. Velocimacro 杂记

本节是关于Velocimacros的一个小型FAQ。本届内容会不时更新，所以请常来检查新的内容，

注 : 本节中， 'Velocimacro' 将简写为'VM'。

Q:是否可以使用指令directive 或者 VM 作为另一个VM的参数? 例如: #center( #bold("hello") )

A: 不行。指令不能用作指令的参数，而大多数情况下，作为实际的应用，VM就是指令。

不过也有一些办法。一个简单的做法是使用双引号来加工你的内容。所以，你可以这样：

  1. #set($stuff = "#bold('hello')" )
  2. #center( $stuff )

甚至可以节省一个步骤：

  1. #center( "#bold( 'hello' )" )

请注意，后面这个例子中，参数是在VM内部被求值，不是在调用的那一层次上。换句话说，被传入的VM的参数是整个被传入的，并且在传入的VM内部被求值。所以我们可以这样做：

  1. #macro( inner $foo )
  2.  inner : $foo
  3. #end
  5. #macro( outer $foo )
  6.    #set($bar = "outerlala")
  7.    outer : $foo
  8. #end
  10. #set($bar = 'calltimelala')
  11. #outer( "#inner($bar)" )

这里，输入将会是：

  1. Outer : inner : outerlala

因为"#inner($bar)" 的求值发生在#outer()内部，所以在#outer() 内设置的$bar得值会是其使用的值。

这是一个有意的保护特征—参数按名称传递给VM，所以可以将象状态引用的东西传给VM ，比如：

  1. #macro( foo $color )
  2.  <tr bgcolor=$color><td>Hi</td></tr>
  3.  <tr bgcolor=$color><td>There</td></tr>
  4. #end
  6. #foo( $bar.rowColor() )

rowColor() 被重复调用而不是一次。为避免如此，可以调用VM外部的方法，然后将值传递给VM.

  1. #set($color = $bar.rowColor())
  2. #foo( $color )

Q:是否可以通过#parse()注册VM ?

A：当前， Velocimacros 在其首次在模版中使用前必须首先定义它。这意味着， #macro() 宣称应该在使用Velocimacros之前。

如果你想#parse() 一个包含#macro() 指令的模板，记住这个非常重要。因为#parse() 在运行时发生，解析器在解析时要决定是否模版中一个看起来像VM的元素真是VM，所以解析一系列VM 宣称可能并不能如愿地工作的很好。为避免如此，可以简单地使用velocimacro.library 的办法，使Velocity 在启动时载入VM。

Q. 什么是VM自动载入（Velocimacro Autoreloading）?

A. 这是一个属性，在开发时使用，而不时运行时：

  1.  velocimacro.library.autoreload

默认值为false。当设置为true时，连同<type>.resource.loader.cache 属性设置为false（这里 是使用的资源载入器的名称，比如'file') ，Velocity 引擎在你创建VM库文件是将自动载入其改变，这样你就不必将其导入servlet 引擎（或者应用程序）中，或者用其他手段来使其自动重新载入。

下面是一个简单的设置配置组合：

  1. file.resource.loader.path = templates
  2.     file.resource.loader.cache = false
  3.     velocimacro.library.autoreload = true

注意在生产状态（运行时）不要使其打开。