以简求快 Java快速开发框架LML之velocity常用基本语法

总以为明天会更好，但是今天都做不好，明天怎么会好？

任何学习总是从概念开始，所以先摘抄一段网络上关于Velocity的定义：

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模型进行开发。

下面简单的总结一下，Velocity的使用方法，当然你完全可以在网络上找到类似的文档。我更主要的是想说明一下我们常用的语法，并给出一些实例。

　　1， 注释，任何一种语言中，注释总是必不可少的。

　　　　(1) 单行注释：
　　　　　　## 这是单行注释

　　　　(2) 多行注释：
　　　　　　 #*
　　　　　　　　这是多行注释

　　　　　　　　 *#

　　2， 输出，也就是数据展现。

　　　　$userName

　　　　这样便可以输出用户名了。但是，并不是绝对的能够输出用户名，因为可能这里输出的变量并不存在。如果userName这个变量不存在，或者为空，$userName将会被当　　　　　　　　　　　　 作字符串直接输出，也就是当我们期望在userName为空的时候输出空，但是却输出了’$userName’。为了避免这种情况，推荐这样的变量输出写法：

　　　　$!{userName}

　　3， 变量声明与赋值

　　　　一般情况下，我们不推荐在html页面中直接声明Velocity变量，因为这会增加html界面的复杂度。如果确实有必要，可以使用下面的语句声明变量并赋值：

　　　　#set($userName=’hanmeimei’)

　　　　请注意：Velocity的变量声明都要带着$符号。

　　　　在LML中，我们经常在所谓的后台，也就是Action中给变量赋值，这样在Action对应的html模板中也可以直接使用该变量。可使用一下两种方法：

　　　　　　(1) 传统的getter/setter

　　　　　　(2) ViewBag.Add(key,value)

　　　　相比之下，第二种非传统的方式更快速。

　　4， 算术运算

　　　　Velocity支持在模板中使用（+，—，*，/），例如：

　　　　#set($a=1)

　　　　#set($b=1)

　　　　#set($c=$a + $b)

　　　　C在算对的情况下等于2，算错的情况下等于3.。有一个问题大家需要注意，我在使用四则运算的时候，发现’—‘不起作用，最后经过尝试，发现需要在变量和运算符之 　　 间留一个空格，这样就没问题了。如果，你也遇到这样的问题，也可以这么尝试一下。

　　5， 逻辑运算

　　　　支持一下几个运算符，就如同java一样：

　　　　&&：与。

　　　　||：或。

　　　　！：非。

　　6， 迭代

　　　　#foreach ($item in $list)

　　　　 这是第 $velocityCount 个元素： $item
　　　　#end

　　　　$velocityCount，表示当前序号。

　　　　还要说一下我们在LML中分页显示数据用到的迭代，如下：

　　　　#foreach($item in $pager.result.rows)

　　 $item.userName

　　　　　　##以下两种方式可迭代列

　　　　　　#set($row=$item.values().toArray())

　　　　　　##方式1

　　　　　　#foreach($a in $row) $!a #end

　　　　　　##方式2

　　　　　　#foreach($i in [0..2]) $row.item($i) #end

　　　　#end

　　　　$pager.result是在分页Action中查询到的一个数据集Result。

　　　　我们也可以在模板中直接声明并赋值一个list，而后进行迭代：

　　　　#set( $list = ["a", "b", "c"])

　　　　#foreach ($item in $list)

　　　　　　$velocityCount

　　　　#end

　　　　还有一种情况，我们需要迭代从1到10，所有的整数：

　　　　#foreach ($item in [1..10])

　　　　　　$velocityCount

　　　　#end

　　　　注意中间就是两个点。

　　　　查阅很多资料，都直接说明Velocity不能迭代数组，下面说明原因：

　　　　对数组的访问在Velocity中存在问题，因为Velocity只能访问对象的方法，而数组又是一个特殊的Array，所以虽然数组可以进行循环列举，但却不能定位访问特定位置 的　　 元素，如 strs[2]，数组对固定位置元素的访问调用了Array的反射方法get(Object array, int index)，而Velocity没能提供这样的访问，所以数组要么改成List等其他类容器的方式来包装，要么就通过公用Util类的方式来提供，传入数组对象和要访问的位置参数，从而达到返回所需值的目的。

　　　　Velocity支持迭代的数据类型有：Vector、Hashtable或者Array

　　7， 条件判断

　　　　#if (条件1)

　　　　#elseif (条件2)

　　　　#else

　　　　#end

　　　　一直不是很理解Velocity的数据类型，所以在项目中最多使用的是String，就像这里的条件表达式，我们经常这样写： if(“$!{userSex}”==”0”)，虽然性别使用int表示。

　　8， 文件引入，#include与#parse

　　　　两者作用类似，但是有以下不同：

　　　　(1) 与#include不同的是，#parse只能指定单个对象。而#include可以有多个

　　　　　　如果您需要引入多个文件，可以用逗号分隔就行：
　　　　　　#include ("a.gif", "b.txt", "c.htm" )
　　　　　　在括号内可以是文件名，但是更多的时候是使用变量的：
　　　　　　#include ( “a.txt”, $photo )

　　　　(2) #include被引入文件的内容将不会通过模板引擎解析；

　　　　　　而#parse引入的文件内容Velocity将解析其中的velocity语法并移交给模板，意思就是说相当与把引入的文件copy到文件中。

　　　　　　以上两点摘自互联网，到目前我基本没有使用过#include。#parse最大的用处或许是这样用：

　　　　　　#parse(“title.html”)

　　 类似layout。

　　9， 内置对象

　　　　Velocity内置了一些对象，在模版里可以直接调用，列举如下：
　　　　$request、$response、$session

　　　　这些一直也没使用过，完全可以在Action页面把各种对象处理好了。

　　　　基本上，在我们的一般开发中，掌握以上语法已经可以应付自如了。是不是很简单呢，我们希望的不就是简单吗，简单所以快。写的不好，敬请见谅。

　　　　 补充：
　　　　LML支持在html模板中直接调用java方法，并可以向方法传递参数（字面值，或者Velocity变量），还可以输出方法的返回值。当然，为了避免模板页面过于复杂，我们还是应该尽量减少在模板中调用java方法。如果确实有必要调用，则需要现在模板页面对应的Action类上先行声明：
　　　　 @Helper( { TestHelper.class })
　　　　这样就可以在html模板中调用：
　　　　$!TestHelper.Test("$!{userName}")
　　　　这里提出了帮助类的概念，一般情况下我们把需要多次在html模板中调用的方法集中写在一个类中，我们称它为帮助类。方法是否静态并不做要求，可自行选择。