Net下模板引擎NVelocity的封装类――VelocityHelper

要求有网站模板功能，能够自主编辑网站的风格，因为这个系统是为政府部门做子站系统，举个例如：每个街道办拥有一个站点，而且可以设置他们的风格。

ASP.Net下的Skin技术可能能够实现这个功能的,不过我个人觉得Asp.net的Skin技术相对于我的项目来过于复杂了，我需要一个能像PHP下Smarty模板技术的就足够了。在网络上搜索了一阵，最后找到了NVelocity。

NVelocity是Java模板引擎Velocity的.Net版本。NVelocity目前官方版本为0.42。官方地址：http://nvelocity.sourceforge.net/，原作者已经申明不再对NVelocity做技术支持了，所以sourceforge上NVelocity版本一直是0.42不再有更新了。不过目前NVelocity已经有1.0的版本了，是由castleproject项目维护的。NVelocity.dll能在castle项目中找到。Castleproject地址：http://www.castleproject.org/。

要使用NVelocity模板技术需要学习VTL语言。网络上关于NVelocity的VTL语言介绍的比较少，不过没有关系，由于NVelocity是有Velocity移植过来的所以Velocity的VTL语言完全适用于NVelocity。下面我们来封装一个VelocityHelper类以方便NVelocity在在.NET中使用。

VelocityHelper.cs 文件

using System;
using System;
using System.Web;
using System.IO;
using NVelocity;
using NVelocity.App;
using NVelocity.Context;
using NVelocity.Runtime;
using Commons.Collections;
 
///
/// NVelocity模板工具类 VelocityHelper
///
    public class VelocityHelper
    {
        private VelocityEngine velocity = null;
        private IContext context = null;
        ///
        /// 构造函数
        ///
        ///
        //模板文件夹路径
        public VelocityHelper(string templatDir)
        {
            Init(templatDir);
        }
        ///
        /// 无参数构造函数
        ///
        public VelocityHelper() { ;}
        ///
        /// 初始话NVelocity模块
        ///
        ///
        //模板文件夹路径
        public void Init(string templatDir)
        {
            //创建VelocityEngine实例对象
            velocity = new VelocityEngine();

            //使用设置初始化VelocityEngine
            ExtendedProperties props = new ExtendedProperties();
            props.AddProperty(RuntimeConstants.RESOURCE_LOADER, "file");
            props.AddProperty(RuntimeConstants.FILE_RESOURCE_LOADER_PATH, HttpContext.Current.Server.MapPath(templatDir));
            props.AddProperty(RuntimeConstants.INPUT_ENCODING, "gb2312");
            props.AddProperty(RuntimeConstants.OUTPUT_ENCODING, "gb2312");
            velocity.Init(props);

            //为模板变量赋值
            context = new VelocityContext();
        }
        ///
        /// 给模板变量赋值
        ///
        ///
        //模板变量
        ///
        //模板变量值
        public void Put(string key, object value)
        {
            if (context == null)
                context = new VelocityContext();
            context.Put(key, value);
        }
        ///
        /// 显示模板
        ///
        ///
        //模板文件名
        public void Display(string templatFileName)
        {
            //从文件中读取模板
            Template template = velocity.GetTemplate(templatFileName);
            //合并模板
            StringWriter writer = new StringWriter();
            template.Merge(context, writer);
            //输出
            HttpContext.Current.Response.Clear();
            HttpContext.Current.Response.Write(writer.ToString());
            HttpContext.Current.Response.Flush();
            HttpContext.Current.Response.End();
        }
    }

使用方法:

View Code CS

VelocityHelper vh = new VelocityHelper();         vh.Init(@"templates");//指定模板文件的相对路径         vh.Put("title", "员工信息");         vh.Put("comName", "贵州公司");         vh.Put("property", "哈哈");         vh.Put("comAddress", "贵州");         ArrayList aems = new ArrayList();         aems.Add(new EM("小5", 22, "男"));         aems.Add(new EM("小6", 21, "女"));         aems.Add(new EM("小7", 22, "男"));         aems.Add(new EM("小8", 32, "男"));         vh.Put("aems", aems);         //使用tp1.htm模板显示         vh.Display("tp1.htm");

注意上面只有关键性的代码，如EM为员工类。完整代码请在下面下载。

找不到NVelocity.dll的朋友可以在这里下载：

VelocityHelper封装类以及使用Demo 其中的NVelocity.dll是1.0版本的

Velocity中文手册下载这个VLT语言一样适用于NVelocity