[转载]MonoRail学习笔记十三：NVelocity的增强功能

[转载]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)
{
return String.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, IDictionary attributes)
{
StringBuilder sResult = new StringBuilder(“<input type=\“text\“ name=’“ + name + “‘“);
foreach (object key in attributes.Keys)
{
object value = attributes[key];
sResult.Append(“ “ + key + “=’“ + value + “‘ “);
}

sResult.Append(“/>“);

return sResult.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($i in $items)
#each (this is optional since its the default section)
text which appears for each item
#before
text which appears before each item
#after
text which appears after each item
#between
text which appears between each two items
#odd
text which appears for every other item, including the first
#even
text which appears for every other item, starting with the second
#nodata
Content rendered if $items evaluated to null or empty
#beforeall
text which appears before the loop, only if there are items
matching condition
#afterall
text which appears after the loop, only of there are items
matching condition
#end

比如如下的一个例子：

#foreach($person in $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
Sorry No Person Found
#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′>Monorail programmer</td></tr>
<tr style=’color:gray’>
<td>Jin</td>
<td>12</td>
</tr>
<tr><td colspan=’2′>Castle guru</td></tr>
</table>

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

Sorry No Person Found

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

public enum OrderStatus
{
Undefined,
Created,
Dispatched
}

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

#if($order == “Undefined”)
Sorry, but we don’t know this order.
#elseif($order == “Created”)
Your order is being processed. Hold on!
#elseif($order == “Dispatched”)
Your order has been dispatched through UPS. Cross your fingers!
#end

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

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