velocity的中文指南(编辑修改稿)

velocity的中文指南(编辑修改稿)内容摘要：

ia ) set( $result = $($criterion) ) if( $result ) Query was successful end end 在上面的例子中，依靠 $result 的去值来决定查询是否成功恐怕不 是英明的做法。 当 $result 被 set设置后 (添加到上下文中 )，他就不能再被设值为 null (从上下文中删除 )。 我们对此的解决方法是预设 $result 为 false。 然后如果 $() 调用失败，你就可以检查之。 set( $criteria = [name, address] ) foreach( $criterion in $criteria ) set( $result = false ) set( $result = $($criterion) ) if( $result ) Query was successful end end 不象其他 Velocity 指令， set 指令没有 end 语句。 . 字面字符串 当使用 set 指令时，括在双引号中的字面字符串将解析和重新解释，如下所示： set( $directoryRoot = ) set( $templateName = ) set( $template = $directoryRoot/$templateName ) $template 输出将会是： / 然而，当字面字符串括在单引号中时，他将不被解析： set( $foo = bar ) $foo set( $blargh = 39。 $foo39。 ) $blargh 输出是： Bar $foo 默认情况下，使用单引号来渲染未解析文本在 Velocity是有效的。 这种特征可以通过编辑 中 的 =false来改变。 . 条件 . If / ElseIf / Else Velocity中的 if 指令允许在页面生成时，在 IF 条件为真的情况下包含文本。 例如： if( $foo ) strongVelocity!/strong end 变量 $foo 先求值，以决定是否为真。 在这两种情况下为真： (i) $foo 是一个逻辑变量并具有真的值，或者 (ii) 值非空。 要记住 Velocity 上下文仅包括对象，所以当我们说“布尔” 39。 boolean39。 时，他会被表示为“布尔类” (Boolean class)。 这对即使是返回布尔类型的方法也是真的 — 自省架构将返回一个具有相同逻辑值的布尔类。 如果求值为真时， if 和 end 语句之间的内容将输出。 在这种情况下，如果 $foo 为真，输出将是Velocity!。 相反，如果 $foo 具有一个 null 值，或者逻辑假，语句求值为假，则没有输出。 一个 elseif 或者 else 项可以用在 if 语句中。 请注意， Velocity 模板引擎将在第一个为真的表达式时停止。 下面的例子中，假设 $foo 具有值 15 而 $bar 等于 6。 if( $foo 10 ) strongGo North/strong elseif( $foo == 10 ) strongGo East/strong elseif( $bar == 6 ) strongGo South/strong else strongGo West/strong end 在这个例子中， $foo 大于 10，所以前面两个比较失败。 接下来比较 $bar 和 6，结果为真，所以输出为 Go South。 请注意在现在， Velocity的数值比较约束为整型 — 其他类型都将求值为 false。 仅有一个例外是等于39。 ==39。 ，这时 Velocity 要求等号两边的对象具有相同的类型。 . 关系和逻辑操作符 Velocity 使用等式操作符来决定两个变量间的关系。 这里是一个简单的例子演示如何使用等式操作符： set ($foo = deoxyribonucleic acid) set ($bar = ribonucleic acid) if ($foo == $bar) In this case it39。 s clear they aren39。 t equivalent. So... else They are not equivalent and this will be the output. end Velocity 也具有逻辑 AND, OR 和 NOT 操作符。 更进一步的信息，请看 VTL参考手册 VTL Reference Guide。 下面是一些演示如何使用逻辑操作符的例子： logical AND if( $foo amp。 amp。 $bar ) strong This AND that/strong end 例子中 if() 指令仅在 $foo 和 $bar 斗为真的时候才为真。 如果 $foo 为假，则表达式也为假；并且 $bar 将不被求值。 如果 $foo 为真， Velocity 模板引擎将继续检查 $bar。 的值，如果 $bar 为真，则整个表达式为真。 并且输出 This AND that。 如果 $bar 为假，将没有输出因为整个表达式为假。 逻辑 OR 的工作方式相同，唯一的例外是其中一个表达式要被求值，以便决定整个表达式是否为真。 请看下面的例子： logical OR if( $foo || $bar ) strongThis OR That/strong end 如果 $foo 为真， Velocity 模板引擎就不需要去察看 $bar 的值，不管 $bar 是否为真，真个表达式都为真，因此输出 This OR That。 如果 $foo 为假， $bar 就必须检查其值了。 在这种情况下，如果 $bar 也是为假，表达式将为假，没有任何输出。 当然，如果 $bar 为真，则真个表达式为真，输出 This OR That。 对于逻辑 NOT 操作符，只有一个操作数： logical NOT if( !$foo ) strongNOT that/strong end 这里，如果 $foo 为真， !$foo 求值为假，没有输出。 如果 $foo 为假， !$foo 求值为真，输出 NOT that。 请当心，不要和安静引用 quiet reference $!foo 混淆它们是完全不同的。 1. 循环 . Foreach 循环 foreach 元素允许进行循环，例如： ul foreach( $product in $allProducts ) li$product/li end /ul 这个 foreach 循环将导致 $allProducts 列表 (对象 ) 为查询所有的产品 $products (目标 )遍历一遍。 每次经过循环，从 $allProducts 取得的值将置于 $product 变量之中。 $allProducts 变量的内容是一个矢量，一个哈希表或者数组。 赋给 $product 变量的值是一个 Java 对象并且可以从一个类似的变量引用。 例如，如果 $product 真是一个 Java的产品类，其名称可以通过引用$ 方法来检索 (即 : $())。 我们假定 $allProducts 是一个哈希表。 如果你想检索关键字的值或者在哈希表中的对象 ，你可以使用以下的代码： ul foreach( $key in $() ) liKey: $key Value: $($key)/li end /ul Velocity 提供一个更容易的方式或的循环计数，以便你可以做下面类似的工作： table foreach( $customer in $customerList ) trtd$velocityCount/tdtd$/td/tr end /table 循环计数变量的缺省名称是 $velocityCount，在 配置文件中标明。 默认情况下，该变量从 1开始计数，但是可以在 文件中设为从 0 或者 1 开始。 下面是 文件中循环变量设置一节 : Default name of the loop counter variable reference. = velocityCount Default starting value of the loop counter variable reference. = 1 2. 包含 include 脚本元素允许模板设计人员包含（导入）本地文件， 这个文件将插入到 include 指令被定义的地方。 文件的内容并不通过模板引擎来渲染。 处于安全的原因，被包含的文 件只可以放在 TEMPLATE_ROOT下。 include( ) include 指令引用的文件在双引号内。 如果超过一个文件，其间用逗号隔开。 include( , ) 被包含的文件并不是一定要用文件名来引用，事实上，最好的办法是使用变量而不是文件名。 这在根据规则决定何时提交页面时，决定目标输出是很有用的。 include( , $seasonalstock ) 3. 解析 parse 脚本元素允许页面设计员导入包含 VTL的本地文件。 Velocity将解析和渲染指定的模板。 parse( ) 就象 include 指令， parse 可以使用变量而不是一个实在的模板文件。 parse 引用的模板文件必须包含的 TEMPLATE_ROOT指定的目录之下。 和 include 指令不一样， parse 只有一个参数。 VTL 模板 templates can have parse statements referring to templates that in turn have parse statements. By default set to 10, the line of the allows users to customize maximum number of parse referrals that can occur from a single template. (Note: If the property is absent from the。