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

时间:2021-06-24 23:33:36

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

       任何学习总是从概念开始,所以先摘抄一段网络上关于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模板中调用的方法集中写在一个类中,我们称它为帮助类。方法是否静态并不做要求,可自行选择。