第六章 VTL语法参考指南 中文版.doc

目?? 录 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. 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命令. 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,除和取模: 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 [ } ] ( [condition] ) [output] ]* [ # [ { ] else [ } ] [output] ] # [ { ] end [ } ] Usage: condition – 如果是boolean型，根据true或false决定,否则非null时认为是true. output –可以包含VTL的输出内容. Examples (showing different operators): Operator Nam