Velocity语言的介绍
Posted 农夫
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Velocity语言的介绍相关的知识,希望对你有一定的参考价值。
Velocity语言的介绍
2016-09-06 15:39:25
语言介绍
Velocity是一种Java模版引擎技术,是一个基于Java的模板引擎(template engine)。她允许任何人简简单单的使用模板语言类引用由Java代码定义的对象。
当Velocity应用于web开发时,界面设计人员可以和Java程序开发人员同步开发一个遵循MVC架构的web站点,也就是说,页面设计人员可以只关注页面的显示效果,而由java程序员关注业务逻辑编码。Velocity将Java代码从web页面中分离出来,这样web站点的长期维护提供了便利,同时也为我们在JSP和php之外又提供了一种可选的方案。
基础使用
在Velocity中,变量的定义都是使用“$”开头的,$作为Velocity的标识符。字母、数字、中划和下划线都可以作为Velocity的定义变量。
Velocity——注释
单行注释,使用## 如:##<div class="tt">$shopUser.username</div> 会隐藏此div
多行注释,使用 #* comment *# 如: #* <div class="tt">$shopUser.username</div> *#
Velocity——引用
注意:规范的引用写法应该是${Foo},也可以使用下面的形式; 规范的肯定是不会错的。
如果没有对应的引用,VTL会作为普通的字符串处理。
在Velocity Template Language(VTL)中,有三种类型的引用: 变量,属性,方法。
所有的引用都被看做是字符串,如果某个引用是一个整型值,Velocity会调用toString()方法,将她转换为String。
变量:(如:$username)
变量是由$和紧跟其后的VTL标识符组成的。
VTL标识符必须以字母开头,后面可以包含并且仅能包含字母、数字、下划线以及减号。
像$2.4这样的字符串,是不会被识别为变量的,因为2.4不是一个VTL标识符。
属性:(如:$shopUser.username)
属性是由四部分组成,依次是$+VTL标识符+“.”+VTL标识符。
这个标识符有两个含义,它可以表示在shopUser标记的hashtable中寻找并返回这个key对应的value,也可以表$shopUser.getUsername这个方法(方法在java程序中定义)。如:{\'$!shopUser.getUsername()\'}。
方法:如($shopUser.getPass("test"))
方法是由四部分组成,依次是$+VTL+\'.\'+函数调用。这里的函数调用是可以带参数的。
很显然,属性有时是方法的一种简写,$Foo.bar和$Foo.getbar()是等价的,这种情况下,尽量使用属性的形式。但是方法有参数的话,就没有和它等价的属性了。
属性的搜索规则:
属性可以表示为调用方法,也可表示从hashtable中找值,对于$Foo.bar来说,Velocity会按照以下顺序解析:
$Foo.getbar()>$Foo.getBar()> $Foo.get("bar")>$Foo.isBar()
而对于$Foo.Bar来说,Velocity会按照以下顺序解析:
$Foo.getBar() > $Foo.getbar() > $Foo.get("Bar") > $Foo.isBar()
所以,前两个是寻找方法,第三个是在hashtable中找值,第四个是一个is判断。
另外需要注意的是,属性不会被解析为对象的实例变量。$Foo.bar可以表示$Foo.getbar()或者$Foo.get("bar"),但是它不表示Foo这个java对象的bar属性。
Velocity——指令
引用可以让模板设计者生成动态内容,而指令允许设计者真正的负责页面的展现和内容。
#Include和#Parse都是用于将本地文件引入当前文件的指令,而且被引入的文件必须位于TEMPLATE_ROOT(配置Velocity视图文件时设置的路径,稍后再SpringMvc整合Velocity时介绍)。
#Include
被#Include引入的文件,其内容不会被Velocity引擎解析,所以这些文件应该是静态模板,即不含有VTL的模板。使用#Include()指令时,参数是被双引号括起来的文件名或者是表示文件名的变量。如果有多个文件,以逗号隔开即可。比如#Include("mode.vm", "b.html", $file)。
#Parse
#Parse用来在当前模板中引入并执行另一个(本地的)模板——可以是静态的,也可以是动态的——并把结果嵌入到当前位置。#Parse()指令的参数,可以是一个双引号括起来的文件名,也可以是一个变量,但是它不能接受多个参数。
被#Parse引入的文件仍然可以使用#Parse指令。在velocity.properties文件中有一个属性directive.parse.max.depth,默认值是10,它指定了#Parse嵌套的最大层次。既然#Parse嵌套是允许的,#Parse递归也是允许的。
假如a.vm #Parse b.vm,那么a.vm中定义的变量$v,在b.vm中可以随便使用。如果b.vm也定义了$v,那么b.vm中用到的将会是自己的$v,而不是a.vm中的$v。
#set
#set指令用于向一个变量或者属性赋值。
其格式为 #set($username="chen")或者#set($username.bar=$test) 。
#if
#if指令用于判断某个条件是否为true。形式: #if() #elseif() #else #end,和java中的用法基本相同。如下:
#if($userNameMap.get("name") == \'zhangsna\') <div class=\'tt\'>$userNameMap.get("name")</div> #elseif($userNameMap.get("name") == \'zhangsan\') <div class=\'tt\'>不是zhangsna</div> #else <div class=\'tt\'>什么都不是</div> #end
#foreach
#foreach($userName in $userNames) $userName</br> #end
上面这个例子中,$userNames可以是一个Vector,一个HashTable,一个数组。
在Velocity中,有一个变量$velocityCount用作循环计数,初始值是1。这个变量的名字和初始值是在velocity.properties文件里配置的。
Velocity——运算
判断是否为null
1、#if (! $userName) 判断$userName为空,判断非空为 #if ($userName)
2、使用null工具判断
#if($null.isNull($userNames))
在需要这个判断作为一个判断字句时,比如我要你判断一个集合为null或为空时只能使用这种方式了:
$if ($null.isNull($userNames) || $userNames.size()==0)
3、判断为空的方法
#if("" == $变量名) 或 #if("" != $变量名)
"!"的使用
“!”用来强制把不存在的变量或变量值为null的对象显示为空白。
如当页面中包含$userName,如果userName对象有值,将显示msg的值,如果不存在msg对象,则在页面中显示$userName字符。
Velocity——宏
#macro(d)
#macro指令用于定义一个VTL模板的重复代码块——宏。如:
#macro(d) <tr><td>宏</td><tr> #end
Velocity中写入#d或者#d(),则会替换为‘<tr><td>宏</td><tr>’。
#macro(d $name)
宏也可以带参数,而且是任意多个参数。不过,宏定义时有几个参数,宏调用时就要提供同样数目的参数。
#macro( d $name)
<tr><td>$name</td></tr>
#end
#d("name1")
宏的参数可以是以下VTL元素中的任意一种:引用、字符串字面值、数值字面值、整数范围(比如[1 .. 10]、[$start .. $end])、数组、布尔值true或者false。
SpringMVC整合Velocity
Velocity现在应用非常广泛,现在尝试将SpringMVC项目与Velocity整合
整合过程
1、主要涉及改变的文件:
pom.xml(引入velocity的jar包)
pbqshop-servlet.xml(视图配置,配置velocity)
velocity.properties(velocity配置文件)
1)pom.xml中引入Velocity是由的jar包
<!-- Velocity 模板 --> <dependency> <groupId>org.apache.velocity</groupId> <artifactId>velocity</artifactId> <version>1.7</version> </dependency> <dependency> <groupId>velocity-tools</groupId> <artifactId>velocity-tools-generic</artifactId> <version>1.2</version> </dependency>
2)pbqshop-servlet.xml中视图配置
<!-- 视图模式配置,Velocity配置文件 --> <bean id="velocityConfigurer" class="org.springframework.web.servlet.view.velocity.VelocityConfigurer"> <property name="resourceLoaderPath" value="template"></property> <property name="configLocation" value="classpath:velocity.properties"></property> </bean> <!-- 配置后缀 --> <bean id="velocityViewResolver" class="org.springframework.web.servlet.view.velocity.VelocityViewResolver"> <property name="contentType" value="text/html;charset=UTF-8"></property> <property name="suffix" value=".vm"></property> </bean>
3)velocity.properties(velocity配置文件)
#encoding input.encoding=UTF-8 output.encoding=UTF-8 contentType=text/html;charset=UTF-8 #autoreload when vm changed file.resource.loader.cache=true file.resource.loader.modificationCheckInterval=1 resource.manager.defaultcache.size=0 parser.pool.size=100 velocimacro.library.autoreload=false
以上是关于Velocity语言的介绍的主要内容,如果未能解决你的问题,请参考以下文章