Velocity简明教程1.doc

一、简介 Velocity是一个基于java的模板引擎（template engine）。它允许任何人仅仅简单的使用模板语言（template language）来引用由java代码定义的对象。 当Velocity应用于web开发时，界面设计人员可以和java程序开发人员同步开发一个遵循MVC架构的web站点，也就是说，页面设计人员可以只关注页面的显示效果，而由java程序开发人员关注业务逻辑编码。Velocity将java代码从web页面中分离出来，这样为web站点的长期维护提供了便利，同时也为我们在JSP和PHP之外又提供了一种可选的方案。 Velocity的能力远不止web站点开发这个领域，例如，它可以从模板（template）产生SQL和 PostScript、XML，它也可以被当作一个独立工具来产生源代码和报告，或者作为其他系统的集成组件使用。Velocity也可以为 Turbine web开发架构提供模板服务（template service）。Velocity+Turbine提供一个模板服务的方式允许一个web应用以一个真正的MVC模型进行开发。 二、基本语法 1 总括 1.1 #用来标识Velocity 的脚本语句，包括#set、#if 、#else、#end、#foreach、#end、#iinclude、#parse、#macro 等，例如： #if($info.imgs) img src=$info.imgs border=0 #else img src=noPhoto.jpg #end 1.2 $用来标识一个对象(或理解为变量)；如$i、$msg、$TagUtil.options(...)等。 1.3 {}用来明确标识Velocity 变量。比如在页面中，页面中有一个$someonename，此时，Velocity 将把someonename 作为变量名，若我们程序是想在someone 这个变量的后面紧接着显示name 字符，则上面的标签应该改成${someone}name。 1.4 !用来强制把不存在的变量显示为空白。如当页面中包含$msg，如果msg 对象有值，将显示msg 的值，如果不存在msg 对象同，则在页面中将显示$msg 字符。这是我们不希望的，为了把不存在的变量或变量值为null 的对象显示为空白，则只需要在变量名前加一个“!”号即可。如：$!msgd 1 变量 1.1 变量的定义 Veloctiy是一种弱类型的语言，语法结构非常简单，但在jetspeed却非常实用。因为是一种弱类型语言，所以不用定义变量的类型，编译器根据赋值的类型自动进行判断，定义的关键字为set，set前要加#，变量名前必须加$，第一个字符必须为字母。变量可以包含的字符有以下内容：alphabetic (a .. z, A .. Z)，numeric (0 .. 9)，hyphen (-)，underscore (_)。 当使用#set指令时，括在双引号中的字面字符串(string literal)将解析和重新解释，但是，当string literal被封装在单引号内时，它将不被解析。 上面这个特性可以通过修改perties文件的erpolate = false的值来改变上面的特性是否有效。 #set($directoryRoot = www ) #set($templateName = index.vm ) #set($template = $directoryRoot/$templateName ) $template #set ( $foo = “bar” ) $foo #set ( $blargh = ‘$foo ) $blargh 输出将会是：www/index.vm 结果：bar　　$foo 注：在velocity中使用$2.5这样的货币标识是没有问题得的，因为velocity中的变量总是以 $ 开头，第一个字符必须为字母。 1.2 变量规范的写法（正式格式） ${name}，也可以写成：$name。提倡用前面的写法。例如：你希望通过一个变量$vice来动态的组织一个字符串。 Jack is a $vicemaniac. 本来变量是$vice现在却变成了$vicemaniac，这样Veloctiy就不知道您到底要什么了。所以，应该使用规范的格式书写 ： Jack is a ${vice}maniac 现在Velocity知道变量是$vice而不是$vicemaniac。 注意：当引用属性的时候不能加{} $与$!的区别：当找不到username的时候，$username返回字符串$username，而$!username返回空字符串。 双引号与引号： #set($var=hello) test