Velocity模板语言VTL

最新推荐文章于 2020-04-24 11:52:19 发布

转载最新推荐文章于 2020-04-24 11:52:19 发布 · 374 阅读

0 ·

CC 4.0 BY-SA版权

原文链接：https://my.oschina.net/dengjianming/blog/404446

文章标签：

#java #python #测试

本文介绍了Velocity模板引擎的基本概念及其在Web开发中的应用。通过两个示例详细展示了如何配置和使用Velocity进行动态页面生成，包括Velocity的基本语法、指令及配置。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

2019独角兽企业重金招聘Python工程师标准>>>

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之后，运行程序显示结果如下: