《VTL语法参考指南中文版》.doc

《VTL语法参考指南》中文版 源文见 ************************************************************************* 声明: 转载请保留此页声明 译者: javaFound www.N Mail: javafound@ ************************************************************************* 目 录 1.关于本指南 3 2.语法参考 3 1.变量定义 3 2.访问属性 3 命令调用 3 3.动作指令 3 1.#set – 建立变量对值的引用 3 2.#if/#elseif/#else-条件判断 4 3.#foreach使用循环通过列表迭代对象 5 4.#include – 在模板中引入本地文件，不用Velocity解析这个文件 5 5.#parse – 在模板引用处使用Velocity解析另一个模板输出 6 6.#stop – 中断模板解析 6 7.#macro – 让用户可以定义宏操作(Velocimacro (VM):一组实现特定功能的VTL) 6 4.Comments 注解 7 1.单行注解 7 2.多行注解 7 5.Feedback 7  1.关于本指南 本文为Velocity的模板语言参考书,如需了解更多信息，请参见 Velocity User Guide. 2.语法参考 1.变量定义 变量名的有效字符集: $ [ ! ][ { ][ a..z, A..Z ][ a..z, A..Z, 0..9, -, _ ][ } ] Examples: 一般方式: $mud-Slinger_9 静态(输出原始字面): $!mud-Slinger_9 正规格式: ${mud-Slinger_9} 2.访问属性 格式规则: $ [ { ][ a..z, A..Z ][ a..z, A..Z, 0..9, -, _ ]* .[a..z, A..Z ][ a..z, A-Z, 0..9, -, _ ]* [ } ] Examples: 一般格式: $customer.Address :调用customer对象的getAddress()命令. 正规格式: ${purchase.Total} 3.命令调用 格式规则: $ [ { ][ a..z, A..Z ][ a..z, A..Z, 0..9, -, _ ]* .[ a..z, A..Z ][ a..z, A..Z, 0..9, -, _ ]*( [ optional parameter list... ] ) [ } ] Examples: 一般写码: $customer.getAddress() 正规写法: ${purchase.getTotal()} 传入调用参数: $page.setTitle( My Home Page ) VTL的属性调用可以理解为命令调用的简写方式,一般会调用对象的get/set命令. 3.动作指令 1.#set – 建立变量对值的引用 格式规则: # [ { ] set [ } ] ( $ref = [ , ]arg[ , ] ) Examples: 变量引用: #set( $monkey = $bill ) 引用原始字符串: #set( $monkey.Friend = monica ) 属性引用: #set( $monkey.Blame = $whitehouse.Leak ) 命令引用: #set( $monkey.Plan = $spindoctor.weave($web) ) 直接引用数字: #set( $monkey.Number = 123 ) 列表赋值引用: #set( $monkey.Numbers = [1..3] ) 对象数组: #set( $monkey.Say = [Not, $my, fault] ) 右值也可以做为一个表达式出现,如下加，减，cheng,除和取模: Addition: #set( $value = $foo + 1 ) Subtraction: #set( $value = $bar - 1 ) Multiplication: #set( $value = $foo * $bar ) Division: #set( $value = $foo / $bar ) Remainder: #set( $value = $foo % $bar ) 2.#if/#elseif/#else-条件判断 格式规则: # [ { ] if [ } ] ( [条件表达式] ) [输出内容] [ # [ { ] elseif [