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/>"));
    }    
}
以下是生成静态页的练习：

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(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);
        //生成静态页
 using (StreamWriter writer2 = new StreamWriter(Server.MapPath("/") + "test.html"), false, Encoding.UTF8, 200))
        {
            writer2.Write(writer);
            writer2.Flush();
            writer2.Close();
        }

    }    
}

<h3>
   心静似高山流水不动，心清若巫峰雾气不沾。
</h3>