Velocity模板使用指南中文版

领先的  与 技术推广者

《Velocity 模板使用指南》中文版

源文见 http://velocity.apache.org

声明转载请保留此页声明



此文档为蓝杰实训学员拓展实训之用

蓝杰实训不对译文中某些说法可能会对您的系统或开发造成损害负责

如对您有所帮助，我们不胜荣幸！

《%&' 中文系列之起步篇》



更多资料请访问 http://www.netjava.cn/



译者: javaFound

($)*++



,,,

领先的  与 技术推广者

目 录

1.本文目地和使用对象......................................................................................................................................3

7.References(引用).............................................................................................................................................5

1.Variables(变量)........................................................................................................................................6

2.Properties(属性).......................................................................................................................................6

3.Methods（命令）....................................................................................................................................6

4.属性引用中的属性查找规则.................................................................................................................7

8.Formal Reference Notation(正规引用格式注意事项)...................................................................................7

9.Quiet Reference Notation(静态引用输出).....................................................................................................7

10.Getting literal( 语义问题).............................................................................................................................8

1.Currency(货币标志)................................................................................................................................8

3.Conditionals(条件判断)........................................................................................................................13

4.Loops(循环)...........................................................................................................................................15

3.Include(引入).........................................................................................................................................16

6.Parse(解析模板)....................................................................................................................................16

7.Stop........................................................................................................................................................16

8.Velocimacros(宏调用)...........................................................................................................................17

13.注掉 VTL Directives...................................................................................................................................19

14.VTL: 一般使用的格式................................................................................................................................20

16.Feedback......................................................................................................................................................25

,,,

领先的  与 技术推广者

-本文目地和使用对象

本文主要介绍如何在模板中使用  功能强大的模板语言 !"!+"**

用法有一个全面的认识，并掌握如何在模板中有效使用。同时，本文提供较多的例子帮您来学习它。

感谢您选择  帮助您实现纯正的 (. 系统构架。

2.什么是 Velocity?

是一个基于  的模板引擎+*它可以让视图的设计者在 , 页面中

引用  代码中定义的数据对象和命令。从而使 * 和  开发者依照 (. 思想

(/,/.开发系统0这意味着 * 只须将精力注用于良好表现力的视图外

观设计，而  程序员则只要关心着如何写出高效简洁的  对象以实现业务逻辑///// 会将

3.Velocity 能为你做什么?

1.一个 Mud Store Example

假设你是一个 **在为一个在线商店设计页面我们称这个项目为 6!5'(

36业务发展还不错，客户会订购不同类型的 (0每个客户都会用自己的帐号密码 *0查看选择

他们订购的 (0查看订单，但还有些忠诚用户会购卖不太流行的 (////这些不需要出现在页面中显

眼的地方。当然，!5'(3 必须把每个客户资料及订购信息记录到 % 中，现在的问题

是，如何让某个客户 * 后就看到他感兴趣的信息？

使用 7我们为每个客户定制一个页面！这听起来工作量巨大，让我们试试：

使用  的 !"如下来设计 ,*

82!("9

,,,

领先的  与 技术推广者

;$<+515<+

89

89

<=***1+<+

8>9

8>9

;

;

8>9

使用 !" 设计页面就是这么简单！文档《!" 参考中文版》中有更全面的 !" 语言介绍，掌握这些，

象加入到你的 ,0 中的变量只是 $ 中的一种 是用来描述

从引入到视图模板中的  数据对象。当然， 代码也可以从模板的 !" 中获取数据以下是一个写

在 2!(" 中的 !" 变量

;<?66

!" 声明+0所有的 !"+ 都是以#开头，且包含一个指示符（这里是 set）0当客

户访问你的页面时05!+*@* 将搜索页面中的所有 #符号0如果确定这是一个

!" 声明时就按一定规则处理动态内容0符号;仅仅只是表明这可能是一个 !" 声明

符号#所跟的 set 我们用“指示符”这一名词来称呼它随后介绍更多的指示符0set指示符使用一个表达

式A包含在一对括号里B将一个值 value这里是 付给变量 0（变量名在左边，

值在右边，用?组合起来）

如上0#set用来指定值给一个变量名$a0以“<C标示的变量名  的值就是66

,,,

领先的  与 技术推广者

5.输出第一个 !" 页面7

有你的 2!(" 文档的任何地方，都可以引用一个变量名来输出值0如下例0先给变量名 foo赋值为

0然后将它输出到页面中

85+9

89

;<$?66

2<$7

8>9

85+9

;;!5*++

单行注释是以##开头的一行文字如要写下多行注释，就要像下面那样，将它们放入#*和*#间

!5A55+/++

'

;

!5*+/++',D

5A5!+*@*,

*

;

不需要太复杂了，这两种方式己足够你给自己的页面加上充分的说明。

,,,