Velocity 语法.docx

1、Velocity 语法Velocity 语法（转）一、基本语法1、#用来标识Velocity的脚本语句，包括#set、#if 、#else、#end、#foreach、#end、#iinclude、#parse、#macro等；如:#if($info.imgs)#else#end2、$用来标识一个对象(或理解为变量)；如如：$i、$msg、$TagUtil.options(.)等。3、用来明确标识Velocity变量；比如在页面中，页面中有一个$someonename，此时，Velocity将把someonename作为变量名，若我们程序是想在someone这 个变量的后面紧接着显示name字

2、符，则上面的标签应该改成$someonename。4、!用来强制把不存在的变量显示为空白。如当页面中包含$msg，如果msg对象有值，将显示msg的值，如果不存在msg对象同，则在页面中将显示$msg字符。这是我们不希望的，为了把不存 在的变量或变量值为null的对象显示为空白，则只需要在变量名前加一个“!”号即可。如：$!msg二、在EasyJWeb中的最佳实践 理论上你可以在EasyjWeb模板使用所有Velocity的脚本及功能，但我们不推荐你在界面模板中使用过多过复杂的脚本表达方式，在万不得已的情况下，不要在界面模板中加入任何复杂的逻辑，更不要在界面模板中加入变量声明、逻辑运算符等等。

3、在EasyJWeb中，我们提供了五条基本的模板脚本语句，基本上就能满足所有应用模板的要求。这四条模板语句很简单，可以直接由界面设计人员来添加。在当前很多EasyJWeb的应用实践中，我们看到，所有界面模板中归纳起来只有下面四种简单模板脚本语句即可实现：1、$!obj 直接返回对象结果。如：在html标签中显示java对象msg的值。$!msg在html标签中显示经过HtmlUtil对象处理过后的msg对象的值$!HtmlUtil.doSomething($!msg)2、#if($!obj) #else #end 判断语句如：在EasyJWeb各种开源应用中，我们经常看到的用于弹出提示信息msg

4、的例子。#if($msg)alert($!msg);#end上面的脚本表示当对象msg对象存在时，输出等后面的内容。3、#foreach( $info in $list) $info.someList #end循环读取集合list中的对象，并作相应的处理。如：EasyJF开源论坛系统中论(0.3)坛首页显示热门主题的html界面模板脚本：#foreach( $info in $hotList1)$!info.title#end上面的脚本表示循环遍历hotList1集合中的对象，并输出对象的相关内容。4、#macro(macroName)#end 脚本函数(宏)调用，不推荐在界面模板中大量使用。

5、如：在使用EasyJWeb Tools快速生成的添删改查示例中，可以点击列表的标题栏进行升降排序显示，这是我们在EasyJWeb应用中经常看到的一个排序状态显示的模板内容。函数(宏)定义，一般放在最前面#macro(orderPic $type)#if ($orderField.equals($type)img src=#end#end具体的调用如：头衔#orderPic(title)经过测试，宏不支持方法重载5、包含文件#inclue(模板文件名)或#parse(模板文件名)主要用于处理具有相同内容的页面，比如每个网站的顶部或尾部内容。使用方法，可以参考EasyJF开源Blog及EasyJF

6、开源论坛中的应用！如：#parse(/blog/top.html)或#include(/blog/top.html)parse与include的区别在于，若包含的文件中有Velocity脚本标签，将会进一步解析，而include将原样显示。三、关于#set的使用在万不得已的时候，不要在页面视图自己声明Velocity脚本变量，也就是尽量少使用#set。有时候我们需要在页面中显示序号，而程序对象中又没有包 含这个序号属性同，可以自己定义。如在一个循环体系中，如下所示：#set ($i=0)#foreach($info in $list)序号:$i#set($i=$i+1)#end四、Veloci

7、ty脚本语法摘要1、声明:#set ($var=XXX)左边可以是以下的内容Variable referenceString literalProperty referenceMethod referenceNumber literal #set ($i=1)ArrayList #set ($arr=yt1,t2)算术运算符2、注释:单行# XXX多行#* xxxxxxxxxxxxxxxxxxx*#References 引用的类型3、变量 Variables以 $ 开头，第一个字符必须为字母。character followed by a VTL Identifier. (a . z or A

8、 . Z).变量可以包含的字符有以下内容：alphabetic (a . z, A . Z)numeric (0 . 9)hyphen (-)underscore (_)4、Properties$Identifier.Identifier$user.namehashtable user中的的name值.类似：user.get(name)5、Methodsobject user.getName() = $user.getName()6、Formal Reference Notation用把变量名跟字符串分开如#set ($user=csy$username返回csyname$username$!

9、username$与$!的区别当找不到username的时候，$username返回字符串$username，而$!username返回空字符串7、双引号 与 引号#set ($var=helo)test$var 返回testhellotest$var 返回test$var可以通过设置 stringliterals.interpolate=false改变默认处理方式8、条件语句#if( $foo )Velocity!#end#if($foo)#elseif()#else#end当$foo为null或为Boolean对象的false值执行.9、逻辑运算符:= & | !10、循环语句#forea

10、ch($var in $arrays )/ 集合包含下面三种Vector, a Hashtable or an Array#end#foreach( $product in $allProducts )$product#end#foreach( $key in $allProducts.keySet() )Key: $key - Value: $allProducts.get($key)#end#foreach( $customer in $customerList )$velocityCount$customer.Name#end11、velocityCount变量在配置文件中定义# Def

11、ault name of the loop counter# variable reference.directive.foreach.counter.name = velocityCount# Default starting value of the loop# counter variable reference.directive.foreach.counter.initial.value = 112、包含文件#include( one.gif,two.txt,three.htm )13、Parse导入脚本#parse(me.vm )14、#stop 停止执行并返回15、定义宏Velo

12、cimacros ,相当于函数 支持包含功能#macro( d )#end调用#d()16、带参数的宏#macro( tablerows $color $somelist )#foreach( $something in $somelist )$something#end#end17、Range Operator#foreach( $foo in 1.5 )附：浅析MVC框架中View层的优雅设计及实例作者：EasyJF开源团队 大峡在基于B/S的应用程序开发中，从基本的技术分工上来说就是两大块，一是软件显示界面，另一个是程序逻辑。在N年前的脚本语言时代，无论是asp、 php还是jsp，我们

13、基本是都是把这两者柔和在一起的。尽管我们想方设法做好很多函数或者包含文件来努力达到软件的复用，但仍然无法满足多变的用户需 求,这主要是因为以前的纯脚本编码方式无法很好支持及应用面向对象(OO)领域中的强大功能。在常见的B/S软件项目中，界面的设计包括html界面、Wap界面及其它由文本字符协议为基本表示的界面等。以我们接触最多的html页面为例子，在 做这些界面的时候往往需要美工先使用photoshop或fireworks等图形界面设计工具进行全局设计，然后再使用进行Dreamweaver等 html页面制作工具进行加工制作。而强大的程序逻辑及后台处理都是由服务器端程序完成，这些程序具有较高的

14、稳定性，其开发工具如JBuilder、 Eclipse等对View层的界面无法很好的支持(当然那些用记事本写界面的应用除外)，这就使得很多MVC框架的设计都无法两全齐美。作位一个比较友好的MVC的框架，在简化服务器应用开发的同时，还需要在View这一层设计上不要过多的影响到界面人员的工作，最基本的要求就是不要过 多的加入一些设计软件不支持的标签等元素(如Struts的很多标签在Dreamweaver中都不支持)。这里我们以EasyJWeb为例，探讨在 View层如何实现比较合理的设计。EasyJWeb作为一个快速Java Web MVC框架，其设计目标不尽是要简化软件开发人员的代码书写工作，更

15、是要能方便界面设计人员的工作。当然，要使界面能跟后台程序逻辑能融合，显示界面及程序逻辑之间需要一定的对话协议在所难免。EasyJWeb作为一个MVC框架，同样也存在着这样的对话协议，这就是EasyJWeb中的界面模板标识语言。在当前发布的版本中，EasyJWeb界面模板标识语言使用的是Apache开源的Velocity模板引擎(template engine)，当然以后会根据际需要加入更多的模板引擎以供框架应用者选择。Velocity是一个基于java的模板引擎（template engine），它允许任何人仅仅简单的使用模板语言（template language）来引用由java代码定义的

16、对象。作为一个比较完善的模板引擎，Velocity的功能是比较强大的，但强大的同时也增加了应用复杂 性。理论上你可以在EasyjWeb模板使用所有Velocity的脚本及功能，但我们不推荐你在界面模板中使用过多过复杂的脚本表达方式，在万不得已的情况下，不要在界面模板中加入任何复杂的逻辑，更不要在界面模板中加入变量声明、逻辑运算符等等。在EasyJWeb中，我们提供了四条基本的模板脚本语句，基本上就能满足所有应用模板的要求。这四条模板语句很简单，可以直接由界面设计人员来添加。在当前很多EasyJWeb的应用实践中，我们看到，所有界面模板中归纳起来只有下面四种简单模板脚本语句即可实现：1、$!ob

17、j 直接返回对象结果。如：在html标签中显示java对象msg的值。$!msg在html标签中显示经过HtmlUtil对象处理过后的msg对象的值.$!HtmlUtil.doSomething($!msg)2、#if($!obj) #else #end 判断语句如：在EasyJWeb各种开源应用中，我们经常看到的用于弹出提示信息msg的例子。#if($msg)alert($!msg);#end上面的脚本表示当对象msg对象存在时，输出等后面的内容。3、#foreach( $info in $list) $info.something #end循环读取集合list中的对象，并作相应的处理。如：

18、EasyJF开源论坛系统中论坛首页显示热门主题的html界面模板脚本#foreach( $info in $hotList1)$!info.title#end上面的脚本表示循环遍历hotList1集合中的对象，并输出对象的相关内容。4、#macro(macroName)#end 脚本函数(宏)调用，不推荐在界面模板中大量使用。如：在EasyJF简易订销管等系统中经常看到的一个排序状态显示的模板内容。函数(宏)定义，一般放在最前面#macro(orderPic $type)#if ($orderField.equals($type)img src=#end#end具体的调用如：头衔#orderP

19、ic(title)总结：当然，在实际应用项目中，为了实现界面的更加友好、人性化，会出现很多复、易变的需求。如根据对象的不同状态，显示不同的提示颜色、提示语音等功能。在这 种时候，仍然要慎用太多的模板脚本功能，大多数需求都可以通过变通的方式解决，有些信息可以直接在对象中增加逻辑转化信息，有些界面要求可以通过在界面中 使用与特定界面有关的表达方式来实现，如html页面中使用javascript、css，Wap页面中使用WMLScript等等。只有，这样才能确保 证你的系统核心不受界面的的影响及控制，才能更好的扩展及维护。我们希望你能成为真正的程序高手，而不只是精通某个处于表层的脚本语言，因此也不希

20、望广大Java开发人员在View层消耗太多的时间。由于水平有限，本文所谈的内容有N多不合理或者需要改进的地方，恳请大家指正！附：EasyJWeb简介EasyJWeb是基于java技术，应用于WEB应用程序快速开发的MVC框架，框架设计构思来源于国内众多项目实践，充分借签了当前主流的开源 Web框架（Struts、JSF、Tapestry 、Webwork等），吸取了其优点及精华，利用Velocity作为模板页面引擎，是一个实现了页面及代码完全分离的MVC开发框架，是一个旨在于为中 小型Web应用系统提供快速开发实践的简易Web框架。EasyJF开源团队于2006年初才开始建设，因此当前整个开发团队组建以及所发布的作品，都显得极不成熟。EasyJWeb仍然处于测试阶段，请广大的Java爱好者多多批评及建议,同时也非常欢迎您能加入到我们的国产开源队伍中。