velocity详解

（1）为什么要使用模版语言？

在服务器端可以使用 Velocity 处理模板和生成的动态内容（HTML、XML等）。这和 JSP 技术的目标非常接近。但是，JSP 模型可以毫无阻碍地访问底层的 Servlet API 和 Java 编程语言。它基本上是一种在很大程度上开放的访问模型。而作为一种完全自包含的模板引擎和脚本解释器，Velocity 拥有完全封闭的模型。任何针对系统和/或 Java 编程语言的访问都必须明确地启用。默认情况，Velocity 模板中不能访问 Java 编程语言的任何方面。这种封闭的模型使 Velocity 能够提供分离的模板表示层，与任何应用程序业务逻辑或者数据管理代码清晰地划分开。从而保证了web site 的长期可维护性.

第一次解释jsp需要经过转换成java代码，再编译成class文件等步骤，而velocity则在速度上更快，因为它不需要经过像解释jsp页面那么多的步骤，其次velocity也可以用作其它实现的模板技术，像我在项目中就遇到过使用velocity来作为邮件的模板，而jsp显然做不到这样的功能。

拓展：在java领域，表现层技术主要有三种：jsp、freemarker、velocity。 
jsp是大家最熟悉的技术 
优点： 
1、功能强大，可以写java代码 
2、支持jsp标签（jsp tag） 
3、支持表达式语言（el） 
4、官方标准，用户群广，丰富的第三方jsp标签库 
5、性能良好。jsp编译成class文件执行，有很好的性能表现 
缺点：没有明显缺点，非要挑点骨头就是，由于可编写java代码，如使用不当容易破坏mvc结构。

velocity是较早出现的用于代替jsp的模板语言 
优点： 
1、不能编写java代码，可以实现严格的mvc分离 
2、性能良好，据说比jsp性能还要好些 
3、使用表达式语言，据说jsp的表达式语言就是学velocity的 
缺点： 
1、不是官方标准  2、用户群体和第三方标签库没有jsp多  3、对jsp标签支持不够好

freemarker 也是一种模版引擎语言
优点： 
1、不能编写java代码，可以实现严格的mvc分离 
2、性能非常不错 
3、对jsp标签支持良好 
4、内置大量常用功能，使用非常方便 
5、宏定义（类似jsp标签）非常方便 
6、使用表达式语言 
缺点： 
1、不是官方标准  2、用户群体和第三方标签库没有jsp多

综合对比： 
1、性能。velocity应该是最好的，其次是jsp，普通的页面freemarker性能最差（虽然只是几毫秒到十几毫秒的差距）。但是在复杂页面上（包含大量判断、日期金额格式化）的页面上，freemarker的性能比使用tag和el的jsp好。 
2、freemarker宏定义比jsp tag方便，内置大量常用功能，比如html过滤，日期金额格式化等等，支持jsp标签。且freemarker和velovity一样，作为模版语言，都可以实现严格的mvc分离。

（2）Velocity模版语言(VTL)使用详解

① VTL变量声明

所有的VTL statement 都是以#开头，且包含一个指示符,当客户访问你的页面时, the Velocity Templating Engine 将搜索页面中的所有# 符号,如果确定这是一个VTL 声明时就按一定规则处理动态内容, 符号#仅仅只是表明这可能是一个VTL 声明.记住以下的规则：
使用$字符开始的references用于得到什么；使用 #字符开始的directives用于作些什么。

在下面的例子中，一个值被分配给$foo变量，并在其后被引用。
<html>
<body>
#set ( $foo = “Velocity” ) 
Hello $foo World!
</body>
</html>
上面的实现结果是在页面上打印“Hello Velocity World！”

② 注释语法

单行注释：## 内容

多行注释：#* 内容 *#

文档格式：#** 内容  *#

③ 正式引用标记

${mudSlinger}     变量
${customer.Address}   属性
${purchase.getTotal()}   方法

如果写成如下的语法格式，当值为null的时候会原样输出字符串

$mudSlinger     变量
$customer.Address   属性
$purchase.getTotal()   方法

所以尽量使用正式的标记或者可以写成如下的方式：

$!mudSlinger     变量
$!customer.Address   属性
$!purchase.getTotal()   方法

也可以一同使用

$!{mudSlinger}     变量
$!{customer.Address}   属性
$!{purchase.getTotal()}   方法

拓展：$customer.address 引用时，查找顺序是：

1.getaddress() 2. getAddress() 3. get(“address”) 4. isAddress()

④ 如何在velocity中使用特殊字符？

$字符：货币字符

在VTL中使用$2.5这样的货币标识是没有问题得的，VTL不会将它错认为是一个reference，因为VTL中的reference总是以一个大写或者小写的字母开始。但还是要明白，VTL中使用“\”作为逃逸符。如：\$name将会输出$name字符串。

⑤ 常用基础语法

1)条件语句

#if ( $foo )  1  #else  2  #end

上例中的条件语句将在以下两种条件下成立：
1.$foo是一个boolean型的变量，且它的值为true
2.$foo变量的值不为null

#if( $foo < 60 )  完蛋了 #elseif( $foo == 60 ) 万幸  #else 浪费 #end

2)循环语句
    #foreach ( $product in $allProducts )
     这是第$velocityCount次循环，值为： $product 
    #end

每次循环$allProducts中的一个值都会赋给$product变量。

$velocityCount 变量的名字是Velocity默认的名字，你也可以通过修改velocity.properties文件来改变它。默认情况下，计数从“1”开始，但是你 可以在velocity.properties设置它是从“1”还是从“0”开始。下面就是文件中的配置：
directive.foreach.counter.name = velocityCount
directive.foreach.counter.initial.value = 1

现在我们假设$allProducts是一个Hashtable，如果你希望得到它的key应该像下面这样：
<ul>
#foreach ( $key in $allProducts.keySet() ) 
<li>Key: $key -> Value: $allProducts.get($key) </li>
#end 
</ul>

3) 关系、逻辑运算符

相等 ==     不等 !=    且 &&    或||   非 !

4) include

#include script element允许模板设计者引入本地文件。被引入文件的内容将不会通过模板引擎被render。为了安全的原因，被引入的本地文件只能在TEMPLATE_ROOT目录下。
#inclued ( “one.txt” ) 
如果您需要引入多个文件，可以用逗号分隔就行：
#include ( “one.gif”, “two.txt”, “three.htm” ) 
在括号内可以是文件名，但是更多的时候是使用变量的：
#inclue ( “greetings.txt”, $seasonalstock )

5) parse
#parse script element允许模板设计者一个包含VTL的本地文件。Velocity将解析其中的VTL并render模板。
#parse( “me.vm” )
就像#include，#parse接受一个变量而不是一个模板。任何由#parse指向的模板都必须包含在TEMPLATE_ROOT目录下。与#include不同的是，#parse只能指定单个对象。
你可以通过修改velocity.properties文件的parse_direcive.maxdepth的值来控制一个template可以包含的最多#parse的个数――默认值是10。#parse是可以递归调用的

6) Range Operator

#foreach ( $bar in [2..-2] )  $bar #end

结果：2 1 0 -1 -2

#set ( $arr = [0..1] ) 
     #foreach ( $i in $arr ) $i #end

结果：0 1

7) 内置对象

velocity内置了一些对象，在vm模版里可以直接调用，列举如下：
$request、$response、$session，另外，模板内还可以使用 $msg内的消息工具访问 Struts 的国际化资源，达到简便实现国际化的方法。

8) 四则运算

直接进行四则运算将会默认为字符串连接，因此运算应该是如下的方式解决。

如果$foo=2.则$foo + 1 结果是21，而不是3.

需要先#set ( $value = $foo + 1 ) ，然后$value 结果才是3

9) 解析步骤

当Velocity应用在应用程序时，一般分一下几步：

初始化Velocity==>创建context对象==>添加数据到context==>选择模板==>合并模板和数据，产生输出页面

10) velocity.properties文件详解(在spring集成的时候主要是配置在prop标签中)

1. tools.view.servlet.error.template = error.vmzd

处理错误信息的模板路径

2. tools.view.servlet.layout.directory = /WEB-INF/layout/ 所有布局文件的默认路径

3. tools.view.servlet.layout.default.template = defauzlt.vm

默认的布局文件

4. #模板编码：

input.encoding=ISO-8859-1 //模板输入编码

output.encoding=ISO-8859-1 //模板输出编码

5. velocimacro.library=/WEB-INF/vm/macro.vm,/WEB-INF/vm/tuanmacro.vm

是一个逗号分隔的所有Velocimacro 模板库的列表

（3）如何把VTL集成到spring的项目框架中？

① 需要的jar包

commons-collections.jar

velocity-1.5.jar

velocity-dept.jar

velocity-tool-view1.4.jar

下载地址：http://jakarta.apache.org/velocity/

② 引入Velocity包

在application-context.xml配置文件里配置VelocityConfigurer，当然也可以在dispatcher-servlet（application-springmvc.xml）里面配置，这完全取决于你自己的想法。

下面的配置使Spring能够知道我们的模板文件是放在哪里的

<bean id="velocityConfigurer" class="org.springframework.web.servlet.view.velocity.VelocityConfigurer">        <property name="resourceLoaderPath" value="/WEB-INF/views"/>    </bean>

在dispatcher-servlet里配置VelocityViewResolver

下面的配置则是针对一个模板文件使用的是什么后缀。

<bean id="velocityViewResolver" class="org.springframework.web.servlet.view.velocity.VelocityViewResolver">         <property name="suffix" value=".vm"/>    </bean>

本项目例子：

格式化时间：

$date.format(‘yyyy-MM-dd HH:mm:ss‘,$element.createTime)

时间： 2024-10-16 16:22:15

velocity详解的相关文章

Spring MVC整合Velocity详解

一.Velocity简介 Velocity是一个基于java的模板引擎(template engine).它允许任何人仅仅简单的使用模板语言(template language)来引用由java代码定义的对象. 当Velocity应用于web开发时,界面设计人员可以和java程序开发人员同步开发一个遵循MVC架构的web站点,也就是说,页面设计人 员可以只关注页面的显示效果,而由java程序开发人员关注业务逻辑编码.Velocity将java代码从web页面中分离出来,这样为web站点的长 期维

Velocity魔法堂系列二：VTL语法详解

一.前言 Velocity作为历史悠久的模板引擎不单单可以替代JSP作为Java Web的服务端网页模板引擎,而且可以作为普通文本的模板引擎来增强服务端程序文本处理能力.而且Velocity被移植到不同的平台上,如.Net的NVelocity和js的Velocity.js,虽然各平台在使用和实现上略有差别,但大部分语法和引擎核心的实现是一致的,因此学习成本降低不少哦. 最好的学习资源——官网:http://velocity.apache.org/ 本系列打算采用如下结构对Velocity进行较为

Spring MVC 框架搭建及详解

一.Spring MVC环境搭建:(Spring 2.5.6 + Hibernate 3.2.0) 1. jar包引入 Spring 2.5.6:spring.jar.spring-webmvc.jar.commons-logging.jar.cglib-nodep-2.1_3.jar Hibernate 3.6.8:hibernate3.jar.hibernate-jpa-2.0-api-1.0.1.Final.jar.antlr-2.7.6.jar.commons-collections-3

Struts2中 Result类型配置详解（转）

一个result代表了一个可能的输出.当Action类的方法执行完成时,它返回一个字符串类型的结果码,框架根据这个结果码选择对应的result,向用户输出.在com.opensymphony.xwork2.Action接口中定义了一组标准的结果代码,可供开发人员使用,当然了只有我们的action继承ActionSupport 这个类才可以使用下面的结果代码,如下所示:public interface Action{    public static final String SUCCESS =

Struts2中 Result类型配置详解

一个result代表了一个可能的输出.当Action类的方法执行完成时,它返回一个字符串类型的结果码,框架根据这个结果码选择对应的result,向用户输出. 在com.opensymphony.xwork2.Action接口中定义了一组标准的结果代码,可供开发人员使用,当然了只有我们的action继承ActionSupport 这个类才可以使用下面的结果代码,如下所示: public interface Action {     public static final String SUCCES

ScrollView详解

创建方式 1:StoryBoard/Xib 这里StoarBoard就不多说,直接拖就可以,说太多没意思,如果连这个都不会我只能先给你跪了! 2:代码: 1 2 3 CGRect bounds = [ [ UIScreen mainScreen ] applicationFrame ] ; UIScrollView* scrollView = [ [UIScrollView alloc ] initWithFrame:bounds ]; 当你创建完滚动视图后,你可以将另一个视图的内容粘合到滚动视

iOS开发——UI篇&amp;ScrollView详解

ScrollView详解 创建方式 1:StoryBoard/Xib 这里StoarBoard就不多说,直接拖就可以,说太多没意思,如果连这个都不会我只能先给你跪了! 2:代码: CGRect bounds = [ [ UIScreen mainScreen ] applicationFrame ] ; UIScrollView* scrollView = [ [UIScrollView alloc ] initWithFrame:bounds ]; 当你创建完滚动视图后,你可以将另一个视图的内

EasyPR--开发详解

我正在做一个开源的中文车牌识别系统,Git地址为:https://github.com/liuruoze/EasyPR. 我给它取的名字为EasyPR,也就是Easy to do Plate Recognition的意思.我开发这套系统的主要原因是因为我希望能够锻炼我在这方面的能力,包括C++技术.计算机图形学.机器学习等.我把这个项目开源的主要目的是:1.它基于开源的代码诞生,理应回归开源:2.我希望有人能够一起协助强化这套系统,包括代码.训练数据等,能够让这套系统的准确性更高,鲁棒性更强等等

【SSH2（理论篇）】--Struts2配置详解

上篇博客讨论了SSH2框架模型,在开发过程中发现SSH2的开发模型其实类似于经典的三层模式,在每一层中分别添加了不同的框架,显示层使用的是Struts2进行配置的,业务逻辑层使用的是Spring配置,数据持久层则采用的是Hibernate,开发模式简单易懂,接下来将会分别从三层着手讨论每一层的运行内容. 一.Struts体系简介 struts,是Apache软件基金会(ASF)赞助的一个开源项目,它通过采用Java Servlet/JSP技术,实现了基于Java EE Web应用的Model-V