以简求快 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模板中调用的方法集中写在一个类中,我们称它为帮助类。方法是否静态并不做要求,可自行选择。