模板引擎中判断对象是否为空:

#if(!${jsonObj.data.buyerName} || ${jsonObj.data.buyerName} == '')
         <p>采购商名称:$!jsonObj.data.buyerCompanyName</p>

#else
         <p>采购商名称:$!jsonObj.data.buyerName</p>
 #end

参考:http://asialee.iteye.com/blog/1766679

变量名

$name为空时打印变量本身。$!name为空时打印空字符串(不打印任何内容)。${name}类似 $name,为空时原样打印。但可以将变量和连续的字符串分隔,例如:${name}space$!{name}类似 $!name,为空时打印空字符串,但可以将变量和连续的字符串分隔。例如: $!{name}space。$name$!name${name}$!{name}

为空时打印: "$name" "" "${name}" ""

带花括号的属性/方法调用方式,属性/方法需要在花括号之内:

${cookie.name}
${request.getCookies()}

#set() 中,赋值符号左边的变量名不能加感叹号。

#set($idx = 0)
#foreach($!item in $!list)
#set($idx = $!idx + 1)
#end

注:jQuery 的 $.ajax() 之类的代码会导致 Velocity 解析异常,好在 Javascript 语法的灵活性,可以增加无效空白 $ .ajax(),当然也可以使用 jQuery.ajax()

#set()

#set($list = ["pine", "oak", "maple"])

注: 如果右侧的值为 null,则赋值失败,左侧变量仍保持原值。

#if()

#if(true)
TRUE.
#elseif(false)
FALSE.
#end

其实不仅仅是变量名可以使用花括号,保留字同样可以使用,这在内联 Velocity 脚本的时候 非常有用。 例如:

#foreach()

#foreach($item in $list)
${velocityCount}. $item.
#end

#break

可用于中断 #foreach() 循环。

#parse()

例如:a.vm 中包含如下代码

#parse("b.vm")

则在解析 a.vm 页面的这行代码时,先将 b.vm 插入到其所在的位置,并解析执行, 而且 b.vm 可以共享 a.vm 中的变量。

如果 a.vm #parse("b.vm"),b.vm 可以直接使用 a.vm 中定义的变量。 注意:如果 b.vm 定义了同名变量,则 b.vm 中使用自身的定义。

#evaluate()

动态执行一串字符串的值:

#evaluate('string with VTL #if(true)will be displayed#end')

#include()

将文件原文包含进当前文档中。

#include("a.vm" "readme.txt")

#define()

类似于 C 语言的 #define 命令。

    #define($hello)
Hello ${who}!
#end
#set($who = "World") $hello
## 显示 "Hello World!"

数组 & 访问

Velocity 访问数组对象,无法通过类似 arr[2] 来访问特定位置的元素。

#set($arr = [0, 1, 2, 3])
$arr.get(2)

注:Velocity 中的数组对应 Java 中的 List 对象。对于 Java 原生 Array 对象, 只能够 #foreach 进行遍历,无法使用 $arr[0] 和 $arr.get(0) 方法。

范围(range)

#foreach($item in [10..20])
$item
#end

对象 & 访问

#set($obj = {"key":"value", "name":"space"})
$obj.get("key") #foreach(#item in $obj)
$item
#end

上面的 $item 取到的是 values,如果需要在遍历对象过程中,同时取到对象的 keys, 可以使用 entrySet() 或 keySet() 方法。

#foreach($item in $!obj.entrySet())
$!item.key : $!item.value
#end #foreach($item in $obj.keySet())
$item : $obj.get($item)
#end

注: 这种集合的遍历是无序的,即遍历顺序可能不同于 $obj 中元素的定义顺序 (据目前所知,是根据键的字母排序的)。

另外有两种不完美解决方法:

  1. I:

    #set($obj = [
    {"key":"key", "value":"value"},
    {"key":"name", "value":"space"}
    ])
    #foreach($item in $obj)
    $item.key : $item.value
    #end
  2. II:
    #set($obj = [
    ["key","value"],
    ["name","space"]
    ])
    #foreach($item in $obj)
    $item.get(0) : $item.get(1)
    #end

之所以说 不完美 是因为:对于已知的 key,本可以直接

$obj.get("key")

现在只能遍历并进行比较取得,而且较早的 Velocity 版本无法使用 #break, 以便在找到匹配项之后立即退出循环。

#foreach($item in $obj)
#if("key" == $!obj.get(0))
#set($myKey = $!type.get(1))
##break
#end
#end

#macros()

#macro(macroName)
#subMacro("name", "value")
#end #macro(subMacro $param1 $param2)
this is sub macro($param1, $param2).
#end

注意:如果 a.vm 和 b.vm 都在页面级存在同名,参数数量相同的宏,则后访问的页面 的宏不被加载。

参考:

  1. Velocity宏Velocimacros

#stop

停止模板引擎,在 Debug 时比较有用。

条件比较

在 Velocity 中可以使用大于(>)/小于(<)/等于(==)之类的符号,与编程语言中的意义一致, 不过要注意的是这些符号不能直接接在变量之后,除非变量使用带花括号的表示方式。 例如:if($num>1) 要修改为 if($num > 1) 或 if(${num}>1)

转义

$\name
$\{name}

不解析执行的内容

#[[
这段内容将不被 Velocity 引擎解析,原文打出。 * #define()
* ${blah ]]#

内置对象

$request$response$session

#foreach($cookie in $request.getCookies())
$cookie.name : $cookie.value
#end

获得 URL 中的参数:

#set($n = $!request.getParameter('n'))

另外还可以使用 $msg 内的消息工具访问 Struts 的国际化资源。

参考:

  1. Interface ServletRequest
  2. Interface HttpServletRequest

注释

## 单行注释。
#*
* 多行注释。
*# #**
* 文档风格的注释。
* @version 2010/12/27
*#

据说 vm 页面的末尾写注释,会导致解析异常 (SofaMVC?)。

Tips

Velocity 在表单中添加 name="action" 的文本/隐藏域,可以调用对应 Java 类 (submit 按钮的 name 则指定对应的方法名称,如 event_submit_do_save ), 但是此时 IE 浏览器通过 js 获得 form 元素本身的 action 属性值的方式, 和其他浏览器稍有不同。

例如对于如下 HTML DOM 结构:

<form action="attr">
<input name="action" value="elem" />
</form>

IE 中需要使用

form.attributes["action"].value

非 IE 浏览器还可以使用:

form.getAttribute("action")

以下是些详细的对照:

// codes                            //  IE          !IE
form.action.value // elem elem
form.getAttribute("action") // [object] attr
form.getAttribute("action").value // elem undefined
form.attributes["action"].value // attr attr

Form 本身的 action 属性和 action 隐藏域在提交时,浏览器本身不受影响, action 隐藏域被当作正常的参数附在 Form 的 action 属性值所对应 URL 之后。

Velocity模板引擎笔记的更多相关文章

  1. velocity模板引擎学习(4)-在standalone的java application中使用velocity及velocity-tools

    通常velocity是配合spring mvc之类的框架在web中使用,但velocity本身其实对运行环境没有过多的限制,在单独的java application中也可以独立使用,下面演示了利用ve ...

  2. velocity模板引擎学习(3)-异常处理

    按上回继续,前面写过一篇Spring MVC下的异常处理.及Spring MVC下的ajax异常处理,今天看下换成velocity模板引擎后,如何处理异常页面: 一.404错误.500错误 <e ...

  3. Velocity模板引擎语法

    Velocity 模板引擎介绍 Velocity是一个基于java的模板引擎(template engine).它允许任何人仅仅简单的使用模板语言(template language)来引用由java ...

  4. Velocity模板引擎入门

    类似于PHP中的Smarty,Velocity是一个基于Java的模板引擎(template engine).它允许任何人仅仅简单的使用模板语言(template language)来引用由java代 ...

  5. 【转载】Velocity模板引擎的介绍和基本的模板语言语法使用

    原文地址http://www.itzhai.com/the-introduction-of-the-velocity-template-engine-template-language-syntax- ...

  6. 使用 Velocity 模板引擎快速生成代码(zhuan)

    http://www.ibm.com/developerworks/cn/java/j-lo-velocity1/ ****************************************** ...

  7. 转 如何使用velocity模板引擎开发网站

    基于 Java 的网站开发,很多人都采用 JSP 作为前端网页制作的技术,尤其在是国内.这种技术通常有一些问题,我试想一下我们是怎样开发网站的,通常有几种方法: 1:功能确定后,由美工设计网页的UI( ...

  8. 使用Velocity 模板引擎快速生成代码

    Velocity 模板引擎介绍 在现今的软件开发过程中,软件开发人员将更多的精力投入在了重复的相似劳动中.特别是在如今特别流行的MVC架构模式中,软件各个层次的功能更加独立,同时代码的相似度也更加高. ...

  9. Velocity模板引擎介绍

    整理下Velocity使用方法,整理比较详细用例 1 Velocity基础语法 1.1 用户和开发人员参考文档 http://velocity.apache.org/engine/releases/v ...

随机推荐

  1. 623. Add One Row to Tree

    Problem statement Given the root of a binary tree, then value v and depth d, you need to add a row o ...

  2. Spoj-ANTP Mr. Ant & His Problem

    Mr. Ant has 3 boxes and the infinite number of marbles. Now he wants to know the number of ways he c ...

  3. mongo 操作符

    1 $unset The $unset operator deletes a particular field. https://docs.mongodb.com/manual/reference/o ...

  4. Biorhythms(poj 1006)

    Description 人生来就有三个生理周期,分别为体力.感情和智力周期,它们的周期长度为23天.28天和33天.每一个周期中有一天是高峰.在高峰这天,人会在相应的方面表现出色.例如,智力周期的高峰 ...

  5. CodeForces 762D Maximum path

    http://codeforces.com/problemset/problem/762/D 因为是3*n很巧妙的地方是 往左走两步或更多的走法都可以用往回走以一步 并走完一列来替换 那么走的方法就大 ...

  6. iOS推送的开启与关闭

    开启: 
[[UIApplication sharedApplication] registerForRemoteNotificationTypes: UIRemoteNotificationType ...

  7. Jetson TK1 四:重新安装系统(刷机)

    转载:http://blog.sina.com.cn/s/blog_bab3fa030102vk21.html Jetson TK1是NVIDIA基于Tegra K1开发的一块低成本开发板,板载一块T ...

  8. IntelliJ IDEA 使用的问题总结

     第一个问题:idea 无法创建springboot的项目     1. 点击IDEA setting之后,找到Http Proxy 选择Atuo-detect proxy settings 之后点击 ...

  9. error MIDL2311 解决方法

    error MIDL2311 : statements outside library block are illegal in mktyplib compatability mode : [] 在编 ...

  10. Android Studio一些常用的快捷键

    光标移动和窗口切换:1.esc:光标从功能窗口回到编辑窗口 2.alt+num:打开指定的功能窗口,重复操作关闭该窗口. 3.alt+←→:切换编辑的文件. 4.ctrl+home/end:跳转到文件 ...