一山容二虎，支持最新版Log4Net的模板引擎NVeloCity

    在最近的ICMS项目中&＃xff0c;为了实现完全的分离业务和视图部分&＃xff08;同时也需要视图偶尔能调用业务逻辑用用&＃xff09;&＃xff0c;所以决定引入已经非常成熟的开源搜索引擎Nvelocity.

但很可惜的是Nvelocity 的最新版本0.4.2 也在2003 年停止了更新和维护&＃xff0c;其中引用的其他开源组件也都是当时的版本&＃xff0c;比如:

Log4Net版本是2002 年的 1.2.0.&＃xff08;而今的Nhibernate 3中自带的Log4Net 版本为2010年10月版本号1.2.10&＃xff09;

当ICMS项目同时引入Nvelocity 和 Nhibernate 3 后&＃xff0c;由于项目引用只能引入一个版本的log4Net&＃xff0c; 终于。。。。杯具发生了.

1、当项目中使用新版的Log4Net 时&＃xff0c;Nhibernat OK 正常&＃xff0c;可是Nvelocity 对新版的Log4Net 不兼容&＃xff0c;因为新版的Log4Net 已经取消了很多命名空间&＃xff0c;初始化方式也不同&＃xff0c;甚至日志的分级也有些改变。所以调用Nvelocity 运行后直接异常。(NND&＃xff0c;Nvelocity 竟然还没有取消写日志的函数。)

2、干脆替换成Nvelocity支持的老版本的Log4Net&＃xff0c;又餐具了&＃xff01;当Nhibernate 检测到 log4Net 存在时&＃xff0c;就试图加载&＃xff0c;因为Log4Net 版本差异太大&＃xff0c;所以Nheibernate 也异常了。。。 (⊙o⊙)&＃xff01;

   这简直是一山不能容二虎啊&＃xff0c;考虑到未来可能对ICMS日志进行统一处理&＃xff0c;还是决定花点时间改造Nvelocity ,以支持新版的Log4Net。这次虽然我碰上Nvelocity 和Nhibernate 之间的Log4Net 的兼容性问题&＃xff0c;想想还有很多其他开源组件或项目也都是用基于Log4Net 的&＃xff0c;估计遇到我这样问题的人应该不少吧&＃xff01;

改造中。。。

    重写了Nvelocity 中的Log4Net 的引用和调用部分开发&＃xff0c;支持最新版本1.2.10 。

    为了方便其他人的使用&＃xff0c;我打包重新封装了&＃xff08;2003 年的Nvelocity 好像是基于.net 1.x 编写的啊&＃xff01;&＃xff01;&＃xff01;&＃xff09;

 

    可能还有很多人对Nvelocity 比较陌生&＃xff0c;我大致按照我的理解介绍一下Nvelocity &＃xff0c;同时包含一些开发中的经验知识点。

 

NVelocity 特点介绍&＃xff1a;

    NVelocity 是基于Java 的模板引擎Velocity 的.net 版本&＃xff0c;在JAVA的模板引擎界还是赫赫有名的。

    NVelocity 的模板语法基于SUN的Bean 语法结构&＃xff0c;所以它是非常灵活的。

    业务可以完全和视图模板隔离&＃xff0c;NVelocity 直接使用业务中的结果类型进行模板的组织构造&＃xff0c;当然还可以直接使用业务中给出的自定义类型。

 

Nvelocity 使用方面的简单介绍&＃xff1a;

    Nvelocity模板的定义

可以是任意文本文件&＃xff0c;注意文件编码最好是UTF-8&＃xff1b;官方给出的模板文件扩展名为 “.vm”&＃xff0c;不过可以自己随意定义。

        这里我定义了一个模板&＃xff0c;/VT/Hello1.vm

       内容如下&＃xff1a;

${bill}

#set($count&＃61;8)
#foreach ($i in ${bill})
    ${owner}&＃xff1a;您的 $i 号${type}在 ${date} 已支付

#end

 

    初始化Nvelocity:

//初始化Velocity 实例&＃xff0c;可以采用单例模式节省内存&＃xff0c;提高执行效率

VelocityEngine vltEngine &＃61; new VelocityEngine();

//初始化Velocity 的属性

ExtendedProperties props &＃61; new ExtendedProperties();

//模板文件路径属性是必须要声明的&＃xff0c;这里设置根路径即可&＃xff0c;具体模板载入可以使用相对路径&＃xff0c;不设置载入模板会异常。

props.SetProperty(RuntimeConstants_Fields.FILE_RESOURCE_LOADER_PATH, Context.Request.PhysicalApplicationPath);

//日志路径属性设置

props.SetProperty(RuntimeConstants_Fields.RUNTIME_LOG, Context.Request.PhysicalApplicationPath &＃43; props.GetString(RuntimeConstants_Fields.RUNTIME_LOG, "nvelocity.log"));

vltEngine.Init(props);

   指定模板并输出业务结果数据&＃xff1a;

//加载指定模板&＃xff0c;指定上面定义的根路径 的相对路径即可

Template vltTemplate &＃61; vltEngine.GetTemplate("/VT/Hello1.vm");

//结果上下文保持器&＃xff0c;填充数据

VelocityContext vltContext &＃61; new VelocityContext();

vltContext.Put("owner", "Unmi");

vltContext.Put("bill", new List<int>() { 1, 2, 3, 4 });

vltContext.Put("type", "报销单");

vltContext.Put("date", DateTime.Now.ToLongDateString());

 

StringWriter sw &＃61; new StringWriter();

//内容和模板合并

vltTemplate.Merge(vltContext, sw);

//lt1 是页面中的Label 控件。

lt1.Text &＃61; sw.GetStringBuilder().ToString();

 

最终页面结果输出&＃xff1a;

System.Collections.Generic.List&＃96;1[System.Int32]
Unmi&＃xff1a;您的 1 号报销单在 2010年12月24日 已支付
Unmi&＃xff1a;您的 2 号报销单在 2010年12月24日 已支付
Unmi&＃xff1a;您的 3 号报销单在 2010年12月24日 已支付
Unmi&＃xff1a;您的 4 号报销单在 2010年12月24日 已支付

 

其实Nvelocity 超简单&＃xff0c;语法也非常简单&＃xff0c;下方有模板语法文档的下载&＃xff0c;模板语法不分Velocity 和Nvelocity 版本。

另外注意&＃xff1a;NVelocity 大部分情况下是区分大小写的&＃xff0c;请务必注意。

 

 

我改版后的源码和Assembly 点这里下载&＃xff1a; Velocity项目源码下载

Nvelocity 模板语法文档点这里下载&＃xff1a; Velocity 语法文档下载