Velocity语法(VM)

Tue, 16 Nov 2010 08:43:00 GMT

Velocity语法(VM)

1. 变量

(1) 变量的定�?�Q?

#set($name = "hello") 说明�Q�velocity中变量是��q��型的�?

当��?set 指��o�Ӟ��括在双引号中的字面字�W�串��解析和重新解释�Q�如下所�C�：

#set($directoryRoot = "www" )

#set($templateName = "index.vm" )

#set($template = "$directoryRoot/$templateName" )

$template

输出��会是： www/index.vm

注：在velocity中��?2.5�q�样的货币标识是没有问题得的�Q�因为velocity中的变量��L��以一个大写或者小写的字母开始的�?

(2) 变量规范的写�?

${name} �Q�也可以写成�Q?name。提倡用前面的写法�?

例如�Q�你希望通过一个变�?vice 来动态的�l�织一个字�W�串�?

Jack is a $vicemaniac.

本来变量�?$vice现在却变成了$vicemaniac�Q�这样Veloctiy��׃��知道�(zh��n)�到底要什么了。所以，应该使用规范的格式书�?�Q?Jack is a ${vice}maniac
现在Velocity知道变量�?vice而不�?vicemaniac�?

注意�Q�当引用属性的时候不能加{}

(3) 变量的赋�?

$name="hello"

赋值的左边必须是一个变量或者是属性引用。右边可以是下面六种�c�d��之一�Q?

变量引用,字面字符�?属性引�?�Ҏ(gu��)��引用,字面数字,数组列表�?

下面的例子演�C�Z��上述的每�U�类型：

#set( $monkey = $bill ) ## variable reference

#set( $monkey.Friend = "monica" ) ## string

#set( $monkey.Blame = $whitehouse.Leak ) ## property reference

#set( $monkey.Plan = $spindoctor.weave($web) ) ## method reference

#set( $monkey.Number = 123 ) ##number

#set( $monkey.Say = ["Not", $my, "fault"] ) ## ArrayList

注意�Q?①如果上�q�C��子中的右值是null, 则左��g��会被赋��|��也就是说会保留以前的倹{�?

②velocity模板中未被定义的变量��被认�ؓ是一个字�W�串。例如：

#set($foo = "gibbous")
$moon = $foo
输出�l�果为：
$moon = gibbous

�?velocity 模板中不会将 reference 解释为对象的实例变量。例如： $foo.Name ��被解释�?Foo 对象�?getName �Q�）�Ҏ(gu��)��Q�而不�?Foo 对象�?Name 实例变量。例如：

$ foo.getBar() �{�同�?$ foo.Bar �Q?

$ data.getUser("jon") �{�同�?$ data.User("jon") �Q?

data.getRequest().getServerName() �{�同�?

$ data.Request.ServerName �{�同�?$ {data.Request.ServerName}

2. 循环

#foreach ($element in $list)
This is $element.
$velocityCount
#end

例子�Q?

#set( $list = ["pine", "oak", "maple"])

#foreach ( $ element in $ list)

$velocityCount

This is $ element.

#end

输出的结果�ؓ�Q?

1 This is pine.
2 This is oak.
3 This is maple.

每次循环 $list 中的一个值都会赋�l?$element 变量�?
$list 可以是一�?Vector�?Hashtable 或�?Array 。分配给 $element 的值是一�?java 对象�Q��ƈ且可以通过变量被引用。例如：如果 $element t 是一�?java �?Product �c�，�q�且�q�个产品的名字可以通过调用他的 getName�Q�） �Ҏ(gu��)��得到�?

#foreach ( $key in $list.keySet())
Key: $key -> Value: $list.get($key)

#end

提示 �Q�velocity中大��写敏感�?

Velocity�q�特别提供了得到循环�ơ数的方法，$velocityCount变量的名字是Velocity默认的名字�?

例子�Q?

First example:
#foreach ( $foo in [1..5] )
$foo
#end

Second example:
#foreach ( $bar in [2..-2] )
$bar
#end

Third example:
#set ( $arr = [0..1] )
#foreach ( $i in $arr )
$i
#end
上面三个例子的输出结果�ؓ�Q?
First example �Q?
1 2 3 4 5

Second example �Q?
2 1 0 -1 -2

Third example �Q?
0 1

3. 条�g语句

#if (condition)

#elseif (condition)

#else

#end

4. 语句的嵌�?

#foreach ($element in $list)

## inner foreach 内��@�?

#foreach ($element in $list)

This is $element. $velocityCount < br > inner < br >

#end

## inner foreach 内��@环结�?

## outer foreach

This is $element.

$velocityCount < br > outer < br >

#end

语句中也可以嵌套其他的语句，�?if…#else…#end�{��?

5.       注释
(1)单行注释�Q?br /> ## This is a single line comment.
(2) 多行注释�Q?br /> #*
   Thus begins a multi-line comment. Online visitors won’t
   see this text because the Velocity Templating Engine will
ignore it.
*#
(3)文档格式�Q?br /> #**
   This is a VTL comment block and
   may be used to store such information
as the document author and versioning
   information:
   @version 1.1

@author xiao
*#

6. 关系和逻辑操作�W?

Velocity 也具有逻辑AND, OR �?NOT 操作�W��?

�?

## example for AND

#if($foo && $bar)

This AND that

#end

例子�?if() 指��o仅在$foo �?bar 斗�ؓ真的时候才为真。如�?foo 为假�Q�则表达式也为假�Q��ƈ�?$bar ��不被求倹{��如�?$foo 为真�Q�Velocity 模板引擎��l�检�?bar的��|��如果 $bar 为真�Q�则整个表达式�ؓ真。�ƈ且输出This AND that 。如�?$bar 为假�Q�将没有输出因�ؓ整个表达式�ؓ假�?

7.Velocity 中的�?

Velocity中的宏我们可以理解�ؓ函数�?

①宏的定�?

#macro(宏的名称 $参数1 $参数2 …)

语句�?卛_��C��)

#end

②宏的调�?

#宏的名称($参数1 $参数2 …)

说明�Q�参��C��间用�I�格隔开�?

8�Q?#stop

停止执行模板引擎�q�返�?把它应用于debug是很有帮助的�?

9�Q?include �?parse

#include�?parse的作�?都是引入本地文�g, ��Z��安全的原因，被引入的本地文�g只能在TEMPLATE_ROOT目录下�?

区别�Q?

(1) �?include不同的是�Q?parse只能指定单个对象。�?include可以有多�?

如果�(zh��n)�需要引入多个文�Ӟ��可以用逗号分隔��p��Q?
#include ( " one.gif " , " two.txt " , " three.htm " )
在括号内可以是文件名�Q�但是更多的时候是使用变量的：
#include ( “greetings.txt”, $seasonalstock )

(2) #include被引入文件的内容��不会通过模板引擎解析�Q?

�?parse 引入的文件内�?Velocity ��解析其中的 velocity 语法�q�移交给模板�Q�意思就是说相当与把引入的文�?copy 到文件中�?

#parse是可以递归调用的，例如�Q�如果dofoo.vm包含如下行：

Count down.

#set ($count = 8)

#parse ("parsefoo.vm")

All done with dofoo.vm!

那么在parsefoo.vm模板中，你可以包含如下VTL�Q?

$count

#set($count = $count - 1)

#if ( $count > 0 )

#parse( "parsefoo.vm" )

#else

All done with parsefoo.vm!

#end 的显�C�结果�ؓ�Q?

Count down.

All done with parsefoo.vm!

All done with dofoo.vm!

注意�Q�在 vm中��?parse来嵌套另外一个vm时的变量�׃�n问题。如�Q?br /> ->a.vm 里嵌�?b.vm�Q?br /> ->a.vm 里定义了变量 $param�Q?br /> ->b.vm 里可以直接��?param�Q�无��M��限制�?br /> 但需要特别注意的是，如果b.vm里同时定义有变量$param�Q�则b.vm里将使用b.vm里定义的倹{�?

10�Q��{义字�W?\'的��?

如果reference被定义，两个’\’意味着输出一�?#8217;\’�Q�如果未被定义，刚按原样输出。如�Q?

#set($email = "foo" )

$email

\$email

\\$email

\\\$email

输出�Q?

foo
$email
\foo
\$email

如果 $email 未定�?

$email

\$email

\\$email

\\\$email

输出�Q?

$email
\$email
\\$email
\\$email

11�Q?内置对象
Velocity内置了一些对象，在vm模版里可以直接调用，列�D如下�Q?br /> $request�?response�?session�Q�另外，模板内还可以使用 $msg内的消息工具讉K�� Struts 的国际化资源�Q�达到简便实现国际化的方法�?

12. 数组讉K��

�Ҏ(gu��)��l�的讉K��在Velocity 中存在问题，因�ؓVelocity只能讉K��对象的方法，而数�l�又是一个特�D�的Array�Q�所以虽然数�l�可以进行��@环列举，但却不能定位讉K��特定位置的元素，�?strs[2]�Q�数�l�对固定位置元素的访问调用了Array的反��方法get(Object array, int index)�Q�而Velocity没能提供�q�样的访问，所以数�l�要么改成List�{�其他类容器的方式来包装�Q�要么就通过公用Util�cȝ��方式来提供，传入数组对象和要讉K��的位�|�参敎ͼ�从而达到返回所需值的目的�?

�C�Z��部分

1�Q�Hello world的示例代码：

(1)Velocity模板 (hello.html)

New Document

hello,$name! �Q�注意：�q�里的name与VelocityTest.java中的名称要一��_��

(2)��velocity模板的内容�{换的�c?VelocityTest.java)

import java.io.File;

import java.io.FileOutputStream;

import java.io.PrintWriter;

import java.io.Writer;

import org.apache.velocity.Template;

import org.apache.velocity.VelocityContext;

import org.apache.velocity.app.Velocity;

import org.apache.velocity.app.VelocityEngine;

/**

* Velocity转换

* @author

public class VelocityTest

{

/**

* ��d��?

* @param args

public static void main(String[] args)

{

//获取模板引擎

VelocityEngine ve = new VelocityEngine();

//模板文�g所在的路径

String path = "D:/java/jproject/regedit/webroot";

//讄��参数

ve.setProperty(Velocity.FILE_RESOURCE_LOADER_PATH, path);

//处理中文问题

ve.setProperty(Velocity.INPUT_ENCODING,"GBK");

ve.setProperty(Velocity.OUTPUT_ENCODING,"GBK");

try

{

//初始化模�?

ve.init();

//获取模板(hello.html)

Velocity 模板的名�U?

Template template = ve.getTemplate("hello.html");

//获取上下�?

VelocityContext root = new VelocityContext();

//把数据填入上下文

root.put("name","world"); �Q�注意：与上面的对应�Q?

//输出路径

Strint outpath = "e:/helloworld.html";

//输出

Writer mywriter = new PrintWriter(new FileOutputStream(

new File(outpath)));

template.merge(root, mywriter);

mywriter.flush();

}

catch (Exception e)

{

e.printStackTrace();

}

(3)环境的搭�?

在lib目录内分别copy �q�：velocity-1.4.jar�Q�velocity-dept.jar;

下蝲地址�Q�http://jakarta.apache.org/velocity/

(4)�q�行后的�l�果如下�Q?

New Document

hello,world!

2�Q?Servlet和Velocity�l�合 �C�Z��

(1)example.html

Velocity

Welcom to Velocity!

    Here's the list of people




    #foreach ($name in $theList)



    #end

Names�Q?br />

$name

(2)servlet

package com.koal.velocity;

import java.io.IOException;

import java.io.FileNotFoundException;

import java.util.ArrayList;

import java.util.Properties;

import java.util.Vector;

import javax.servlet.ServletConfig;

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.servlet.VelocityServlet;

import org.apache.velocity.app.Velocity;

import org.apache.velocity.exception.ResourceNotFoundException;

import org.apache.velocity.exception.ParseErrorException;

public class SampleServlet extends VelocityServlet

{

/**

* 由VelocityServlet.init()调用�Q?

* 在此扑և�模版的�\�?

protected Properties loadConfiguration(ServletConfig config )

throws IOException, FileNotFoundException {

Properties p = new Properties();

//取得路径

String path = config.getServletContext().getRealPath("/");

if (path == null)

{

System.out.println(" SampleServlet.loadConfiguration() : unable to "

+ "get the current webapp root. Using '/'. Please fix.");

path = "/";

}

//讄��路径

p.setProperty( Velocity.FILE_RESOURCE_LOADER_PATH, path);

return p;

}

/**

* Velocity主要的商业逻辑处理�Ҏ(gu��)��Q�由VelocityServlet自动调用

* @param ctx 模板上下�?nbsp;

* @return Template 模板信息

public Template handleRequest( HttpServletRequest request,

HttpServletResponse response, Context ctx )

{

//主要在此讄��演示用的数据�Q�开发中在此调用相应的业务处理流�E�，

//�q�设�|�返回到��面的数�?

        //待展�C�的列表数据
        String p1 = "�W�一位：LiuDong";
        String p2 = "�W�二位：Liang.xf";
        Vector personList = new Vector();
        //中文需要�{�?br />         try {
            personList.addElement(new String(p1.getBytes(), "ISO-8859-1") );
            personList.addElement(new String(p2.getBytes(), "ISO-8859-1") );
        } catch (Exception e) {
            System.out.println("数据转换异常�Q?+e);
        }
        //讄��数据�Q�供��面模版替换成显�C�的数据
        ctx.put("theList", personList );

//定义模板

Template outty = null;

try

{

//取模�?

outty = getTemplate("example.html");

}

catch( ParseErrorException pee )

{

System.out.println("SampleServlet: parse error for template " + pee);

}

catch( ResourceNotFoundException rnfe )

{

System.out.println("SampleServlet: template not found " + rnfe);

}

catch( Exception e )

{

System.out.println("Error " + e);

}

return outty;

}

(3)在web.xml中的配置�Q?

SampleServlet

com.koal. velocity .SampleServlet

SampleServlet

/SampleServlet

(4)环境的搭�?

在lib目录内分�?copy�q�：commons-collections.jar , velocity- 1.4.jar�Q�velocity-dept.jar;
Tomcat�q�行环境正常�?br /> 启动Tomcat�Q�在IE上输入： http://localhost:8080/example �Q�页面显�C�数据列表：

本文来自CSDN博客�Q��{载请标明出处�Q�http://blog.csdn.net/mmm123lmj/archive/2009/11/19/4833620.aspx

半导�?/a> 2010-11-16 16:43 发表评论

亚洲中文字幕久久精品无码2021,久久久久亚洲av无码尤物,爱情岛论坛亚洲品质自拍视频网站

Velocity语法(VM)

Welcom to Velocity!