asdtiang — Tue, 12 Jan 2010 10:02:00 GMT

一。插件Veloeclipse 的安装：

声明�Q�myeclipse版本�Q?.5

在Eclipse的Help->Software Updates->Find and Install..->Search for new features to install�Q?/p>

点击“new Remote Site...”�Q�增�?Veloeclipse�Q��|��http://propsorter.sourceforge.net/veloeclipse�Q?/p>

�|�上都说是这个链接，但是��L��报错�Q?/p>

“ Veloeclipse (2.0.6) requires plug-in "org.eclipse.equinox.p2.ui (1.0.1)", or compatible.”

我英语很差，不太明白什么意思！哈哈�Q?font color="#ff0000">希望�? �q�篇文章且会��p��的�h�l�留个言�Q�翻译下�Q?/p>

�|�上的解释说�Q�veloeclipse插�g和eclipse版本不兼宏V��我��L��了大量的国外 �|�站�Q�有一个�h说是�Q�veloeclipse插�g的下载主��|��啦，需要新的链接地址�Q?/p>

http://veloeclipse.googlecode.com/svn/trunk/update/

于是url重新输入�q�个�Q�结果就正常啦！

然后选择Veloeclipse�Q�next后，会列出在�|�站上可以安装的features�Q? 选择Veloeclipse�Q�版本是2.0.2�Q?/p>

剩下的就是根据提�C�往下安装即可完成，完成后提�C�需要重启eclipse�Q�选择重启�?/p>

http://code.google.com/p/veloeclipse/

二。插件Veloeclipse的��用：

插�gVeloeclipse�Q�Velocity+Html 的编辑工��P��除了提供不同颜色昄��velocity和html的语法外�Q�还提供�Ҏ��velocity和html的tag自动寚w��Q�tag和标�{��自动提示 �{�，真是开发社团里有什么需求，��有什么开源的东东出来满��Q�这玩意值得一看，以挖掘看看有什么新鲜东�ѝ�?/p>

工具�Ҏ��：
    1�Q�用戯��定义模版
    2�Q�根据velocity的vtl和html的标�{�进行自动羃�q?br />     3�Q�语法高亮显�C?br />     4�Q�html标签和velocity语句的自动完成提�C�和内容帮助�Q?br />     5�Q�html预览
    6�Q��?ctrl+alt+鼠标点击 html的结束标�{�（如）或velocity的结束语句（�?end�Q�，可以跌��到对应开始的语句�Q�此外鼠标停留在�l�束标签上方�Ӟ��也会有提�C�指明该对应的开始语句在哪一行�?br />     7�Q��用Ctrl+alt+鼠标点击html标签�Q?可打开对应的标�{�ָ�助�?br />      Remark�Q�第6�Q�和7�Q�中的快��h��式在标准介绍中是用ctrl+鼠标点击�Q�但ctrl+鼠标点击已有其他应用占用了，试验发现需多加alt�?/p>

asdtiang 2010-01-12 18:02 发表评论

asdtiang — Tue, 12 Jan 2010 10:01:00 GMT

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�行开发�?

Velocity能�ؓ我们作什么？
The Mud Store Example
假设你是一家专门出售Mud的在�U�商店的��面设计人员�Q�让我们暂且�U�它�?#8220;在线MUD商店”。你们的业务很旺�Q�客户下了各�U�类型和数量的mud订单。他�? 都是通过输入用户名和密码后才登陆��C��的网站，登陆后就允许他们查看订单�q�购买更多的mud。现在，一�U�非常流行的mud正在打折销售。另外有一些客戯�� 律性的购买另外一�U�也在打折但是不是很��行的Bright Red Mud�Q�由于购买的人�ƈ不多所以它被安�|�在��面的边�~�。所有用��L��信息都是被跟�t��ƈ存放于数据库中的�Q�所以某天有一个问题可能会冒出来：��Z��么不使用 velocity来��用户更好的浏览他们感兴趣的商品呢�Q?
Velocity使得web��面的客户化工作非常�Ҏ��。作��Z��个web site的设计�h员，你希望每个用��L��陆时都拥有自��q��面�?
你会见了一些公司内的��Y件工�E�师�Q�你发现他们每个人都同意客户应该拥有��h��个性化的信息。那让我们把软�g工程师应该作的事情发在一边，看一看你应该作些什么吧�?

VTL意味着提供最��单、最�Ҏ��q�且最整洁的方式合�q��面动态内宏V�?
VTL使用references来在web site内嵌套动态内容，一个变量就是一�U�类型的reference。变量是某种�c�d��的refreence�Q�它可以指向java代码中的定义�Q�或者从当前 ��面内定义的VTL statement得到倹{��下面是一个VTL statement的例子，它可以被嵌套到HTML代码中：

Java代码

#set ( $a = “Velocity” );

#set ( $a = “Velocity” );

和所有的VTL statement一��P��q�个statement以＃字符开始�ƈ且包含一个directive�Q�set。当一个在�U�用戯��求你的页面时�Q�Velocity Templating Engine��查询整个页面以便发现所有＃字符�Q�然后确定哪些是VTL statement�Q�哪些不需要VTL作�Q何事情�?
�Q�字�W�后紧跟一个directive�Q�set�Ӟ��q�个set directive使用一个表辑ּ��Q��用括号封闭）――一个方�E�式分配一个值给变量。变量被列在左边�Q�而它的��D��列在双��Q�最后他们之间��用＝号分剌Ӏ?
在上面的例子中，变量�?a�Q�而它的值是Velocity。和其他的references一样以$字符开始，而值��L��以双引号��闭。Velocity中仅有String可以被赋值给变量�?
��C��以下的规则：
使用$字符开始的references用于得到什么；使用#字符开始的directives用于作些什么�?
Hello Velocity World!
一旦某个变量被分配了一个��|��那么你就可以在HTML文�g的�Q何地方引用它。在下面的例子中�Q�一个��D��分配�l?foo变量�Q��ƈ在其后被引用�?

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

上面的实现结果是在页面上打印“Hello Velocity World�Q?#8221;
��Z��使包含VTL directives的statement更具有可��L��，我们鼓励你在新行开始每个VTL statement�Q�尽��你不是必须�q�么作。Set directive��在后面详细描述�?
注释
单行注释�Q?
## This is a single line comment.
多行注释�Q?
#*
   Thus begins a multi-line comment. Online visitors won’t
   see this text because the Velocity Templating Engine will
ignore it.
*#
文档格式�Q?
#**
   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中��用它们�?
Everything coming to and from a reference被作��Z��个String对象处理。如果有一个对�?foo是一个Integer对象�Q�那么Velocity��调用它�? toString()�Ҏ��这个对象�{型�ؓString�c�d��?
变量
格式要求同java�?
属�?
例子�Q?
    $customer.Address
    $purchase.Total
$customer.Address有两�U�含义。它可以表示�Q�查找hashtable对象customer中以Address为关键字的��|��也可以表�C�� 用customer对象的getAddress()�Ҏ��。当你的��面被请求时�Q�Velocity��确定以上两�U�方式选用那种�Q�然后返回适当的倹{�?
�Ҏ��
一个方法就是被定义在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ȝ��话，那你是正��的�?
VTL属性可以作为VTL�Ҏ��的羃写�?customer.Address属性和使用$customer.getAddress()�Ҏ��h��相同的效果�? 如果可能的话使用属性的方式是比较合理的。属性和�Ҏ��的不同点在于你能够给一个方法指定一个参数列表�?
正式reference标记
reference的正是格式如下：
${mudSlinger}        变量
${customer.Address}    属�?
${purchase.getTotal()}    �Ҏ��
非正是格式更见常用，但是有时�q�是使用正是格式比较适合。例如：你希望通过一个变�?vice来动态的�l�织一个字�W�串�?
Jack is a $vicemaniac.
本来变量�?vice现在却变成了$vicemaniac�Q�这样Veloctiy��׃��知道您到底要什么了。所以，应该使用正是格式书写
Jack is a ${vice}maniac
现在Velocity知道变量�?vice而不�?vicemaniac�?
Quiet reference notation
例如�Q?

当页面的form被初始加载时�Q�变�?email�q�没有��|��q�时你肯定是希望它能够显�C�Z��个blank text来代替输�?#8221;$email”�q�样的字�D�c��那么��用quiet reference notation��比较合适�?

�q�样文本框的初始值就不会是email而是�I��g��?
正式和quiet格式的reference notation也可一同��用，像下面这��P��

Getting literal
Velocity使用�Ҏ��字符$�?来帮助它工作�Q�所以如果要在template里��用这些特�D�字�W�要格外��心。本节将讨论$字符�?
货币字符
在VTL中��?2.5�q�样的货币标识是没有问题得的�Q�VTL不会��它错认为是一个reference�Q�因为VTL中的reference��L��以一个大�? 或者小写的字母开始�?
Escaping valid VTL reference
VTL中��?#8220;\”作�ؓ逃逸符�?
例如�Q?
#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?
$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实例变量�?
Directives
Reference允许设计者��用动态的内容�Q�而directive使得你可以应用java代码来控制你的显�C�逻辑�Q�从而达��C��所期望的显�C�效果�?
#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�回一�?#8220;bill”�Q��?query.criteria(“address”)�q�回的是null�Q? 则显�C�的�l�果如下�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�|的�?
��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��闭在一对双引号内�?
    #set ( $directoryRoot = “www” )
    #set ( $templateName = “index.vm” )
    #set ( $template = “$directoryRoot/$tempateName” )
    $template
上面�q�段代码的输出结果�ؓ�Q�www/index.vm
但是�Q�当string literal被封装在单引号内�Ӟ��它将不被解析�Q?
    #set ( $foo = “bar” )
    $foo
    #set ( $blargh = ‘$foo’ )
�l�果�Q?
    bar
    $foo
上面�q�个�Ҏ��可以通过修改velocity.properties文�g的stringliterals.interpolate = false的值来改变上面的特性是否有效�?
条�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�所以当我们�?#8220;boolean”时实际上代表的时一个Boolean对象。即便某个方法返回的是一个boolean ��|��Velocity也会利用内省机制��它转换��Z��个Boolean的相同倹{�?
如果条�g成立�Q�那�?if�?end之间的内容将被显�C��?
#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不同它��?#8220;�Q�＝”来比较两�? ��|��而且velocity要求�{�号两边的值类型相同�?
关系、逻辑�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…
#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?

$product

每次循环$allProducts中的一个值都会赋�l?product变量�?
$allProducts可以是一个Vector、Hashtable或者Array。分配给$product的值是一个java对象�Q��ƈ且可以通过变量被引用。例如：如果$product是一个java的Product�c�，�q�且�q�个产品的名字可以通过调用他的getName�Q�）�Ҏ��得到�?
现在我们假设$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来改变它。默认情�? 下，计数�?#8220;1”开始，但是你可以在velocity.properties讄��它是�?#8220;1”�q�是�?#8220;0”开始。下面就是文件中的配�|�：
# 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目录下�?
#inclued ( “one.txt” )
如果您需要引入多个文�Ӟ��可以用逗号分隔��p��Q?
#include ( “one.gif”, “two.txt”, “three.htm” )
在括号内可以是文件名�Q�但是更多的时候是使用变量的：
#inclue ( “greetings.txt”, $seasonalstock )

parse
#parse script element允许模板设计者一个包含VTL的本地文件。Velocity��解析其中的VTL�q�render模板�?
#parse( “me.vm” )
��像#include�Q?parse接受一个变量而不是一个模�ѝ��Q何由#parse指向的模杉K��必须包含在TEMPLATE_ROOT目录下�? �?include不同的是�Q?parse只能指定单个对象�?
你可以通过修改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?
$count
#set ( $count = $count – 1 )
#if ( $count > 0 )
    #parse( “parsefoo.vm” )
#else
    All done with parsefoo.vm!
#end
的显�C�结果�ؓ�Q?
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是很有帮助的�?
#stop

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

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

    #tablerows( $color $greatlakes )

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

Superior

Michigan

Huron

Erie

Ontario

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

#tablerows( $cellbgcol $parts )

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

volva

stipe

annulus

gills

pileus

Velocimacro arguments
Velocimacro可以使用以下��M��元素作�ؓ参数�Q?
l Reference�Q��Q何以$开头的reference
l String literal�Q?
l Number literal�Q?
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�）�Ҏ��被执行了三次�?
如果你不需要这��L��Ҏ��可以通过以下�Ҏ��Q?
#set ( $myval = $foo.bar() )
#callme ( $myval )

Velocimacro properties
Velocity.properties文�g中的某几行能够��Velocimacros的实现更加灵�z�R��注意更多的内容可以看Developer Guide�?
Velocity.properties文�g中的velocimacro.libraary�Q�一个以逗号分隔的模板库列表。默认情况下�Q�velocity 查找唯一的一个库�Q�VM_global_library.vm。你可以通过配置�q�个属性来指定自己的模板库�?
Velocity.properties文�g中的velocimacro.permissions.allow.inline属性：有两个可选的�? true或者false�Q�通过它可以确定Velocimacros是否可以被定义在regular template内。默认值是ture――允许设计者在他们自己的模板中定义Velocimacros�?
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定义覆盖全局定义�?
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�?
Velocity.properties文�g中的velocimacro.context.localscope属性有true和false两个可选��|�� 默认��gؓfalse。当讄��为true�Ӟ��M��在Velocimacro内通过#set()对context的修改被认�ؓ是针�Ҏ��velocimacro 的本地设�|�，而不会永久的影响内容�?
Velocity.properties文�g中的velocimacro.library.autoreload属性控制Velocimacro库的自动加蝲。默认是false。当讄��为ture�Ӟ��对于一个Velocimacro的调用将自动��查原始库是否发生了变化，如果变化��重新加载它。这个属性�� 得你可以不用重新启动servlet容器而达到重新加载的效果�Q�就像你使用regular模板一栗��这个属性可以��用的前提��是resource loader�~�存是off状态（file.resource.loader.cache = false�Q�。注意这个属性实际上是针对开发而非产品的�?
Velocimacro Trivia
Velocimacro必须被定义在他们被��用之前。也��是��_��你的#macro()声明应该出现在��用Velocimacros之前�?
特别要注意的是，如果你试�?parse()一个包�?macro()的模�ѝ��因�?parse()发生在运行期�Q�但是解析器在parsetiem军_��一个看似VM元素的元素是否是一个VM元素�Q�这�?parse()-ing一�l�VM声明��不按照预期的样子工作。�ؓ了得到预期的�l�果�Q�只需要你��单的使用 velocimacro.library使得Velocity在启动时加蝲你的VMs�?
Escaping VTL directives
VTL directives can be escaped with “\”��P��使用方式跟VTL的reference使用逃逸符的格式差不多�?
## #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?
\#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?
\ Vyacheslav Ganelin
\
但是如果$jazz为false�Q�那么将没有输出。（书上说会没有输出�Q�但是我觉得应该�q�有�?#8220;\”字符被输出。）
VTL�Q�Formatting issues
��管在此用户手册中VTL通常都开始一个新行，如下所�C�：
#set ( $imperial = [ “Munetaka”, “Koreyasu”, “Hisakira”, “Morikune” ] )
#foreach ( $shogun in $imperial )
    $shogun
#end
但是像下面这�U�写法也是可以的�Q?
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.
或�?
Send me
#set($foo = [“$10 and “,”a cake”])
        #foreach �Q?a in $foo �Q?a
      #end please.
�q�两�U�的输出�l�构��一栗��?
其他�Ҏ��和杂项
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�果�?
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?
First example�Q?
1 2 3 4 5

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

Third example�Q?
0 1

Fourth example�Q?
[1..3]
注意�Q�range operator只在#set�?foreach中有效�?
Advanced Issue�Q�Escaping and�Q?
当一个reference�?#8220;�Q?#8221;分隔�Ӟ��q�且在它之前有逃逸符�Ӟ��reference��以�Ҏ��的方式处理。注意这�U�方式与标准的逃逸方式时不同的。对�? 如下�Q?
#set ( $foo = “bar” )
�Ҏ��形式标准格式
Render�? Render�? Render�? Render�?
$\!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是不合法的�?
但是�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?
#set ( $color = $bar.rowColor() )
#foo ( $color )
can I register velocimacros via #parse()?
目前�Q�Velocimacros必须在第一�ơ被模板调用前被定义。这��意味着你的#macro()声明应该出现在��用Velocimacros之前�?
如果你试�?parse()一个包�?macro() directive的模板，�q�一�Ҏ��需要牢记的。因�?parse()发生在运行期�Q�但是解析器在parsetiem军_��一个看似VM元素的元素是否是一个VM元素�Q�这�?parse()-ing一�l�VM声明��不按照预期的样子工作。�ؓ了得到预期的�l�果�Q�只需要你��单的使用 velocimacro.library使得Velocity在启动时加蝲你的VMs�?
What is velocimacro autoreloading�Q?
velocimacro.library.autoreload是专门�ؓ开发而非产品使用的一个属性。此属性的默认值是false�?
String concatenation
开发�h员最帔R��的问题是我如何作字符拼接�Q�在java中是使用“�Q?#8221;��h��完成的�?
在VTL里要惛_��现同��L��功能你只需要将需要联合的reference攑ֈ�一起就行了。例如：
#set ( $size = “Big” )
#set ( $name = “Ben” )
The clock is $size$name.
输出�l�果��是�Q�The clock is BigBen.。更有趣的情冉|��Q?
#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�?

asdtiang 2010-01-12 18:01 发表评论

国产国拍亚洲精品福利,国产av无码专区亚洲av果冻传媒,亚洲av日韩aⅴ无码色老头