Velocity模板语言VTL
Velocity是Apache软件组织提供的一想开源源码项目，可前往Apache Velocity Project下载。它是基于Java的模板引擎，主要用于简化Web应用开发。网页设计者可以通过Velocity模板语言定义模板，开发者编写程序代码设置上下文，Velocity引擎负责结合模板和上下文，以此生成动态网页。很明显，Velocity可将Java代码从Web页面中分离出来，是Web站点在长时间运行后仍然有很好的维护性。视图VTL模板语言不用经过JSP编译器的编译,VTL模板的解析是由Velocity引擎来完成的。特别需要注意的是，若扩展VelocityServlet,将被提示the type VelocityServlet is deprecated，如下图所示:
。API文档中写道，This servlet has been replaced by VelocityViewServlet, available from the Velocity-Tools sub-project. VelocityViewServlet provides support for quick, clean MVC web development. VelocityServlet will be removed in a future version of Velocity.于是，我去扩展VelocityViewServlet,引用的时候，发现
，顿时感觉Velocity API文档在逗我。我进入VelocityViewServlet源码中发现，原来注释中有告诉我们，已经被移动到org.apache.velocity.tools.view.VelocityViewServlet中，部分源码如下图所示:
Velocity实例1
新建文件myvelocity.vm,具体内容如下:
##author: DJM #set($jianming="king") Welcome $djm to Velocity! Today is $date. djm is $jianming.
创建简单的类MyVelocity,代码如下:
package com.jianming;
import java.io.StringWriter;
import java.util.Date;
import org.apache.velocity.Template;
import org.apache.velocity.VelocityContext;
import org.apache.velocity.app.VelocityEngine;
public class MyVelocity {
public static void main(String[] args) {
// 初始化并取得Velocity引擎
VelocityEngine ve = new VelocityEngine();
ve.init();
// 取得velocity的模版
Template template = ve.getTemplate("src/com/jianming/myvelocity.vm");
// 取得velocity的上下文context
VelocityContext context = new VelocityContext();
context.put("djm", "DengJianming");
context.put("date", new Date());
StringWriter sw = new StringWriter();
template.merge(context, sw);
System.out.println(sw.toString());
}
}
运行之后的结果如下图所示:
Velocity实例2
在WEB-INF目录下创建属性文件velocity.properties和vm目录，并在vm目录中创建模板文件myvelocity.vm和。
velocity.properties文件的内容为：
resource.loader = webapp webapp.resource.loader.class = org.apache.velocity.tools.view.servlet.WebappLoader webapp.resource.loader.path=/WEB-INF/vm/ input.encoding=utf-8 output.encoding=utf-8
myvelocity.vm文件的内容为:
##author: DJM <html> <head> <title>$djm</title> </head> <body bgcolor="#ffffff"> <h2>$djm</h2><hr> #set($jianming="king") Welcome $djm to Velocity!<hr> Today is <font color="#E10300">$date.</font><hr> djm is $jianming.<hr> </body> </html>
编写MyVelocity类，源码如下:
package com.threeeyes.djm;
import java.util.Date;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.velocity.Template;
import org.apache.velocity.context.Context;
import org.apache.velocity.tools.view.VelocityViewServlet;
public class MyVelocity extends VelocityViewServlet {
private static final long serialVersionUID = 8439995475770991915L;
@Override
protected Template handleRequest(HttpServletRequest request,
HttpServletResponse response, Context ctx) {
ctx.put("djm", "ZhaoXue");
ctx.put("date", new Date());
return getTemplate("myvelocity.vm");
}
@Override
protected void setContentType(HttpServletRequest request,
HttpServletResponse response) {
response.setContentType("text/html; charset=utf-8");
}
}
在web.xml文件中添加如下配置:
<servlet> <servlet-name>myVelocity</servlet-name> <servlet-class>com.threeeyes.djm.MyVelocity</servlet-class> <init-param> <param-name>org.apache.velocity.properties</param-name> <param-value>/WEB-INF/velocity.properties</param-value> </init-param> </servlet> <servlet-mapping> <servlet-name>myVelocity</servlet-name> <url-pattern>/myVelocity</url-pattern> </servlet-mapping>
部署到tomcat之后，运行程序显示结果如下:
Velocity注释
VTL中,单行注释采用"##",对于多行注释采用"#*"和"*#"符号。
Velocity指令
#set指令
#set指令用来为引用变量或者引用属性赋值，比如:
#set($djm="dengjianming")
赋值表达式的左边必须是一个变量引用或者属性引用，右边可以是变量引用($djm)、字符串("zhaoxue")、属性引用($MyWife.name)、方法引用($djm.merge($condition))、数字(200)、数组({"deng", "jian", "ming"})、简单的算术表达式。
字面字符串
当使用#set指令时，在双引号中的字面字符串将被解析。在单引号中的字面字符串将不被解析。
#if指令
当#if指令的IF条件为真时，Velocity将输出#if代码块包含的文本，比如,
#if($flag)
<h1>少说话，多生娃</h1>
#end
当$flag是一个逻辑类型为true的变量或者$flag值为非空的情况下，if才为真。当$flag是一个逻辑类型为flase的变量或者$flag的值为null，if才为假。
在#if语句后可包含#elseif和#else项。