文档章节

velocity学习笔记

闪电
 闪电
发布于 2015/05/15 17:00
字数 1281
阅读 11
收藏 0

转载自:http://wiki.hotoo.me/Velocity-Notes.html


Velocity Notes

变量名

$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 之后。

本文转载自:http://asialee.iteye.com/blog/1766679

闪电
粉丝 74
博文 392
码字总数 6789
作品 0
海淀
技术主管
私信 提问
菜鸟笔记(二) - Java邮件发送实践

本文将介绍多种使用Java发送Email的应用实践。 前提摘要:在学习Java Web的构建中,无论是触发型的邮件-注册,重置密码邮件,还是批量式的营销广告,订阅邮件,邮件发送是系统离不开的应用场...

chenbilly
2016/09/05
60
0
AI学习笔记之——强化学习(Reinforcement Learning, RL)

诚如在之前文章提到的,机器学习按照从那里学的角度可以分为:监督学习,无监督学习和强化学习三大类。之前的文章大多数都是介绍的前两类,而第三类强化学习(RL)确是最接近我们所想象的人工...

Hongtao洪滔
2018/07/24
0
0
MonoRail学习之源码放送

笔者拜读了永春兄《MonoRail学习笔记系列文章》,受益匪浅,然后按照文中代码一一实践。编码过程中遇到过一系列问题,如:(1)一开始不知道Url该输什么J(2)把httpModules配置节中的routi...

夏春涛
2008/04/23
0
0
Mybatis 学习笔记四 MyBatis-Plus插件

Mybatis 学习笔记四 MyBatis-Plus插件 maven依赖 配置 mybatis配置 conf.xml 注意:保持基本配置即可; spring配置 applicationContext.xml mapper配置 userMapper.xml meng.mybatis.test.U...

晨猫
2018/11/18
0
0
Unity Shader 学习笔记(23) 运动模糊

Unity Shader 学习笔记(23) 运动模糊 参考书籍:《Unity Shader 入门精要》 运动模糊 两种常见方法: - 积累缓存(accumulation buffer),混合连续多张图像。即需要同一帧里渲染多次场景,...

l773575310
2017/11/23
0
0

没有更多内容

加载失败,请刷新页面

加载更多

Angular 英雄编辑器

应用程序现在有了基本的标题。 接下来你要创建一个新的组件来显示英雄信息并且把这个组件放到应用程序的外壳里去。 创建英雄组件 使用 Angular CLI 创建一个名为 heroes 的新组件。 ng gener...

honeymoose
今天
5
0
Kernel DMA

为什么会有DMA(直接内存访问)?我们知道通常情况下,内存数据跟外设之间的通信是通过cpu来传递的。cpu运行io指令将数据从内存拷贝到外设的io端口,或者从外设的io端口拷贝到内存。由于外设...

yepanl
今天
6
0
hive

一、hive的定义: Hive是一个SQL解析引擎,将SQL语句转译成MR Job,然后再在Hadoop平台上运行,达到快速开发的目的 Hive中的表是纯逻辑表,就只是表的定义,即表的元数据。本质就是Hadoop的目...

霉男纸
今天
5
0
二、Spring Cloud—Eureka(Greenwich.SR1)

注:本系列文章所用工具及版本如下:开发工具(IDEA 2018.3.5),Spring Boot(2.1.3.RELEASE),Spring Cloud(Greenwich.SR1),Maven(3.6.0),JDK(1.8) Eureka: Eureka是Netflix开发...

倪伟伟
昨天
15
0
eclipse常用插件

amaterasUML https://takezoe.github.io/amateras-update-site/ https://github.com/takezoe/amateras-modeler modelGoon https://www.cnblogs.com/aademeng/articles/6890266.html......

大头鬼_yc
昨天
9
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部