velocity 新手用小常识--开源，简单易上手

项目中经常用到的 .vm 后缀文件是什么？

基于 java 的 velocity 模版引擎的一种页面控制文件，是一些类似 html 语句和一种叫 VLT 的语句构成

velocity --美 [vəˈlɑ:səti]

速率，速度；周转率；高速，快速

velocity 是一种基于 java 的模版引擎，允许任何人仅仅简单的使用模版语言来引用由 java 代码定义的对象。

.vm 文件中 velocity 的常用语法

一。基本语法

1.“#”用来标识 velocity 的脚本语句，包括： #set. #if . #else. #end. #foreach. #end . #iinclude. #parse. #macro 等

例如：

#if ($info.imgs)

#else

#end

2."$"用来标识一个对象（或理解为变量）；

如： $i; $msg $TagUtil.options(...) 等

3.“{ }”用来明确标识 velocity 变量

比如在页面中，页面汇总有一个 $someonename，此时， velocity 将把 somoonename 作为变量名，

若我们程序是想在 someone 这个变量的后面紧接着显示 name 字符，则上面的标签应该为 ${someone} name

4.“！”用来强制把不存在的变量显示为空白

如当页面中包含 $msg, 如果 msg 对象有值，将显示 msg 的值，如果不存在 msg 对象，则在页面中将显示 $msg 字符。

为了把不存在的变量或变量值为 null 的对象显示为空白，则只需要在变量名前加一个"!"号即可。如 $!msg

二。在 EasyJWeb 中的最佳实践

理论上可以在 EasyJWeb 模版中使用所有的 velocity 的脚本及功能，但是不推荐在界面模版中使用过多过复杂的脚本表达方式，

尽量不要在界面模版中加入任何复杂的逻辑，更不要在界面模版中加入变量声明，逻辑运算符等

提供了5条基本的模版脚本语句，模版语句很简单，可以直接由界面设计人员来添加

$!obj 直接返回对象结果

如：在 html 标签中显示 java 对象 msg 的值。 <p>$!msg</p>,

在 html 标签中显示经过 HtmlUtil 对象处理过后的 msg 对象的值 <p>$!HtmlUtil.doSomething($!msg)</p>

#if($!obj) #else #end 判断语句

如：在EasyJWeb 各种开源应用中，我们经常看到的用于弹出提示信息 msg 的例子

#if（$msg）

alert('$!msg');

</script>

#end

脚本表示：当对象 msg 对象存在时，输出 <script> 的内容

#if, #elseif #else

#foreach( $info in $list ) $info.someList #end

是 velocity 中唯一的一种巡皇的语法，类似于 java 的增强 for 循环

java 的 for 循环是： for(User user:userList){}

velocity 的 foreach 循环是： #foreach( $user in $userList )....#end

这里的 userList 是一个 List 。可以使用 $foreach.count 进行简单的循环技术

如果想从零开始进行 #foreach 循环，可以使用 foreach.index 代替 foreach.count

判断是否是最后一次迭代： #if( $foreach.hasNext )

如果你的 userList 中有很多数据，但是你只想遍历前3条，那么：

#foreach( $user in $userList )

#if( $foreach.count > 3 )

#break

#else

...

#end

在 #foreach 中昌盛的变量，只在 #foreach 的作用范围内有效

循环读取集合 list 中的对象，并作相应的处理

如： EasyJF 开源论坛系统中论坛首页显示热门主题的 html 界面模版脚本：

#foreach ( $info in $hotList1 )

<a href="/bbsdoc.ejf?easyJWebCommand=show&&cid=$!info.cid" target="_blank">$!info.title</a><br>

#end

脚本表示循环遍历 hotList1 集合中的对象，并输出对象的相关内容

#macro( macroName ) #end 脚本函数（宏）调用，不推荐在界面模版中大量使用

如：在使用 EasyJWeb Tools 快速生成的添删改查示例中，可以点击列表的标题栏进行升降排序显示，

这是我们在 EasyJWeb 应用中经常看到的一个排序状态显示的模板内容

函数（宏）定义，一般放在最前面

#macro( orderPic $type )

#if( $orderField.equals( $type ) )

#end

具体的调用如：<font color="#ffffff">头衔 #orderPic("title")</font>

包含文件 #include("模版文件名") 或 #parse ("模版文件名")

主要用于处理居右相同内容的页面，比如每个网站的顶部或尾部内容

使用方法。

parse 和 include 的区别在于

#parse 导入脚本 #parse("head.vm");---一次只能引入一个文件（或变量），包含的文件中有 velocity 脚本标签

#include ( "one.gif", "two.text","three.html" )--包含文件，可以同时引入多个文件。不能被模版引擎处理。

#set 语法

可以创建一个 velocity 变量，一般用于向一个变量或属性赋值。 #set 表达式，结尾不需要 #end 跟谁。其他的表达式基本上都需要加 #end

如：#set($pactive = "active")

velocity 用户指南，中文翻译链接 http://ifeve.com/apache-velocity-dev/

apcche veloctiy 官网用户指南： http://velocity.apache.org/engine/devel/user-guide.html#The_Mud_Store_Example