一、Velocity 的工作原理
基本模式
当我们在Application或Servlet(实际上包括其他任何形式)中使用Velocity时,通常会做如下几件事:
·初始化Velocity。适用于Velocity的两种应用模式-单例(Singleton)和(separate runtime instance),并且你仅需要执行一次。
·创建一个Context对象。
·向Context对象添加数据。
·选择一个模板。
·合并模板和数据并输出。
通过org.apache.velocity.app.Velocity类,可以象这样在你的代码里应用单例模式:
import java.io.StringWriter;
import org.apache.velocity.VelocityContext;
import org.apache.velocity.Template;
import org.apache.velocity.app.Velocity;
import org.apache.velocity.exception.ResourceNotFoundException;
import org.apache.velocity.exception.ParseErrorException;
import org.apache.velocity.exception.MethodInvocationException;
Velocity.init();
VelocityContext context = new VelocityContext();
context.put("name",new String("Velocity"));
Template template = null;
try{
template = Velocity.getTemplate("mytemplate.vm");
}catch(ResourceNotFoundException rnfe){
//couldn't find the template
}catch(ParseErrorException pee){
//syntax error : problem parsing the template
}catch(MethodInvocationException mie){
//someing invoked in the template
//threw an exception
}catch(Exception e){}
StringWriter writer = new StringWriter();
template.merge(context,writer);
|
这是最基本的使用方式,非常简单!但这恰恰就是当你用Velocity表现一个模版的时候所发生的事情!事实上,你并不一定要严格的按照这种方式写代码,因为我们为servlet和Application开发人员提供了一些更加简单的工具。
二、是否使用单例模式
在Velocity1.2和以后的版本中,开发人员有了两中使用Velocity引擎的方式:单例模式(singleton model)或分离实例模式(separate instance model)。两种方式采用相同的核心Velocity代码,这使得更加容易整和Velocity和Java应用程序。
单例模式
在JVM或者web应用中仅仅存在一个Velocity引擎的实例,并且所有应用都共享它。这个实例允许本地化配置和资源共享,可以通过org.apache.velocity.app.Velocity类获得这个单例,就象下面这样:
import org.apache.velocity.app.Velocity;
import org.apache.velocity.Template;
...
/*
* Configure the engine - as an example, we are using
* ourselves as the logger - see logging examples
*/
Velocity.setProperty( Velocity.RUNTIME_LOG_LOGSYSTEM, this);
/*
* now initialize the engine
*/
Velocity.init();
...
Template t = Velocity.getTemplate("foo.vm");
|
org.apache.velocity.servlet.VelocityServlet基类采用了单例模式,这是一个用于帮助开发servlets的实用类。尽管继承这个类是应用Velocity开发Servlets的最常用、最方便的方法,但是你仍然可以自由选择是否使用这个类。
分离实例
作为1.2版的一个新特性,你可以在同一个JVM或web应用中创建、配置和使用任意多的Velocity实例。通过org.apache.velocity.app.VelocityEngine类来使用分离的实例。就象下面这样:
import org.apache.velocity.app.VelocityEngine;
import org.apache.velocity.Template;
...
/*
* create a new instance of the engine
*/
VelocityEngine ve = new VelocityEngine();
/*
* configure the engine. In this case, we are using
* ourselves as a logger (see logging examples..)
*/
ve.setProperty( VelocityEngine.RUNTIME_LOG_LOGSYSTEM, this);
/*
* initialize the engine
*/
ve.init();
...
Template t = ve.getTemplate("foo.vm");
|
正如你所看到的一样,非常的简单易懂!除了改变一些简单的语法,在你的应用中采用单例模式或分离实例模式不需要其他任何改变!
作为程序开发人员,你可以使用org.apache.velocity.app.Velocity和org.apache.velocity.app.VelocityEngine两个类同Velocity内部交互。但是,请记住,任何时候绝对不要在你的应用程序中使用内部的org.apache.velocity.runtime包中Runtime,RuntimeConstants,RuntimeSingleton或者RuntimeInstance类,因为它们仅仅是供内部使用的,并且以后可能会改变!
三、上下文
基础
上下文(context)是Velocity的核心概念,也是在系统各部分之间移动“数据容器”的一种常用技术。context作为Java层和模板层的数据载体!作为开发人员,你需要收集你的应用程序所需要的各种类型的对象,并把它们放在context中。作为设计者,可以通过 引用 来存取这些对象。通常,开发人员需要和设计人员一同研究决定应用中需要的数据。因此,这种协同开发值得多花费一些时间并仔细对需求进行分析!
Velocity允许开发人员创建自己的context类来支持特殊需求或技术(LDAP server),并提供了一个基础的实现类VelocityContext!VelocityContext适用于所有通常的需求,强烈建议使用它!仅仅在特殊和高级的案例中创建自己的context实现。
使用VelocityContext就象使用HashTable一样简单,这个接口包含了许多有用的方法,最常用的是:
public Object put(String key,Object value);
public Object get(String key);
需要注意的是,如同HashTable一样,值必须是Object类型的,并且不能为空!象 int,float等基本数据类型必须包装成适当的类类型。
这里是一些基本的context操作,更多信息请查看API。
通过#foreach()对迭代对象的支持
作为开发人员,你可以把多种对象存储到context中,但是也有一些限制,所以应该理解Velocity支持什么类型,以及可能会产生什么问题。Velocity可以在VTL的#foreach()方法中使用很多类型的集合。
·Object[]正常的对象数组。 Velocity会在内部使用一个提供Iterator接口的类来包装这个数组,但是开发人员和模板设计者不需要关系这个过程。
·java.util.Collection Velocity将调用iterator()方法获得一个Iterator,所以如果你的类实现了一个Collection接口,请确信iterator()方法会返回一个可用的Iterator.。
·java.util.Map 这里,Velocity将通过values()方法获得一个Collection接口,并通过这个接口调用iterator()方法获得Iterator。
·java.util.Iterator 注意:这只是暂时被支持的,原因是Iterator不支持reset。如果一个Iterator被存储在context中,并且被多个#foreach()方法调用,那么除第一个#foreach()方法外,其他的都将失败,因为Iterator不支持reset!
·java.util.Enumeration 同上
基于Iterator和Enumeration的限制,强烈建议仅仅在不可避免的时候才使用它们,并且如果可能的话,你应该让Velocity自己查找适当的可重用的迭代接口。
上下文链(Context Chaining)
Velocity的一个创新的特性就是Context Chaining 概念。有时被称为Context Wrapping,这个高级特性允许你把分离的contexts通过一种方式连接起来,对template而言就象是一个context一样!
VelocityContext context1 = new VelocityContext();
context1.put("name","Velocity");
context1.put("project", "Jakarta");
context1.put("duplicate", "I am in context1");
VelocityContext context2 = new VelocityContext( context1 );
context2.put("lang", "Java" );
context2.put("duplicate", "I am in context2");
template.merge( context2, writer );
|
在上面的例子中,我们把context2和context1连接起来。这意味着在模板中,你可以存取存放在VelocityContext中的任何对象,只要他们的key不重复就可以,如果key出现重复的话,那么context2中值将是可用的。但值得注意的是,实际上context1中重复的key并没
有被改变或破坏,仍然可以通过context1.get(“duplicate”)方法获得context1中deplicate的值!但请记住:在模板中没有任何方法获得context1中deplicate的值!同样,当你通过#set()方法向context中增加信息的时候,这个新的信息将被增加到最外层的context中的key中,所以,请不要试图将信息通过#set()方法增加到内层的context中!
在Template中创建对象
通常有两种情况需要在JAVA代码中处理由template在运行时创建的对象:
·template调用由JAVA代码放置到context中的对象的方法。
·JAVA代码在合并后存取由template放置到context中的对象。
关于context的一些其他问题
VelocityContext的一个特性是结点特殊的内省缓存(introspection caching)。通常,作为开发人员可以放心的把VelocityContext做为context使用。但是,必须知道关于这个特性的一个使用模式:
VelocityContext会堆积它访问过的模板中的语法结点的内省信息。所以在下述情况下:
·重复使用同一个VelocityContext迭代访问同一个模板
·模板缓存关闭
·在每个反复迭代中调用getTemplate()方法请求获得Template
VelocityContext可能会导致内存泄漏(实际上是聚集了太多的内省信息)。原因是VelocityContext 会堆积它所访问过的每个模板的内省信息,如果template缓存被关闭,将导致VelocityContext每次都访问一个新的模板,从而堆积更多的内省信息。
强烈建议你做如下的事情:
·当template处理结束后创建一个新的VelocityContext,这将阻止堆积内省信息。如果你需要重用携带数据和对象的VelocityContext,可以简单的用另一个VelocityContext来包装它。外层的VelocityContext将会堆积内省的信息,但另人兴奋的是你将丢弃它!
·开启模板的缓存机制!这将阻止每次都对template重新解析,这样VelocityContext不仅可以避免增加内省信息,同时还可以改进程序。
·在循环迭代期间重用Template对象。这样,当缓存关闭的时候就不用强迫Velocity一次又一次的去重新读取和重新解析同样的template,因此,VelocityContext也就不会每次都堆积新的内省信息!
分享到:
相关推荐
包括以下四个基本文档: Velocity初级入门指南.doc velocity基础.doc Velocity教程.pptx velocity入门使用教程.doc
Velocity入门教程,语法,Velocity布局,Spring框架集成Velocity
Velocity入门教程实例,包括velocity介绍,语法详解,以及具体的示例!
Velocity入门Demo,含源代码, 直接放到tomcat可以运行
Velocity模板入门简单DEMO, 代码有注解;
Velocity入门,velocity是基于Java的引擎模版
初学velocity,做的一个小实例。
入门文档及应用源码,很适合做自动代码生成 包括:Velocity的中文指南\ velocity中文手册\ \基于Ant+Velocity的简单代码生成器的思路与实现
velocity的简单入门使用,主要适合刚开始学习velocity的人使用,也可以作为平时的参考
velocity入门简介,可作为入门学习,培训材料1
从Velocity的基础说起,讲到了其语法、然后结合其他流行技术进行延伸讲解,希望对你有帮助——资料仅有前14章,但已足够学习了
velocity快速入门
Apache-Velocity-java
NULL 博文链接:https://yaphis.iteye.com/blog/2080752
文档是velocity基本知识,语法运用,宏定义等,适合新手入门
本课程从velocity engine也就是velocity引擎开始, 先讲解velocity的基本使用以及基础语法 , 然后再讲解velocity 的进阶内容velocity Tools , 以及velocity作为web项目的视图改如何使用 , 每一部分都会有一个综合案例...
velocity入门实例,java代码读取配置文件 可直接运行
想学习velocity模板语言的可以看一看,内容比较简洁,适合初学者使用。
velocity入门例子-velocity入门demo,给自己备份的