`

Velocity源码分析(一)——概述

 
阅读更多

原文链接 :http://coderj.org/blog/2011/08/19/velocity_overview/

一、概述

Velocity模板引擎处理机制分为五个基本步骤:

  1. 引擎初始化,通过设置的引擎属性初始化引擎,包括国际化支持,ResourceLoader设置,字符编码等。
  2. 获取并解析模板文件,首先通过资源加载器(ResourceLoader)将模板文件加载到内存(转化为InputStream),然后通过AST(Abstract Syntax Tree)解析器将InputStream解析为一个AST。
  3. 创建一个Context
  4. 将模板渲染所需的参数放入context
  5. 执行模板渲染,产生输出流。渲染过程中通过遍历该模板对应的AST,调用相应节点的处理器执行渲染。

整个处理流程如下图所示:

二、详细渲染流程

下面以一个简单的模板template.vm为例,详细解释渲染过程。
VelocityMergeTest.java

public class VelocityMergeTest {

	public static void main(String[] args) {
		VelocityEngine ve = new VelocityEngine();
		ve.setProperty(Velocity.RESOURCE_LOADER, "class");
		ve.setProperty("class.resource.loader.class",
				"org.apache.velocity.runtime.resource.loader.ClasspathResourceLoader");
		try {
			// 引擎初始化
			ve.init();
			// 加载解析模板
			Template tp = ve.getTemplate("template.vm");
			// 创建context
			Context context = new VelocityContext();
			// 设置Context中参数值
			context.put("foo", "VV");
			StringWriter writer = new StringWriter();
			// 执行渲染
			tp.merge(context, writer);
			System.out.println(writer.toString());
		} catch (Exception e) {
		}
	}
}

 template.vm:

<html>
   <body>
     Hello $foo world!
    </body>
</html>

2.加载解析模板

当执行ve.getTemplate(“template.vm”)时,首先通过ResourceLoader将tempalte加载为InputStream,然后通过Parser生成如下Token集合:
{[<html> <body> Hello], [$foo], [world! </body> </html> ]},
可以发现velocity根本不关系模板最终要渲染出来的是html还是什么的其他的东西,也就以为这所有的html标签对velocity来讲都是纯文本。
最终构建的AST如下

根节点下有三个子节点:

  1. [<html> <body> Hello]对应的ASTText节点;
  2. [$foo]对应的ASTReference节点;
  3. [world! </body> </html> ]对应的ASTText节点

Velocity引擎在这里有个优化策略,可以针对生成的语法树进行cache。

3.创建context并设置参数

Context context = new VelocityContext();
context.put(“foo”, “VV”);
创建一个context,并在其中放入一个foo=VV的参数。

4.执行渲染

当执行tp.merge(context, writer);时,模板遍历其对应的AST树,执行每个节点的渲染过程。如ASTText节点只是简单的将文本写入writer。 ASTReference节点需要从context中获取引用的参数foo的值VV,将$foo替换,并写入到writer中。Velocity的AST 中有多种节点,如ASTIdentitor等,有些需要反射机制处理。当整个AST遍历结束,也就意味着模板渲染结束,渲染的结果位于writer流中。

三、关于AST解析

Velocity作为模板语言,其核心在与模板文件的解析,构建AST。Velocity的解析器是通过JavaCC构建 的,JavaCC(Java Complier Complier)是一个用于生成解析器的工具,可以根据语法定义(.jj文件)生成用于校验一份文本是否符合该语法定义的java代码。JJTree是 JavaCC中提供的一种根据语法定义(.jjt文件)生成构建符合该语法定义的文本的语法树的java代码的工具。
Velocity源码包中提供了用于构建velocity语法解析的的jjt文件,位于src/parser/Parser.jjt。可以自己手动从源码构建Velocity的解析器。步骤如下:
1.下载安装JavaCC,到http://javacc.java.net/下载即可,velocity的解析器需要3.2版本以上。下载后解压即可。
2.使用JJTree生成节点定义:
$ javacc-5.0/bin/jjtree Parser.jjt
这一过程中会生成节点定义的Java文件和Parser.jj语法定义文件
3.使用JavaCC生成解析器
$ javacc-5.0/bin/javacc Parser.jj
最终会生成Parser.java解析器和个节点定义。

分享到:
评论

相关推荐

    Velocity 源码例子

    ** Velocity 源码分析与应用实例 ** Velocity 是一个基于 Java 的模板引擎,它允许开发者将业务逻辑和页面展示分离,使得Web开发更加高效。Velocity 提供了一种简单但强大的语言来创建动态内容,其核心设计思想是...

    velocity实践——初识velocity

    NULL 博文链接:https://twb.iteye.com/blog/265761

    velocity 入门文档及应用源码,很适合做自动代码生成

    4. **velocity(1).rar** 和 **velocity.rar**:这两个RAR文件可能是Velocity的源码或相关示例项目的压缩包,供开发者下载研究。 **总结** Velocity作为一款强大的模板引擎,为Java开发提供了灵活的内容生成解决...

    velocity-1.7-sources.zip

    Velocity 是一个基于 Java 的模板引擎框架,提供的模板语言可以使用在 Java 中定义的对象和变量上。Velocity 是 Apache 基金会的项目,开发的目标是分离 MVC 模式中的持久化层和业务层。但是在实际应用过程中,...

    Python在校园数据分析中的应用——以一卡通消费为例.pdf

    在讨论Python在校园数据分析中的应用时,首先需要了解大数据的特点,也就是IBM提出的5V特点:大量(Volume)、高速(Velocity)、多样(Variety)、价值(Value)以及真实性(Veracity)。这些特点意味着在大数据...

    Velocity 分析

    源码分析可以帮助开发者更好地理解和定制Velocity以满足特定需求。此外,有一些工具可以帮助开发者更高效地使用Velocity,例如IDE插件、模板调试器等,它们可以提高开发效率并减少错误。 总的来说,Velocity是一个...

    velocity项目源代码

    【Velocity项目源代码】是一个基于Java的模板引擎,它被广泛应用于Web开发中,用于生成动态内容。Velocity通过将业务逻辑与表示层分离,提高了Web应用程序的开发效率和可维护性。这个【描述】提到的"Velocity_...

    velocity-1.5.jar,velocity-1.6.2-dep.jar,velocity-tools-1.3.jar

    Velocity是Apache软件基金会的一个开源项目,它是一款强大的模板引擎,主要用于生成动态Web内容。 Velocity的主要优点在于其简单易用和高度可扩展性,使得开发者能够将业务逻辑与表现层分离,提高代码的可读性和维护...

    Struts+Velocity整合示例(含源码)

    这通常通过配置Struts2的Result类型来完成,例如设置一个`velocity`类型的Result,指定对应的Velocity模板文件路径。在Action中,你可以将需要在模板中使用的数据放入ValueStack或者ActionContext,Velocity模板可以...

    IOS应用源码——动画.rar

    这个"IOS应用源码——动画.rar"压缩包很可能是包含了一个或多个示例项目,用于演示如何在iOS应用程序中实现各种类型的动画。通过研究这些源码,开发者可以学习到如何在Swift或Objective-C中运用Apple的UIKit框架来...

    velocity的jar包

    Velocity是Apache软件基金会的一个开源项目,它是一个基于Java的模板引擎,用于生成动态网站内容。Velocity被设计成一个轻量级的、快速的、非侵入式的模板语言,使得开发者能够将HTML页面的展示逻辑与业务逻辑分离,...

    Velocity_中文手册

    Velocity通过使用简单而功能强大的脚本语言——Velocity模板语言(Velocity Template Language,简称VTL)来实现这一点。VTL能够让开发者定义模板,模板中可以包含数据的占位符和控制结构。 Velocity在Web开发中...

    Velocity

    ### 源码分析 深入研究Velocity的源码有助于理解其工作原理,例如如何解析模板、如何执行指令、如何处理上下文对象等。这不仅可以帮助优化模板设计,还能为自定义扩展提供基础。 ### 学习资源 - 博文链接:...

    JSP源码——tot-jsp-cms.zip

    《JSP源码分析——深度探索TOT-JSP-CMS系统》 JSP(JavaServer Pages)是一种基于Java技术的服务器端脚本语言,用于创建动态网页。TOT-JSP-CMS是一个使用JSP编写的网站内容管理系统,它为开发者提供了一个灵活、可...

    velocity和freemarker的比较

    标题“velocity和freemarker的比较”涉及到的是两个在Java Web开发中常用的模板引擎——Velocity和FreeMarker。它们都是用于将静态模板与动态数据结合,生成HTML或其他类型的文本输出,常用于MVC(模型-视图-控制器...

    Java进阶教程Velocity快速掌握模板引擎视频

    本课程从velocity engine也就是velocity引擎开始, 先讲解velocity的基本使用以及基础语法 , 然后再讲解velocity 的进阶内容velocity Tools , 以及velocity作为web项目的视图改如何使用 , 每一部分都会有一个综合案例...

    struts2+Velocity替换jsp项目源码

    通过这个"struts2+Velocity替换jsp项目源码",你可以学习到如何将一个传统的基于JSP的Web应用转换为使用Velocity作为视图层,从而提升项目的可维护性和性能。这是一个很好的实践案例,对于深入理解和掌握Struts2与...

    velocity的所有jar包

    - **高效性能**:Velocity在编译模板后生成Java源码,然后由JVM执行,这使得其运行速度快且资源消耗低。 - **可扩展性**:Velocity Tools和其他扩展可以增加更多功能,如国际化、表单处理等。 然而,需要注意的是,...

    velocity插件

    Velocity 是一款基于 Java 的模板引擎,它被广泛应用于 Web 开发中,特别是作为 Apache Struts 和 Spring MVC 框架的一部分。Velocity 插件则是为了在开发环境中提供对 Velocity 模板语言的支持,使得开发者可以在 ...

    velocity为空判断

    Velocity是Apache软件基金会的一个开源项目,它是一个模板引擎,用于将HTML、XML或其他类型的文档与数据源结合起来,生成动态内容。在使用Velocity作为视图层处理数据时,常常需要进行空值判断,确保模板能够正确地...

Global site tag (gtag.js) - Google Analytics