亚洲国产综合精品一区在线播放,亚洲午夜AV无码专区在线播放,亚洲国产成人无码AV在线

Sat, 30 Jul 2005 14:32:00 GMT

创徏人：王艺
�?��：javamail@263.net
QQ��P��179985017

Velocity是什么？
Velocity是一个基于java的模板引擎（template engine�Q�。它允许��M��Z��仅简单的使用模板语言�Q�template language�Q�来引用由java代码定义的对象�?BR>当Velocity应用于web开发时�Q�界面设计�h员可以和java�E�序开发�h员同步开发一个遵循MVC架构的web站点�Q�也��是��_��面设计人员可以只关注页面的昄��效果�Q�而由java�E�序开发�h员关注业务逻辑�~�码。Velocity��java代码从web��面中分��d��来，�q�样为web站点的长期维护提供了便利�Q�同时也为我们在JSP和PHP之外又提供了一�U�可选的�Ҏ��?BR>Velocity的能力远不止web站点开发这个领域，例如�Q�它可以从模板（template�Q��生SQL和PostScript、XML�Q�它也可以被当作一个独立工��h��产生源代码和报告�Q�或者作为其他系�l�的集成�l��g使用。Velocity也可以�ؓTurbine web开发架构提供模板服务（template service�Q�。Velocity+Turbine提供一个模板服务的方式允许一个web应用以一个真正的MVC模型�q�行开发�?BR>
Velocity能�ؓ我们作什么？
The Mud Store Example
假设你是一家专门出售Mud的在�U�商店的��面设计人员�Q�让我们暂且�U�它为“在�U�MUD商店”。你们的业务很旺�Q�客户下了各�U�类型和数量的mud订单。他们都是通过输入用户名和密码后才登陆��C��的网站，登陆后就允许他们查看订单�q�购买更多的mud。现在，一�U�非常流行的mud正在打折销售。另外有一些客戯��律性的购买另外一�U�也在打折但是不是很��行的Bright Red Mud�Q�由于购买的人�ƈ不多所以它被安�|�在��面的边�~�。所有用��L��信息都是被跟�t��ƈ存放于数据库中的�Q�所以某天有一个问题可能会冒出来：��Z��么不使用velocity来��用户更好的浏览他们感兴趣的商品呢�Q?BR>Velocity使得web��面的客户化工作非常�Ҏ��。作��Z��个web site的设计�h员，你希望每个用��L��陆时都拥有自��q��面�?BR>你会见了一些公司内的��Y件工�E�师�Q�你发现他们每个人都同意客户应该拥有��h��个性化的信息。那让我们把软�g工程师应该作的事情发在一边，看一看你应该作些什么吧�?BR>你可能在��面内嵌套如下的VTL声明�Q?BR>



Hello $customer.Name!

#foreach( $mud in $nudsOnSpecial ) 
#if ( $customer.hasPurchased( $mud ) ) 

#end
#end
$flogger.getPromo( $mud )

Velocity Template Language(VTL):AN introduction
VTL意味着提供最��单、最�Ҏ��q�且最整洁的方式合�q��面动态内宏V�?BR>VTL使用references来在web site内嵌套动态内容，一个变量就是一�U�类型的reference。变量是某种�c�d��的refreence�Q�它可以指向java代码中的定义�Q�或者从当前��面内定义的VTL statement得到倹{��下面是一个VTL statement的例子，它可以被嵌套到HTML代码中：
#set ( $a = “Velocity�?)
和所有的VTL statement一��P��q�个statement以＃字符开始�ƈ且包含一个directive�Q�set。当一个在�U�用戯��求你的页面时�Q�Velocity Templating Engine��查询整个页面以便发现所有＃字符�Q�然后确定哪些是VTL statement�Q�哪些不需要VTL作�Q何事情�?BR>�Q�字�W�后紧跟一个directive�Q�set�Ӟ��q�个set directive使用一个表辑ּ��Q��用括号封闭）――一个方�E�式分配一个值给变量。变量被列在左边�Q�而它的��D��列在双��Q�最后他们之间��用＝号分剌Ӏ?BR>在上面的例子中，变量�?a�Q�而它的值是Velocity。和其他的references一样以$字符开始，而值��L��以双引号��闭。Velocity中仅有String可以被赋值给变量�?BR>��C��以下的规则：
使用$字符开始的references用于得到什么；使用#字符开始的directives用于作些什么�?BR>Hello Velocity World!
一旦某个变量被分配了一个��|��那么你就可以在HTML文�g的�Q何地方引用它。在下面的例子中�Q�一个��D��分配�l?foo变量�Q��ƈ在其后被引用�?BR>



#set ( $foo = “Velocity�?)
Hello $foo World!

上面的实现结果是在页面上打印“Hello Velocity World�Q��?BR>��Z��使包含VTL directives的statement更具有可��L��，我们鼓励你在新行开始每个VTL statement�Q�尽��你不是必须�q�么作。Set directive��在后面详细描述�?BR>注释
单行注释�Q?BR>## This is a single line comment.
多行注释�Q?BR>#*
Thus begins a multi-line comment. Online visitors won’t
see this text because the Velocity Templating Engine will
ignore it.
*#
文档格式�Q?BR>#**
This is a VTL comment block and
may be used to store such information
as the document author and versioning
information:
@version 5
@author
*#

References
在VTL中有三种�c�d��的references�Q�变�?variables)、属�?properties)、方�?methods)。作��Z��个��用VTL的页面设计者，你和你的工程师必��d��references的名�U�达成共识，以便你可以在你的template中��用它们�?BR>Everything coming to and from a reference被作��Z��个String对象处理。如果有一个对�?foo是一个Integer对象�Q�那么Velocity��调用它的toString()�Ҏ��这个对象�{型�ؓString�c�d��?BR>变量
格式要求同java�?BR>属�?
例子�Q?BR>$customer.Address
$purchase.Total
$customer.Address有两�U�含义。它可以表示�Q�查找hashtable对象customer中以Address为关键字的��|��也可以表�C��用customer对象的getAddress()�Ҏ��。当你的��面被请求时�Q�Velocity��确定以上两�U�方式选用那种�Q�然后返回适当的倹{�?BR>�Ҏ��
一个方法就是被定义在java中的一�D�代码，�q�且它有完成某些有用工作的能力，例如一个执行计��和判断条�g是否成立、满��等。方法是一个由$开始�ƈ跟随VTL标识�W�组成的References�Q�一般还包括一个VTL�Ҏ��体。例如：
$customer.getAddress()
$purchase.getTotal()
$page.setTitle( “My Home Page�?)
$person.setAttributes( [“Strange�? “Weird�? “Excited”] )
前两个例�?customer.getAddress()�?purchase.getTotal()看�v来挺想上面的属�?customer.Address �?$purchase.Total。如果你觉得他们之间有某�U�联�pȝ��话，那你是正��的�?BR>VTL属性可以作为VTL�Ҏ��的羃写�?customer.Address属性和使用$customer.getAddress()�Ҏ��h��相同的效果。如果可能的话��用属性的方式是比较合理的。属性和�Ҏ��的不同点在于你能够给一个方法指定一个参数列表�?BR>正式reference标记
reference的正是格式如下：
${mudSlinger} 变量
${customer.Address} 属�?BR>${purchase.getTotal()} �Ҏ��
非正是格式更见常用，但是有时�q�是使用正是格式比较适合。例如：你希望通过一个变�?vice来动态的�l�织一个字�W�串�?BR>Jack is a $vicemaniac.
本来变量�?vice现在却变成了$vicemaniac�Q�这样Veloctiy��׃��知道您到底要什么了。所以，应该使用正是格式书写
Jack is a ${vice}maniac
现在Velocity知道变量�?vice而不�?vicemaniac�?BR>Quiet reference notation
例如�Q?BR>
当页面的form被初始加载时�Q�变�?email�q�没有��|��q�时你肯定是希望它能够显�C�Z��个blank text来代替输出�?email”这��L��字段。那么��用quiet reference notation��比较合适�?BR>
�q�样文本框的初始值就不会是email而是�I��g��?BR>正式和quiet格式的reference notation也可一同��用，像下面这��P��

Getting literal
Velocity使用�Ҏ��字符$�?来帮助它工作�Q�所以如果要在template里��用这些特�D�字�W�要格外��心。本节将讨论$字符�?BR>货币字符
在VTL中��?2.5�q�样的货币标识是没有问题得的�Q�VTL不会��它错认为是一个reference�Q�因为VTL中的reference��L��以一个大写或者小写的字母开始�?BR>Escaping valid VTL reference
VTL中��用“\”作为逃逸符�?BR>例如�Q?BR>

  #set( $email = “foo�?)
  $email
  \$email
  \\$email
  \\\$email

��render为：

  foo
  $email
  \foo
  \\$email

如果email变量没有被定义则

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

��被render为：

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

注意�Q�VTL中未被定义的变量��被认�ؓ是一个字�W�串�Q�所以以下例子：

  #set( $foo = “gibbous�?)
  $moon = $foo

的输出结果是�Q?BR>

$moon = gibbous
Case substitution

现在你已�l�对reference比较熟悉了，你可以将他们高效的应用于你的template了。Velocity利用了很多java规范以方便了设计人员的��用。例如：

  $foo
  $foo.getBar()
  ## is the same as
  $foo.Bar

  $data.getUser(“jon�?
  ## is the same as
  $data.User(“jon�?

  $data.getRequest().getServerName()
  # is the same as
  $data.Request.ServerName
  ## is the same as
  ${data.Request.ServerName}

但是�Q�注意VTL中不会将reference解释为对象的实例变量。例如：$foo.Name��被解释为Foo对象的getName�Q�）�Ҏ��Q�而不是Foo对象的Name实例变量�?BR>Directives
Reference允许设计者��用动态的内容�Q�而directive使得你可以应用java代码来控制你的显�C�逻辑�Q�从而达��C��所期望的显�C�效果�?BR>#set
#set directive被用于设�|�一个reference的倹{��例如：
#set ( $primate = “monkey�?)
#set ( $customer.Behavior = $primate )
赋值左侧的�Q�LHS�Q�必��L��一个变量或者属性reference。右侧（RHS�Q�可以是以下�c�d��中一�U�：

l  变量reference
l  String literal
l  属性reference
l  �Ҏ��reference
l  number literal
l  ArrayList

下面是应用各�U�类型的RHS的例子：

  �Q�set ( $monkey = $bill ) ##变量reference
  �Q�set ( $monkey.Friend = “monica�?) ##String literal
  �Q�set ( $monkey.Blame = $whitehouse.Leak )##属性reference
  �Q�set ( $monkey.Plan = $spindoctor.weave($web) )##�Ҏ��reference
  �Q�set ( $monkey.Number = 123 )##Number literal
  �Q�set ( $monkey.Say = [“Not�? $my, “fault”] )##ArrayList

注意�Q�最后一个例子的取值方法�ؓ�Q?monkey.Say.get(0)
RHS也可以是一个简单的��术表达式：

  #set ( $value = $foo + 1 )
  #set ( $value = $bar -1 )
#set ( $value = $foo * $bar )
#set ( $value = $foo / $bar )

如果你的RHS是一个null�Q�VTL的处理将比较�Ҏ��Q�它��指向一个已�l�存在的reference�Q�这对初学者来讲可能是比较费解的。例如：

#set ( $resut = $query.criteria(“name�? )
  The result of the first query is $result

  #set ( $resut = $query.criteria(“address�? )
  The result of the second query is $result

如果$query.criteria(“name�?�q�回一个“bill”，�?query.criteria(“address�?�q�回的是null�Q�则昄��的结果如下：
The result of the first query is bill
The result of the first query is bill
看看下面的例子：

#set( $criteria = ["name", "address"] )
#foreach( $criterion in $criteria )
#set( $result = $query.criteria($criterion) )
  #if( $result )
  Query was successful
     #end
#end

在上面的例子中，�E�序��不能智能的�Ҏ��$result的值决定查询是否成功。在$result�?set后（added to the context�Q�，它不能被讄��回null�Q�removed from the context�Q�。打印的�l�果��显�C�Z��ơ查询结果都成功了，但是实际上有一个查询是��p�|的�?BR>��Z��解决以上问题我们可以通过预先定义的方式：
#set( $criteria = [“name�? “address”] )
#foreach( $criterion in $criteria )
#set( $result = false )
#set( $result = $query.criteria( $criterion ) )
#if( $result )
Query was successful
#end
#end
String Literals
当你使用#set directive�Q�String literal��闭在一对双引号内�?BR>#set ( $directoryRoot = “www�?)
#set ( $templateName = “index.vm�?)
#set ( $template = �?directoryRoot/$tempateName�?)
$template
上面�q�段代码的输出结果�ؓ�Q�www/index.vm
但是�Q�当string literal被封装在单引号内�Ӟ��它将不被解析�Q?BR>#set ( $foo = “bar�?)
$foo
#set ( $blargh = �?foo�?)
�l�果�Q?BR>bar
$foo
上面�q�个�Ҏ��可以通过修改velocity.properties文�g的stringliterals.interpolate = false的值来改变上面的特性是否有效�?BR>条�g语句
if/elseif/else
当一个web��面被生成时使用Velocity�?if directrive�Q�如果条件成立的话可以在��面内嵌入文字。例如：
#if ( $foo )
Velocity!
#end
上例中的条�g语句��在以下两种条�g下成立：
l $foo是一个boolean型的变量�Q�且它的��gؓtrue
l $foo变量的��g��为null
�q�里需要注意一点：Velocity context仅仅能够包含对象�Q�所以当我们说“boolean”时实际上代表的时一个Boolean对象。即便某个方法返回的是一个boolean��|��Velocity也会利用内省机制��它转换��Z��个Boolean的相同倹{�?BR>如果条�g成立�Q�那�?if�?end之间的内容将被显�C��?BR>#elseif�?else元素可以�?if一同��用。例如：

#if( $foo < 10 )
     Go North 
  #elseif( $foo == 10 )
     Go East 
  #elseif( $foo == 6 )
     Go South 
  #else
     Go West 
  #end

注意�q�里的Velocity的数字是作�ؓInteger来比较的――其他类型的对象��得条件�ؓfalse�Q�但是与java不同它��用“＝�Q�”来比较两个��|��而且velocity要求�{�号两边的值类型相同�?BR>关系、逻辑�q�算�W?
Velocity中��用等��h��作符判断两个变量的关�p�R��例如：

#set ( $foo = “deoxyribonucleic acid�?)
#set ( $bar = “ribonucleic acid�?)
#if ( $foo == $foo )
  In this case it’s clear they aren’t equivalent.So�?BR>#else
  They are not equivalent and this will be the output.
#end

Velocity有AND、OR和NOT逻辑�q�算�W�。下面是一些例子：
## logical AND
#if( $foo && $bar )
This AND that
#end

## logical OR
#if ( $foo || $bar )
This OR That
#end

##logical NOT
#if ( !$foo )
NOT that
#end
循环
Foreach循环
例子�Q?BR>

$product

每次循环$allProducts中的一个值都会赋�l?product变量�?BR>$allProducts可以是一个Vector、Hashtable或者Array。分配给$product的值是一个java对象�Q��ƈ且可以通过变量被引用。例如：如果$product是一个java的Product�c�，�q�且�q�个产品的名字可以通过调用他的getName�Q�）�Ҏ��得到�?BR>现在我们假设$allProducts是一个Hashtable�Q�如果你希望得到它的key应该像下面这��P��

Key: $key -> Value: $allProducts.get($key)

Velocity�q�特别提供了得到循环�ơ数的方法，以便你可以像下面�q�样作：

#foreach ( $customer in $customerList )

#end

$velocityCount

$customer.Name

$velocityCount变量的名字是Velocity默认的名字，你也可以通过修改velocity.properties文�g来改变它。默认情况下�Q�计��C��?”开始，但是你可以在velocity.properties讄��它是从�?”还是从�?”开始。下面就是文件中的配�|�：

# Default name of loop counter
  # variable reference
  directive.foreach.counter.name = velocityCount

  # Default starting value of the loop
  # counter variable reference
  directive.foreach.counter.initial.value = 1

include
#include script element允许模板设计者引入本地文件。被引入文�g的内容将不会通过模板引擎被render。�ؓ了安全的原因�Q�被引入的本地文件只能在TEMPLATE_ROOT目录下�?BR>#inclued ( “one.txt�?)
如果您需要引入多个文�Ӟ��可以用逗号分隔��p��Q?BR>#include ( “one.gif�? “two.txt�? “three.htm�?)
在括号内可以是文件名�Q�但是更多的时候是使用变量的：
#inclue ( “greetings.txt�? $seasonalstock )

parse
#parse script element允许模板设计者一个包含VTL的本地文件。Velocity��解析其中的VTL�q�render模板�?BR>#parse( “me.vm�?)
��像#include�Q?parse接受一个变量而不是一个模�ѝ��Q何由#parse指向的模杉K��必须包含在TEMPLATE_ROOT目录下。与#include不同的是�Q?parse只能指定单个对象�?BR>你可以通过修改velocity.properties文�g的parse_direcive.maxdepth的值来控制一个template可以包含的最�?parse的个数――默认值是10�?parse是可以递归调用的，例如�Q�如果dofoo.vm包含如下行：
Count down.
#set ( $count = 8 )
#parse ( “parsefoo.vm�?)
All done with dofoo.vm!
那么在parsefoo.vm模板中，你可以包含如下VTL�Q?BR>$count
#set ( $count = $count �?1 )
#if ( $count > 0 )
#parse( “parsefoo.vm�?)
#else
All done with parsefoo.vm!
#end
的显�C�结果�ؓ�Q?BR>Count down.
8
7
6
5
4
3
2
1
0
All done with parsefoo.vm!
All done with dofoo.vm!

Stop
#stop script element允许模板设计者停止执行模板引擎�ƈ�q�回。把它应用于debug是很有帮助的�?BR>#stop

Velocimacros
#macro script element允许模板设计者定义一�D�可重用的VTL template。例如：
#macro ( d )

#end
在上面的例子中Velocimacro被定义�ؓd�Q�然后你��可以在��M��VTL directive中以如下方式调用它：
#d()
当你的template被调用时�Q�Velocity��用替换�?d()�?BR>每个Velocimacro可以拥有��L��数量的参数――甚�?个参敎ͼ�虽然定义时可以随意设�|�参数数量，但是调用�q�个Velocimacro时必��L��定正��的参数。下面是一个拥有两个参数的Velocimacro�Q�一个参数是color另一个参数是array�Q?BR>#macro ( tablerows $color $somelist )
#foreach ( $something in $somelist )
$something
#end
#end

调用#tablerows Velocimacro�Q?BR>#set ( $greatlakes = [ “Superior�? “Michigan�? “Huron�? “Erie�? “Ontario�?] )
#set ( $color = “blue�?)

#tablerows( $color $greatlakes )

�l�过以上的调用将产生如下的显�C�结果：

Velocimacros可以在Velocity模板内实现行内定义（inline�Q�，也就意味着同一个web site内的其他Velocity模板不可以获得Velocimacros的定义。定义一个可以被所有模板共享的Velocimacro昄��是有很多好处的：它减��了在一大堆模板中重复定义的数量、节省了工作旉��、减��了出错的几率、保证了单点修改�?BR>上面定义�?tablerows( $color $list )Velocimacro被定义在一个Velocimacros模板�?在velocity.properties中定�?里，所以这个macro可以在�Q何规范的模板中被调用。它可以被多�ơ应用�ƈ且可以应用于不同的目的。例如下面的调用�Q?BR>#set ( $parts = [ “volva�? “stipe�? “annulus�? “gills�? “pileus�?] )
#set ( $cellbgcol = �?CC00FF�?)

#tablerows( $cellbgcol $parts )

上面VTL��生如下的输出�Q?BR>

Velocimacro arguments
Velocimacro可以使用以下��M��元素作�ؓ参数�Q?BR>l Reference�Q��Q何以$开头的reference
l String literal�Q?BR>l Number literal�Q?BR>l IntegerRange�Q�[1�?3]或者[$foo�?$bar]
l 对象数组�Q�[“a�?”b�?”c”]
l boolean��|��true、false
当将一个reference作�ؓ参数传递给Velocimacro�Ӟ��h��意reference作�ؓ参数时是以名字的形式传递的。这��意味着参数的值在每次Velocimacro内执行时才会被��生。这个特性��得你可以��一个方法调用作为参��C��递给Velocimacro�Q�而每�ơVelocimacro执行旉��是通过�q�个�Ҏ��调用产生不同的值来执行的。例如：
#macro ( callme $a )
$a $a $a
#end
#callme( $foo.bar() )
执行的结果是�Q�reference $foo的bar�Q�）�Ҏ��被执行了三次�?BR>如果你不需要这��L��Ҏ��可以通过以下�Ҏ��Q?BR>#set ( $myval = $foo.bar() )
#callme ( $myval )

Velocimacro properties
Velocity.properties文�g中的某几行能够��Velocimacros的实现更加灵�z�R��注意更多的内容可以看Developer Guide�?BR>Velocity.properties文�g中的velocimacro.libraary�Q�一个以逗号分隔的模板库列表。默认情况下�Q�velocity查找唯一的一个库�Q�VM_global_library.vm。你可以通过配置�q�个属性来指定自己的模板库�?BR>Velocity.properties文�g中的velocimacro.permissions.allow.inline属性：有两个可选的值true或者false�Q�通过它可以确定Velocimacros是否可以被定义在regular template内。默认值是ture――允许设计者在他们自己的模板中定义Velocimacros�?BR>Velocity.properties文�g中的
velocimacro.permissions.allow.inline.replace.global属性有两个可选值true和false�Q�这个属性允�怋�用者确定inline的Velocimacro定义是否可以替代全局Velocimacro定义�Q�比如在velocimacro.library属性中指定的文件内定义的Velocimacro�Q�。默认情况下�Q�此��gؓfalse。这样就��L��本地Velocimacro定义覆盖全局定义�?BR>Velocity.properties文�g中的
velocimacro.permissions.allow.inline.local.scale属性也是有true和false两个可选��|��默认是false。它的作用是用于��定你inline定义的Velocimacros是否仅仅在被定义的template内可见。换句话��_��如果�q�个属性设�|��ؓtrue�Q�一个inline定义的Velocimacros只能在定义它的template内��用。你可以使用此设�|�实��C��个奇妙的VM敲门�Q�a template can define a private implementation of the second VM that will be called by the first VM when invoked by that template. All other templates are unaffected�?BR>Velocity.properties文�g中的velocimacro.context.localscope属性有true和false两个可选��|��默认��gؓfalse。当讄��为true�Ӟ��M��在Velocimacro内通过#set()对context的修改被认�ؓ是针�Ҏ��velocimacro的本地设�|�，而不会永久的影响内容�?BR>Velocity.properties文�g中的velocimacro.library.autoreload属性控制Velocimacro库的自动加蝲。默认是false。当讄��为ture�Ӟ��对于一个Velocimacro的调用将自动��查原始库是否发生了变化，如果变化��重新加载它。这个属性��得你可以不用重新启动servlet容器而达到重新加载的效果�Q�就像你使用regular模板一栗��这个属性可以��用的前提��是resource loader�~�存是off状态（file.resource.loader.cache = false�Q�。注意这个属性实际上是针对开发而非产品的�?BR>
Velocimacro Trivia
Velocimacro必须被定义在他们被��用之前。也��是��_��你的#macro()声明应该出现在��用Velocimacros之前�?BR>特别要注意的是，如果你试�?parse()一个包�?macro()的模�ѝ��因�?parse()发生在运行期�Q�但是解析器在parsetiem军_��一个看似VM元素的元素是否是一个VM元素�Q�这�?parse()-ing一�l�VM声明��不按照预期的样子工作。�ؓ了得到预期的�l�果�Q�只需要你��单的使用velocimacro.library使得Velocity在启动时加蝲你的VMs�?BR>Escaping VTL directives
VTL directives can be escaped with “\”号�Q��用方式跟VTL的reference使用逃逸符的格式差不多�?BR>## #include( “a.txt�?) renders as (注释�?
#include( “a.txt�?)

## \#include( “a.txt�?) renders as \#include( “a.txt�?)
\#include( “a.txt�?)

## \\#include ( “a.txt�?) renders as \
\\#include( “a.txt�?)
在对在一个directive内包含多个script元素的VTL directives使用逃逸符时要特别��心�Q�比如在一个if-else-end statement内）。下面是VTL的if-statement的典型应用：
#if ( $jazz )
Vyacheslav Ganelin
#end
如果$jazz是ture�Q�输出将是：
Vyacheslav Ganelin
如果$jazz是false�Q�将没有输出。��用逃逸符��改变输出。考虑一下下面的情况�Q?BR>\#if ( $jazz )
Vyacheslav Ganelin
\#end
现在无论$jazz是true�q�是false�Q�输出结果都是：
#if ( $jazz )
Vyacheslav Ganelin
#end
事实上，�׃��你��用了逃逸符�Q?jazz�Ҏ��没有被解析为boolean型倹{��在逃逸符前��用逃逸符是合法的�Q�例如：
\\#if ( $jazz )
Vyacheslav Ganelin
\\#end
以上�E�序的显�C�结果�ؓ�Q?BR>\ Vyacheslav Ganelin
但是如果$jazz为false�Q�那么将没有输出。（书上说会没有输出�Q�但是我觉得应该�q�有有“\”字�W�被输出。）
VTL�Q�Formatting issues
��管在此用户手册中VTL通常都开始一个新行，如下所�C�：
#set ( $imperial = [ “Munetaka�? “Koreyasu�? “Hisakira�? “Morikune�?] )
#foreach ( $shogun in $imperial )
$shogun
#end
但是像下面这�U�写法也是可以的�Q?BR>Send me #set($foo = [�?10 and�?”a cake”])#foreach($a in $foo)$a #end please.
上面的代码可以被改写为：
Send me
#set ( $foo = [�?10 and �?”a cake”] )
#foreach ( $a in $foo )
$a
#end
please.
或�?BR>Send me
#set($foo = [�?10 and �?”a cake”])
#foreach �Q?a in $foo �Q?a
#end please.
�q�两�U�的输出�l�构��一栗��?BR>其他�Ҏ��和杂项
math 在模板中可以使用Velocity内徏的算术函敎ͼ�如：加、减、乘、除
#set ( $foo = $bar + 3 )
#set ( $foo = $bar - 4 )
#set ( $foo = $bar * 6 )
#set ( $foo = $bar / 2 )
当执行除法时��返回一个Integer�c�d��的结果。而余��C��可以使用%来得刎ͼ�
#set ( $foo = $bar % 5 )
在Velocity内��用数学计��公式时�Q�只能��用像-n,-2,-1,0,1,2,n�q�样的整敎ͼ�而不能��用其它类型数据。当一个非整型的对象被使用时它��被logged�q�且��以null作�ؓ输出�l�果�?BR>Range Operator
Range operator可以被用于与#set�?foreach statement联合使用。对于处理一个整型数�l�它是很有用的，Range operator��h��以下构造�Ş式：
[n..m]
m和n都必��L��整型�Q�而m是否大于n则无关紧要。例子：
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

Fourth example:
[1..3]
上面四个例子的输出结果�ؓ�Q?BR>First example�Q?BR>1 2 3 4 5

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

Third example�Q?BR>0 1

Fourth example�Q?BR>[1..3]
注意�Q�range operator只在#set�?foreach中有效�?BR>Advanced Issue�Q�Escaping and�Q?BR>当一个reference被“！”分隔时�Q��ƈ且在它之前有逃逸符�Ӟ��reference��以�Ҏ��的方式处理。注意这�U�方式与标准的逃逸方式时不同的。对照如下：
#set ( $foo = “bar�?)
�Ҏ��形式标准格式
Render�?Render�?Render�?Render�?BR>$\!foo $!foo \$foo \$foo
$\!{foo} $!{foo} \$!foo \$!foo
$\\!foo $\!foo \$!{foo} \$!{foo}
$\\\!foo $\\!foo \\$!{foo} \bar
Velocimacro杂记
Can I user a directive or another VM as an argument to a VM?
例如�Q?center ( #bold( “hello�?) )
不可以。一个directive的参��C��用另外一个directive是不合法的�?BR>但是�Q�还是有些事情你可以作的。最��单的方式��是使用双引��P��
#set ( $stuff = �?bold( ‘hello�?)�?)
#center ( $stuff )
上面的格式也可以�~�写��Z��行：
#center ( �?bold( ‘hello�?) )
��h��意在下面的例子中参数被evaluated在Velocimacro内部�Q�而不是在calling level。例子：
#macro ( inner $foo )
inner : $foo
#end

#macro ( outer $foo )
#set ( $bar = “outerlala�?)
outer : $foo
#end

#set ( $bar = ‘calltimelala�?)
#outer( �?inner($bar)�?)
输出�l�果为：
outer : inner : outerlala
��C��Veloctiy的特性：参数的传递是By Name的。例如：
#macro ( foo $color )
Hi
There
#end

#foo ( $bar.rowColor() )
以上代码��导致rowColor()�Ҏ��两次调用�Q�而不是一�ơ。�ؓ了避免这�U�现象的出现�Q�我们可以按照下面的方式执行�Q?BR>#set ( $color = $bar.rowColor() )
#foo ( $color )
can I register velocimacros via #parse()?
目前�Q�Velocimacros必须在第一�ơ被模板调用前被定义。这��意味着你的#macro()声明应该出现在��用Velocimacros之前�?BR>如果你试�?parse()一个包�?macro() directive的模板，�q�一�Ҏ��需要牢记的。因�?parse()发生在运行期�Q�但是解析器在parsetiem军_��一个看似VM元素的元素是否是一个VM元素�Q�这�?parse()-ing一�l�VM声明��不按照预期的样子工作。�ؓ了得到预期的�l�果�Q�只需要你��单的使用velocimacro.library使得Velocity在启动时加蝲你的VMs�?BR>What is velocimacro autoreloading�Q?
velocimacro.library.autoreload是专门�ؓ开发而非产品使用的一个属性。此属性的默认值是false�?BR>String concatenation
开发�h员最帔R��的问题是我如何作字符拼接�Q�在java中是使用“＋”号来完成的�?BR>在VTL里要惛_��现同��L��功能你只需要将需要联合的reference攑ֈ�一起就行了。例如：

#set ( $size = “Big�?)
#set ( $name = “Ben�?)
The clock is $size$name.

输出�l�果��是�Q�The clock is BigBen.。更有趣的情冉|��Q?BR>

#set ( $size = “Big�?)
  #set ( $name = “Ben�?)
  #set ( $clokc = �?size$name�?)
  The clock is $clock.

上例也会得到同样的结果。最后一个例子，当你希望混合固定字段��C��的reference�Ӟ��你需要��用标准格式：

#set ( $size = “Big�?)
  #set ( $name = “Ben�?)
  #set ( $clock = �?{size}Tall$name�?)
  The clock is $clock.

输出�l�果是：The clock is BigTallBen.。��用这�U�格式主要是��Z��使得$size不被解释�?sizeTall�?/DIV>

�?/a> 2005-07-30 22:32 发表评论

Velocity��?---- from matrix

Sat, 30 Jul 2005 14:31:00 GMT

1.Velocity 的��?

Velocity是一个开放源吗的模版引擎�Q�由apache.org��组负责开发，现在最新的版本是Velocity1.3.1�Q�http://jakarta.apache.org/velocity/index.html 可以了解Velocity的最��C��息�?
Velocity允许我们在模版中讑֮�变量�Q�然后在�q�行�Ӟ��动态的��数据插入到模版中，替换�q�些变量�?
例如�Q?

 
HELLO $CUSTOMERNAME

我们可以在运行时得到客户的名字，然后把它插入到这个模版中替换变量$CUSTOMERNAME�Q�整个替换过�E�是由Velocity�q�行控制的，而且java的调用代码也非常��单，如我们可以在java代码中这栯��?

/***********************************************************/ 
//�q�个文�g中设定了Velocity使用的log4j的配�|�和Velocity的模版文件所在的目录 
Velocity.init("D:\\Template\\resource\\jt.properties"); 
//模版文�g名，模版文�g所在的路径在上一条语句中已经讄����?
Template template = Velocity.getTemplate("hello.vm", "gb2312"); 
//实例化一个Context 
VelocityContext context = new VelocityContext(); 
//把模版变量的��D���|�到context�?
context.put("CUSTOMERNAME", "My First Template Engine ---- Velocity."); 
//开始模版的替换 
template.merge(context, writer); 
//写到文�g�?
PrintWriter filewriter = new PrintWriter(new FileOutputStream(outpath),true); 
filewriter.println(writer.toString()); 
filewriter.close(); 
/***********************************************************/

�q�就是整个java的代码，非常的简单。如果我们有多个模版变量�Q�我们仅需要把�q�些模版变量的��D��|�到context中�?
下面我们��单的分析一下，Velocity引擎��d��模板文�g�Ӟ��它直接输出文件中所有的文本�Q�但�?字符开头的除外�Q?�W�号标识着一个模版变量位�|�，
context.put("CUSTOMERNAME", "My First Template Engine ---- Velocity.");
�?Velocity 模板引擎解析�q�输出模板的�l�果�Ӟ��模板中所有出�?CUSTOMERNAME的地斚w��插入客��L��名字�Q�即被加入到VelocityContext的对象的toString()�Ҏ��q�回值将替代Velocity变量�Q�模板中�?开头的变量�Q��?
模板引擎中最强大、��用最频繁的功能之一是它通过内徏的映像（Reflection�Q�引擎查扑֯�象信息的能力。这个映像引擎允许用一�U�方便的Java�?”类似的操作�W�，提取��L��加入到VelocityContext的对象的��M��公用�Ҏ��的��|��或对象的��L��数据成员�?
映像引擎�q�带来了另外一个改�q�：快速引用JavaBean的属性。��用JavaBean属性的时候，我们可以忽略get�Ҏ��和括受��请看下面这个模板的例子�?

 
 
Name:$Customer.Name() 
Address:$Customer.Address() 
Age:$Customer.Age()

java的代码：

/***********************************************************/ 
//讄���客户信息 
Customer mycustomer = new Customer(); 
mycustomer.setName("Velocity"); 
mycustomer.setAddress("jakarta.apache.org/velocity/index.html"); 
mycustomer.setAge(2); 
//�q�个文�g中设定了 Velocity 使用�?Log4j 的配�|�和Velocity的模版文件所在的目录Velocity.init("D:\\Template\\resource\\jt.properties"); 
//模版文�g名，模版文�g所在的路径在上一条语句中已经讄����?
Template template = Velocity.getTemplate("hello.vm", "gb2312"); 
//实例化一个Context 
VelocityContext context = new VelocityContext(); 
//把模版变量的��D���|�到context�?
context.put("Customer", mycustomer); 
//开始模版的替换 
template.merge(context, writer); 
//写到文�g�?
PrintWriter filewriter = new PrintWriter(new FileOutputStream(outpath),true); 
filewriter.println(writer.toString()); 
filewriter.close();

输出�l�果�Q?

 
 
Name:Velocity 
Address:jakarta.apache.org/velocity/index.html 
Age:2

除了替换变量之外�Q�象Velocity高��引擎�q�能做其他许多事情，它们有用来比较和�q�代的内建指令，通过�q�些指��o我们可以完成�E�序语言中的条�g判断语句和��@环语句等�?
例如�Q�我们想要输出年龄等�?的所有客��L��信息�Q�我们可以这样定义我们的模版
模版�Q?

 
 






#foreach ($Customer in $allCustomer) 
#if($Customer.Age()=="2") 





#end 
#end 
  名称  地址  �q�龄  
  $Customer.Name()  $Customer.Address()  $Customer.Age()

java的代码：

/******************************************************/ 
//讄���客户信息 
ArrayList allMyCustomer = new ArrayList(); 
//客户1 
Customer mycustomer1 = new Customer(); 
mycustomer1.setName("Velocity"); 
mycustomer1.setAddress("jakarta.apache.org/velocity/index.html"); 
mycustomer1.setAge(2); 
//客户2 
Customer mycustomer2 = new Customer(); 
mycustomer2.setName("Tomcat"); 
mycustomer2.setAddress("jakarta.apache.org/tomcat/index.html"); 
mycustomer2.setAge(3); 
//客户3 
Customer mycustomer3 = new Customer(); 
mycustomer3.setName("Log4J"); 
mycustomer3.setAddress("jakarta.apache.org/log4j/docs/index.html"); 
mycustomer3.setAge(2); 
//��d��到allMyCustomer(ArrayList)�? 
allMyCustomer.add(mycustomer1); 
allMyCustomer.add(mycustomer2); 
allMyCustomer.add(mycustomer3); 
//�q�个文�g中设定了Velocity使用的log4j的配�|�和Velocity的模版文件所在的�?
Velocity.init("D:\\Template\\resource\\jt.properties"); 
//模版文�g名，模版文�g所在的路径在上一条语句中已经讄����?
Template template =Velocity.getTemplate("hello.vm", "gb2312"); 
//实例化一个Context 
VelocityContext context = new VelocityContext(); 
/** 注意�q�里我们仅仅需要给一个模版变量负�?*/ 
context.put("allCustomer", allMyCustomer); 
//开始模版的替换 
template.merge(context, writer); 
//写到文�g�?
PrintWriter filewriter = new PrintWriter(new FileOutputStream(outpath),true); 
filewriter.println(writer.toString()); 
filewriter.close(); 
/******************************************************/

�l�果�Q?

 
 
















  名称  地址  �q�龄  
  Velocity  jakarta.apache.org/velocity/index.html  2  
  Log4J  jakarta.apache.org/log4j/docs/index.html  2

#if 语句完成逻辑判断�Q�这个我想不用多说了�?
allCustomer对象包含零个或者多个Customer对象。由于ArrayList (List, HashMap, HashTable, Iterator, Vector�{?属于Java Collections Framework的一部分�Q�我们可以用#foreach指��o�q�代其内宏V��我们不用担心如何定型对象的�c�d��——映像引擎会为我们完成这个�Q务�?foreach指��o的一般格式是�?foreach in ”�?foreach指��o�q�代list�Q�把list中的每个元素攑օ�item参数�Q�然后解�?foreach块内的内宏V��对于list内的每个元素�Q?foreach块的内容都会重复解析一�ơ。从效果上看�Q�它相当于告诉模板引擎说�Q�“把list中的每一个元素依�ơ放入item变量�Q�每�ơ放入一个元素，输出一��?foreach块的内容”�?

2.MVC设计模型

使用模板引擎最大的好处在于�Q�它分离了代码（或程序逻辑�Q�和表现�Q�输出）。由于这�U�分��，你可以修改程序逻辑而不必担心邮件消息本�w�；�c�M��圎ͼ�你（或公关部门的职员�Q�可以在不重新编译程序的情况下，重新�~�写客户列表。实际上�Q�我们分��M��pȝ��的数据模式（Data Model�Q�即提供数据的类�Q�、控制器�Q�Controller�Q�即客户列表�E�序�Q�以及视图（View�Q�即模板�Q�。这�U�三层体�pȝ��为Model-View-Controller模型�Q�MVC�Q��?
如果遵从MVC模型�Q�代码分成三个截然不同的层，��化了软�g开发过�E�中所有相关�h员的工作�?
�l�合模板引擎使用的数据模式可以是��M��Java对象�Q�最好是使用Java Collection Framework的对象。控制器只要了解模板的环境（如VelocityContext�Q�，一般这�U�环境都很容易��用�?
一些关�p�L��据库的“对�?关系”映��工兯��够和模板引擎很好地协同，��化JDBC操作�Q�对于EJB�Q�情形也�c�M��?模板引擎与MVC中视图这一部分的关�p�L��为密切。模板语�a�的功能很丰富、强大，��以处理所有必需的视囑֊�能，同时它往往很简单，不熟悉编�E�的��Z��可以使用它。模板语�a�不仅使得设计者从�q�于复杂的编�E�环境中解脱出来�Q�而且它保护了�pȝ��Q�避免了有意或无意带来危险的代码。例如，模板的编写者不可能�~�写出导致无限��@环的代码�Q�或侵占大量内存的代码。不要轻估这些安全机制的价��|��大多数模板编写者不懂得�~�程�Q�从长远来看�Q�避免他们接触复杂的�~�程环境相当于节省了你自��q��旉��?许多模板引擎的用��L��信，在采用模板引擎的�Ҏ��中，控制器部分和视图部分的明��分��，再加上模板引擎固有的安全机制�Q��得模板引擎��以成为其他内容发布系�l�（比如JSP�Q�的替代�Ҏ��。因此，Java模板引擎最常见的用途是替代JSP也就不��为奇了�?

3.HTML处理

�׃��Z��L��看重模板引擎用来替换JSP的作用，有时他们会忘记模板还有更�q�泛的用途。到目前为止�Q�模板引擎最常见的用途是处理HTML Web内容。但我还用模板引擎生成过SQL、email、XML甚至Java源代码�?/DIV>

�?/a> 2005-07-30 22:31 发表评论

Velocity 的工作原�?--from matrix

Sat, 30 Jul 2005 14:28:00 GMT

�q�个�E�序很简单，但是它能让你清楚的了�?Velocity 的基本工作原理。程序中其他部分基本上很固定�Q�最主要的部分在以下代码

　　�q�里 Velocity 获取模板文�g�Q�得到模板引�?BR>
/* next, get the Template */
Template t = ve.getTemplate( "hellosite.vm" );

　　�q�里�Q�初始化环境�Q��ƈ��数据放入环�?BR>
/* create a context and add data */

VelocityContext context = new VelocityContext();

context.put("name", "Eiffel Qiu");

context.put("site", "http://www.eiffelqiu.com");

　　其他代码比较固定�Q�但是也非常重要�Q�但是对于每个应用来说写法都很相同：
�q�是初始�?Velocity 模板引擎

/* first, get and initialize an engine */

VelocityEngine ve = new VelocityEngine();
ve.init();

　　�q�是用来��环境变量和输出部分�l�合�?BR>
StringWriter writer = new StringWriter();
t.merge( context, writer );
/* show the World */
System.out.println( writer.toString() );

　　��C��Q�这在将来的 servlet 应用中会有所区别�Q�因为网��输出�ƈ不和命��o行输出相同，如果用于�|�页输出�Q�将�q�不通过 System.out 输出。这会在以后的教�E�中�l�大家解释的�?BR>
那让我来�ȝ��一�?Velocity 真正的工作原理：
　　Velocity 解决了如何在 Servlet 和网��之间传递数据的问题�Q�当然这�U�传输数据的机制是在 MVC 模式上进行的�Q�也��是View �?Modle , Controller 之间�怺�独立工作�Q�一方的修改不媄响其他方变动�Q�他们之间是通过环境变量�Q�Context�Q�来实现的，当然双方�|�页制作一方和后台�E�序一方要�怺��U�定好对所传递变量的命名�U�定�Q�比如上个程序例子中�?site, name 变量�Q�它们在�|�页上就�?$name ,$site 。这样只要双方约定好了变量名字，那么双方��可以独立工作了。无论页面如何变化，只要变量名不变，那么后台�E�序��无需改动�Q�前台网��也可以��L��q��制作�h员修攏V��这��是 Velocity 的工作原理�?BR>
　　你会发现��单变量名通常无法满��|�页制作昄��数据的需要，比如我们�l�常会��@环显�C�Z��些数据集�Q�或者是�Ҏ��一些数据的值来军_��如何昄��下一步的数据�Q?Velocity 同样提供了��@环，判断的简单语法以满��|�页制作的需要。Velocity 提供了一个简单的模板语言以供前端�|�页制作人员使用�Q�这个模板语�a��_��单（大部分懂�?javascript 的�h��可以很快掌握，其实它比 javascript 要简单的多）�Q�当然这�U�简单是��L��的，因�ؓ它不需要它什么都能做�Q?View 层其实不应该包含更多的逻辑�Q�Velocity 的简单模板语法可以满��你所有对��面昄��逻辑的需要，�q�通常已经��_��了，�q�里不会发生�?jsp 那样因�ؓ一个无限��@环语句而毁掉系�l�的情况�Q�jsp 能做很多事情�Q�Sun 在制�?Jsp 1.0 标准的时候，没有及时的限定程序员�?jsp 插入代码逻辑�Q��得早期的jsp 代码更象�?php 代码�Q�它虽然强大�Q�但是对昄��层逻辑来说�Q��ƈ不必要，而且会�� MVC 三层的逻辑�l�构发生��h��?BR>
我的�|�站�Q?http://www.eiffelqiu.com
Email�Q?eiffelqiu@163.com
希望和大家交��?BR>
出处�Q�牧��h手记

�?/a> 2005-07-30 22:28 发表评论

velocity 的介�l?------from matrix jdyao

Sat, 30 Jul 2005 14:26:00 GMT

Velocity 是如何工作的呢？虽然大多 Velocity 的应用都是基�?Servlet 的网��制作。但是�ؓ了说�?Velocity 的��用，我决定采用更通用�?Java application 来说明它的工作原理�?BR>
　　��g��所有语�a�教学的开头都是采�?HelloWorld 来作为第一个程序的�C�Z��。这里也不例外�?BR>
　　��M�� Velocity 的应用都包括两个斚w��:
　　�W�一是：模板制作�Q�在我们�q�个例子中就�?hellosite.vm:
　　它的内容如下�Q�虽然不是以 HTML ��Z��Q�但是这很容易改成一�?html 的页面）

Hello $name! Welcome to $site world!

　　�W�二�?Java �E�序部分�Q?BR>　　下面�?Java 代码

import java.io.StringWriter;
import org.apache.velocity.app.VelocityEngine;
import org.apache.velocity.Template;
import org.apache.velocity.VelocityContext;

public class HelloWorld
{
public static void main( String[] args )
throws Exception
{
/* first, get and initialize an engine */

VelocityEngine ve = new VelocityEngine();
ve.init();

/* next, get the Template */

Template t = ve.getTemplate( "hellosite.vm" );

/* create a context and add data */

VelocityContext context = new VelocityContext();

context.put("name", "Eiffel Qiu");

context.put("site", "http://www.eiffelqiu.com");

/* now render the template into a StringWriter */

StringWriter writer = new StringWriter();

t.merge( context, writer );

/* show the World */

System.out.println( writer.toString() );
}
}

��两个文件放在同一个目录下�Q�编译运行，�l�果是：

Hello Eiffel Qiu! Welcome to http://www.eiffelqiu.com world

　　��Z��保证�q�行��利�Q�请�?Velocity 的网�?http://jakarta.apache.org/velocity/ 上下�?Velocity 的运行包�Q�将其中�?Velocity Jar 包的路径攑֜��pȝ��?Classpath 中，�q�样��可以编译和�q�行以上的程序了�?BR>
出处�Q�牧��h手记

�?/a> 2005-07-30 22:26 发表评论

名称	地址	�q�龄
$Customer.Name()	$Customer.Address()	$Customer.Age()

亚洲国产综合精品一区在线播放,亚洲午夜AV无码专区在线播放,亚洲国产成人无码AV在线

Velocity����?---- from matrix

Velocity 的工作原�?--from matrix

velocity 的介�l?------from matrix jdyao

Velocity��?---- from matrix