使用NVelocity[翻译]

原文参见： http://www.castleproject.org/others/nvelocity/usingit.html
有的地方并不是全文对照翻译，只是意译

这是一个非常基本的NVelocity的使用说明。NVelocity可以把模板和数据动态合并 ( 不光是MonoRail的web页面可以使用，其他诸如发送邮件等也可以使用)

为了演示简单，下面的例子我们使用一个邮件的模板
第一步：生成VelocityEngine
开始必须有一个engine的实例。初始化实例的时候可以包含一些属性来指定NVelocity的编码、cache等

using  Commons.Collections;
using  NVelocity;
using  NVelocity.App;
using  NVelocity.Context;



VelocityEngine velocity  =   new  VelocityEngine();

ExtendedProperties props  =   new  ExtendedProperties();
velocity.Init(props);

第二步：生成模板
假设我们生成一个邮件模板，如下所示:

From: $from
To: $to
Subject: $subject

Hello $customer.Name

We're please to yada yada yada.

用文件的绝对路径( 相对路径也是可以的)使用下面一行c#代码：

Template template  =  velocity.GetTemplate( @" path/to/myfirsttemplate.vm " );

第三步：合并模板
主要是将数据和模板合并生成最后的内容。可以在模板中使用context

VelocityContext context  =   new  VelocityContext();
context.Put( " from " ,  " somewhere " );
context.Put( " to " ,  " someone " );
context.Put( " subject " ,  " Welcome to NVelocity " );
context.Put( " customer " ,  new  Customer( " John Doe " ) );

最后使用writer，比如StringWriter输出内容，代码如下所示：

StringWriter writer  =   new  StringWriter();
template.Merge(context, writer);
Console.WriteLine(writer.GetStringBuilder().ToString());

使用以上代码之后就可以在控制台中看到合并后的结果