关于NVelocity模板引擎初学总结
最近在做一个类似wordpress的博客系统, dotNet制作, 很羡慕wordpress的模版机制,又不想用母版页和用户控件实现! 于是上网查了查.NET里的模版机制, 发现一个叫做NVelocity的模版引擎不错
因此决定自学一下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 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();
}
}
}
