Velocity中文手册_velocity中文手册

velocity

4星 · 超过85%的资源需积分: 40 860 浏览量更新于2023-05-23 评论收藏 698KB PDF 举报

身份认证购VIP最低享 7 折!

领优惠券(最高得80元）

资源详情

资源评论

资源推荐

Velocity 中文手册

1 关于

Velocity 用户指南旨在帮助页面设计者和内容提供者了解 Velocity 和其简单而又强大的脚本语言

（Velocity Template Language (VTL)）。本指南中有很多示例展示了用 Velocity 来讲动态内容嵌入到网站

之中，但是所有的 VTL examples 都同演示用于所有的页面和模版。

感谢选择 Velocity!

2 什么是 Velocity?

Velocity 是一个基于 Java 的模版引擎。它允许 web 页面设计者引用 JAVA 代码预定义的方法。Web 设

计者可以根据 MVC 模式和 JAVA 程序员并行工作，这意味着 Web 设计者可以单独专注于设计良好的站点，

而程序员则可单独专注于编写底层代码。Velocity 将 Java 代码从 web 页面中分离出来，使站点在长时间运

行后仍然具有很好的可维护性，并提供了一个除 JSP 和 PHP 之外的可行的被选方案。

Velocity 可用来从模板产生 web 页面，SQL, PostScript 以及其他输出。他也可用于一个独立的程序以产生

源代码和报告，或者作为其它系统的一个集成组件。这个项目完成后，Velocity 将为 Turbine web 应用程

序框架提供模板服务。Velocity+Turbine 方案提供的模板服务将允许 web 应用按真正的 mvc 模式进行开发。

3 Velocity 可以做什么?

Mud Store 示例

假设你是一个专门销售泥浆（MUD）的在线商店的页面设计者。我们称他为"The Online Mud Store"。

生意很好。客户订购各种各样的类型和数量的泥浆。他们使用他们的用户名和密码登陆到商店中来，就可

以浏览他们的订货和购买其他东西。现在，赤土陶泥正在促销，这是一种很常用的泥巴。一少部分顾客很

有规律的购买一种亮红土 Bright Red Mud，这也是促销产品，但是不太常用，因此被移到页面的边缘。所

有顾客的信息都在数据库中被跟踪，因此有一天问题出现了：为什么不使用 Velocity 来定位目标客户，这

些客户对某种类型的产品特别感兴趣？

Velocity 使针对访问者个性的 WEB 页面客户化（个性化）非常容易。作为一个在线泥巴商店的站点设

计者，以想在客户以登陆进展点后就看到它们想看的页面。

你遇到你公司的软件工程师，每个人都认为$customer 将保持当前登陆进入的客户信息，而

$mudsOnSpecial 将士当前所有促销的泥巴。$flogger 对象包含有助于促销的方法。对于当前的任务，让我

们仅关注这三个问题。记住，你不需要担心软件工程师如何从数据库中取得顾客信息，但你必须知道他们

可以。这样可以使你专注于你的工作而软件工程师则忙于他们自己的工作。

你可以在你的页面中嵌入如下的 VTL 语句：

<HTML>

<BODY>

Hello $customer.Name!

<table>

#foreach( $mud in $mudsOnSpecial )

#if ( $customer.hasPurchased($mud) )

<tr>

<td>

$flogger.getPromo( $mud )

</td>

</tr>

#end

</table>

foreach 语句的细节将进一步细说，但重要的是这个短小的脚本居然可以在你的站点上运行。当有一个倾向

于亮红土的顾客登陆进来时，亮红土正在促销，这就是这个顾客所看到的，并且促销显示非常显著。如果

另外一个长期购买赤陶土的顾客登陆进来，赤陶土促销的提示信息则应该在前面中间位置。Velocity 是非

常灵活的，受限的只是你的创造力。

写在 VTL 参考文档中的是其他 Velocity 元素，他们一起给你很强大的能力和灵活性以创建很好的站点。待

你更加了解这些元素，就可以开始释放 Velocity 的强大动力。

4 Velocity 模板语言(VTL): 介绍

Velocity 模板语言(VTL)旨在为 Web 页面结合动态内容提供最容易、简单和简洁的方法。即使有一点或

者没有编程经验的页面设计者也可以很快能为页面提供动态内容。

VTL 使用引用（references）来将动态内容嵌入 web 页面，每个变量就是某一个类型的引用。变量实

际上是一个可以调用定义在 java 代码中的内容的引用，或者它可以从页面内的 VTL 语句得出自身的值。下

面是一个例子，说明可以嵌入到 HTML 文档中的 VTL 语句。

#set( $a = "Velocity" )

这个 VTL 语句，就像所有的 VTL 语句一样，以 # 字符开始，并跟着一个指令 set。当一个在线访问这

请求页面时， Velocity 模伴引擎在页面内搜索所有#字符，然后决定是哪一个标记了 VTL 语句的开始，哪

个标记不需要 VTL 做什么动作。

# 字符后面紧跟一个指令 set.。set 指令使用一个括在括号内的表达式---一个等式将一个值指派给一

个变量。变量在等号的左边而值在等号的右边。

在上面的示例中，变量是 $a 值是 Velocity。这个变量就象其他引用一样，以一个$字符开始。值通常

在引号之中，对 Velocity 来说一般没有类型冲突的问题，因为只有字符串 (基于文本的信息)可以传递给变

量。

Java 代码中取得。例如，如果 Java 变量 $foo 在模板被请求的时候具有值 bar，则 bar 将替换页面中

的所有$foo 的实例。或者，如果包含下面的语句：

#set( $foo = "bar" )

紧跟指令后的所有$foo 的实例的输出将会一样值。

7.2 属性

VTL 引用的第二种元素是属性，而属性具有独特的格式。属性的简略标记识前导符$后跟一个 VTL 标

识符，在后跟一个点号(".")最后又是一个 VTL 标识符。这是一些有效的示例：

$customer.Address

$purchase.Total

请看第一个例子， $customer.Address.。他有两种意思。它可以意味着，查询由 customer 标是的哈希

表并按关键字 Address 返回值。但是 $customer.Address 也可能引用一个方法（下述，$customer.Address

可能是$customer.getAddress().的缩写。当一个页面被请求时，Velocity 将决定这两种可能到底是哪一个，

然后返回相应的值。

7.3 方法

方法在 JAVA 代码中定义，并作一些有用的事情，比如运行一个计算器或者作出一个决定。方法是实

际上也是引用，由前导符"$"后跟一个 VTL 标识符，后跟一个 VTL 方法体（Method Body）。 VTL 方法体

由一个 VTL 标识符后跟一个左括号，再跟可选的参数列表，最后是右括号。下面是一些有效的方法示例：

$customer.getAddress()

$purchase.getTotal()

$page.setTitle( "My Home Page" )

$person.setAttributes( ["Strange", "Weird", "Excited"] )

前面两个例子-- $customer.getAddress() 和 $purchase.getTotal() – 看起来有点象上面属性一节中所

用的样子， $customer.Address 和 $purchase.Total.。如果你想这些例子在某些方面相关，那你就对了。

VTL 属性可以为 VTL 方法用作简略标记。属性$customer.Address 具有和方法

$customer.getAddress() 完全一样的效果。属性和方法的主要不同点是方法中可以添加参数列表。

简略标记可以用在下面的方法中：

sun.getPlanets()

$annelid.getDirt()

$album.getPhoto()

我们或许希望方法可以为我们放回属于太阳系的行星的名字，喂养我们的蚯蚓，或者从相册中返回一

张照片。下面只有长的那个标记是可以工作的方法：

$sun.getPlanet( ["Earth", "Mars", "Neptune"] )

剩余23页未读，继续阅读

ddy_dhj

2020-04-30

可以用心了

lixin03080

粉丝: 2
资源: 4

会员权益专享

Velocity中文手册

评论1

会员权益专享

最新资源

Velocity中文手册

评论1

Velocity用户手册---中文版

velocity 用户手册 参考文档 详细讲解

velocity 中文开发文档

《Velocity java开发指南》中文版

velocity为空判断

org.apache.velocity

Velocity标签详解文档

你能解释一下unity里面的velocity

模板：velocity和freemarker的比较

给公司内部人员培训资料 velocity

velocity-engine-core

org.apache.velocity.context.context

org/apache/velocity/context/context

mRig.velocity=new Vector2(Input.GetAxisRaw("Horizontal"),mRig.velocity.y

java中 velocity 与 freemark 的对比

MS velocity tool

java.lang.noclassdeffounderror: org/apache/velocity/context/context

会员权益专享

最新资源

velocity 用户手册参考文档详细讲解