MonoRail学习笔记十三：NVelocity的增强功能

之前我转载过一篇： 《Velocity 模板使用指南》中文版[转] ，这个是基于最开始的Java版下的Velocity来说的。后来在castle的.NET版下又提供了一些增强功能，详见： NVelocity Improvements
本文结合一些小例子来具体谈谈这些增强功能的使用。
( 有部分内容是直接翻译自 NVelocity Improvements -_-)

一、支持数组参数
比如在Controller中定义如下方法：

public void Index()
{
PropertyBag.Add("instance",this);
}
public static string Welcome( params String[]args)
{
returnString.Join("-",args);
}

在vm中写：

$instance.Welcome( ' arg1 ' , ' arg2 ' )

那么回输出如下结果：
arg1-arg2

二、内置字典支持
对于一些传参的地方很方便，比如我们常用的一种方式：

$HtmlHelper.LabelFor( ' elementid ' , ' Name: ' , " %{class='required',accessKey='N'} " )

那么会自动生成一个字典，里面包含class和accessKey两个条目

内置字典我们可以在很多场合用到，比如我们在Controller中定义一个方法：

public string DictionaryTest( string name,IDictionaryattributes)
{
StringBuildersResult=newStringBuilder("<inputtype=\"text\"name='"+name+"'");
foreach(objectkeyinattributes.Keys)
{
objectvalue=attributes[key];
sResult.Append(""+key+"='"+value+"'");
}

sResult.Append("/>");

returnsResult.ToString();
}

然后在vm中调用：

$instance.DictionaryTest('id',"%{aa='aa1',value='aa2',value2='aa3'}")

会在页面中生成一个输入框，具体的html代码是:

< input type ="text" name ='id' aa ='aa1' value ='aa2' value2 ='aa3' />

三、更强的foreach功能(这个功能比较好)
可以指定在foreach之前、之后等特定时候执行一些语句，具体语法如下：

#foreach($iin$items)
#each(thisisoptionalsinceitsthedefaultsection)
textwhichappearsforeachitem
#before
textwhichappearsbeforeeachitem
#after
textwhichappearsaftereachitem
#between
textwhichappearsbetweeneachtwoitems
#odd
textwhichappearsforeveryotheritem,includingthefirst
#even
textwhichappearsforeveryotheritem,startingwiththesecond
#nodata
Contentrenderedif$itemsevaluatedtonullorempty
#beforeall
textwhichappearsbeforetheloop,onlyifthereareitems
matchingcondition
#afterall
textwhichappearsaftertheloop,onlyofthereareitems
matchingcondition
#end

比如如下的一个例子：

#foreach($personin$people)
#beforeall
< table >
< tr >
< th > Name </ th >
< th > Age </ th >
</ tr >
#before
< tr
#odd
Style ='color:gray' >
#even
Style='color:white'>

#each
< td > $person.Name </ td >
< td > $person.Age </ td >

#after
</ tr >

#between
< tr >< td colspan ='2' > $person.bio </ td ></ tr >

#afterall
</ table >

#nodata
SorryNoPersonFound
#end

当我们$people中有两条记录时会生成以下html:

< table >
< tr >
< th > Name </ th >
< th > Age </ th >
</ tr >
< tr style ='color:white' >
< td > John </ td >
< td > 32 </ td >
</ tr >
< tr >< td colspan ='2' > Monorailprogrammer </ td ></ tr >
< tr style ='color:gray' >
< td > Jin </ td >
< td > 12 </ td >
</ tr >
< tr >< td colspan ='2' > Castleguru </ td ></ tr >
</ table >

当$people为null时会直接输出：

SorryNoPersonFound

四、枚举类型的改进
为了可读性，可以自己使用枚举类型的文字表达进行比较。
例：

public enum OrderStatus
{
Undefined,
Created,
Dispatched
}

那么可以在vm中如下比较：

#if($order=="Undefined")
Sorry,butwedon'tknowthisorder.
#elseif($order=="Created")
Yourorderisbeingprocessed.Holdon!
#elseif($order=="Dispatched")
YourorderhasbeendispatchedthroughUPS.Crossyourfingers!
#end

( 原文中好像有点问题，我重新改了一些代码)

Castle1.0 RC3中的新功能：
1、在vm中，方法和属性不再区分大小写，使用时可以不必记住大小写了
2、字典功能改进，在vm字典调用时可以直接使用以下方式(参见上面的 内置字典支持)：
key='value' key=1 key=1.2 key='1' $key='value' key=$value key='some$value'