NVelocity模板引擎初学总结。[zhuan]

前不久，接触到.NET下的MVC-MonoRail,它推荐使用的模板引擎就是NVelocity(目前由Castle Project项目组接手）
因此决定自学一下NVelocity的使用（抛开MonoRail）。
－－
首先：在Castle Project上下载一个CastleProject包，我下载的是CastleProject-1.0-RC3.msi
安装后，在其下的bin目录中可找到NVelocity.dll(NET项目中将用到）,并将其复制出来放到我的测试WEB／BIN目录下。
到castleproject上看了一下using it大致有四步：
先要引入以下名称空间：
using Commons.Collections;
using NVelocity;
using NVelocity.App;
using NVelocity.Context;
第一步：Creating a VelocityEngine也就是创建一个VelocityEngine的实例
VelocityEngine velocity = new VelocityEngine(); //也可以使用带参构造函数直接实例。
ExtendedProperties props = new ExtendedProperties();
velocity.Init(props);

第二步：Creating the Template加载模板文件
这时通过的是Template类，并使用VelocityEngine的GetTemplate方法加载模板
Template template = velocity.GetTemplate(@"path/to/myfirsttemplate.vm");

第三步：Merging the template整合模板
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") );

第四步：创建一个IO流来输出模板内容。推荐使用StringWriter(因为template中以string形式存放)
StringWriter writer = new StringWriter();
template.Merge(context, writer);
Response.Write(writer.ToString());

---通过上述步骤就可以轻松的使用NVelocity模板引擎的技术了。
有没有发现最后的Response.Write(writer.ToString())?
这个是直接输入到页面上。如果我们不直接输出到页面上，而是把它写入到一个文件中呢？
生成静态页－－是的，这是让大家都心动的。　
下面的代码是我第一个练习：

using Commons.Collections;

using NVelocity;

using NVelocity.App;

using NVelocity.Context;

using NVelocity.Runtime;

/**//// <summary>

/// 这个测试是基于NVelocity模板引擎实现的.

/// </summary>

public partial class NVelocity_模板引擎测试 : System.Web.UI.Page

{

protected void Page_Load(object sender, EventArgs e)

{

//创建NVelocity引擎的实例对象

VelocityEngine velocity = new VelocityEngine();

//初始化该实例对象

ExtendedProperties props = new ExtendedProperties();

props.AddProperty(RuntimeConstants.RESOURCE_LOADER, "file");
//可换成：props.AddProperty("resouce.loader","file"),以下的同道理

props.AddProperty(RuntimeConstants.FILE_RESOURCE_LOADER_PATH, Path.GetDirectoryName(Request.PhysicalPath));

props.AddProperty(RuntimeConstants.INPUT_ENCODING, "gb2312");

props.AddProperty(RuntimeConstants.OUTPUT_ENCODING, "gb2312");

velocity.Init(props);

//从文件中读取模板

Template temp = velocity.GetTemplate("myTemplate.html");

IContext context = new VelocityContext();

context.Put("from", "Sichuan");

context.Put("to", "hainan");

context.Put("subject", "welcome to nvelocity");

context.Put("name", "McJeremy");

//合并模板

StringWriter writer = new StringWriter();

//velocity.MergeTemplate(context, writer);

temp.Merge(context, writer);

//输入

Response.Write(writer.ToString().Replace("\r\n", "<br/>"));

}

}
以下是生成静态页的练习：