VS Extension+NVelocity系列(一)——构建一个简单的NVelocity解析环境

一、前言

本节我们将实际实现一个简单的NVelocity解析环境,以便为以后的实例做一些基本工作,虽然NVelocity如何使用已经属于老掉牙的话题,但我只能专门挑出来一章来做铺垫.人生就是这样无奈啊.不过请您放心,不会耗去您太多的时间.

二、项目搭建

1.新建一个”ASP.Net 空Web应用程序”,.Net版本请选择4,项目命名为:SW.VMTest,并”为解决方案创建目录”
2.在解决方案下再新建一个类库项目:SW.VMTest.Library
3.续上文，在SW.VMTest.Library 上引用您下载到的4.0/NVelocity.dll

4.新建一个NVelocityEngine类:

using Commons.Collections;
using NVelocity;
using NVelocity.App;
using System;
using System.Collections;
using System.IO;
using System.Web;

namespace SW.VMTest.Library
{
    public class NVelocityEngine
    {
        public VelocityContext Context { get; set; }

        private VelocityEngine _Engine { get; set; }

        public NVelocityEngine(HttpContext httpContext)
        {
            ExtendedProperties ep = new ExtendedProperties();
            //#foreach 计数器初始值
            ep.AddProperty("directive.foreach.counter.initial.value", 0);
            //是否允许设置为null
            ep.AddProperty("directive.set.null.allowed", false);
            //模板路径
            ep.AddProperty("file.resource.loader.path", AppDomain.CurrentDomain.BaseDirectory + "\\Template");
            _Engine = new VelocityEngine(ep);

            //Context init
            Hashtable hs = new Hashtable();
            hs.Add("Session", httpContext.Session);
            hs.Add("Request", httpContext.Request);
            hs.Add("Server", httpContext.Server);
            hs.Add("ObjHelper", new ObjectHelper());
            Context = new VelocityContext(hs);
        }

        public bool Merge(string templateName, TextWriter writer)
        {
            bool result = _Engine.MergeTemplate(templateName, "UTF-8", Context, writer);
            if (!result)
                _Engine.Error("模板解析失败！");
            return result;
        }

        public bool Evaluate(TextWriter writer, string inString)
        {
            bool result = _Engine.Evaluate(Context, writer, "Error", inString);
            if (!result)
                _Engine.Error("模板解析失败！");
            return result;
        }
    }
}

5.继续在在SW.VMTest.Library 项目上引用System.Web

6.新建一个SHtmlHandler类:

using System.IO;
using System.Web;

namespace SW.VMTest.Library
{
    public class SHtmlHandler : IHttpHandler
    {
        public bool IsReusable
        {
            get { return false; }
        }

        public void ProcessRequest(HttpContext context)
        {
            NVelocityEngine _nVe = new NVelocityEngine(context);
            string filePath = context.Request.Path.TrimStart('\\').Replace(".shtml", ".vm");

            StringWriter writer = new StringWriter();
            _nVe.Merge(filePath, writer);

            context.Response.Clear();
            context.Response.Write(writer);
            context.Response.End();
        }
    }
}

7.在SW.VMTest.Library上新建一个文件夹,命名为Helper

8.在Helper文件夹内新建一个ObjectHelper类:

using System;

namespace SW.VMTest.Library
{
    public class ObjectHelper
    {
        public object GetObject(string typeName)
        {
            return GetObject(typeName, null);
        }

        public object GetObject(string typeName, params object[] args)
        {
            Type type = Type.GetType(typeName);
            if (type == null)
                throw new ArgumentException("找不到具体的类型");
            object obj;
            if (args != null)
                obj = Activator.CreateInstance(type, args);
            else
                obj = Activator.CreateInstance(type);
            return obj;
        }
    }
}

9.在SW.VMTest项目上修改Web.config文件:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <system.web>
    <compilation debug="true" targetFramework="4.0" />
    <httpHandlers>
      <add path="*.shtml" verb="*" type="SW.VMTest.Library.SHtmlHandler, SW.VMTest.Library"/>
    </httpHandlers>
  </system.web>
</configuration>

10.在SW.VMTest项目上创建新文件夹Template
11.Template文件夹上点右键,选择”在文件资源管理器中打开此文件”
12.在打开的文件夹中创建一个空白的.txt文档,并修改文件名为”test.vm”
13.点击vs”工具”->”选项”->”文本编辑器”->”文件扩展名”,添加如下图项目,确定
```
14.点击解决方案管理中的”显示文件”按钮
```
15.找到Template文件夹下的Test.vm,右击,选择”包含进项目”

16.打开Test.vm文件,输入以下代码:

<html>
<head>
    <title>Test Page</title>
</head>
<body>
    <h1>Hello World</h1>
    <ul>
        #foreach($item in [1..5])
	    <li>I'm the list$item with index $velocityCount</li>
        #end
    </ul>
    <p>$Server.MapPath('aaa.aspx')</p>
    <p>$Request.QueryString.get_item('aa')</p>
    #set($dictionary = $ObjHelper.GetObject('System.Collections.Generic.Dictionary`2[[System.Int32],[System.Int32]]'))
    $dictionary.Add(1,123)
    $dictionary.Add(2,223)
    $dictionary.Add(3,323)
    <p>$dictionary.get_item(1)</p>
</body>
</html>

17.运行,输入以下地址:
http://localhost:3205/test.shtml?aa=hahaha
18.请确认是否为以下界面,如果不,请检查步骤.

三、说明

以下是上述步骤的一些说明：

NVelocityEngine类

任何一个习惯语言的人,我想都最好还是不要打破他们索引从0起的习惯吧.所以directive.foreach.counter.initial.value=0是有必要在配置里面的

而在一个网站系统里面,把所有的模板都放在一个目录,我认为就方便查找的原因来讲,也是需要重视的.本节配置里面file.resource.loader.path我设置为根目录下的Template文件夹

为了后文能有更多的例子可以讲,我特意在Context里面加入了Session、Request、Server和一个简易的ObjectHelper

SHtmlHandler类

本类的主要目的就是将.shtml的请求交给本类来处理.

ObjectHelper

我们知道在NVelocity里面是不能new出对象的.ObjectHelper的目的便在于此,通过反射来得到新的对象.

其他

将vm设置为HTML编辑器打开可以解决HTML标签的着色问题,当然这个问题在后文我们会解决,但为了暂时的书写方便,先设置为HTML编辑器.毕竟全是黑字,时间长了,会很费眼睛的.

四、还有些要说的

实际上,在任何一个系统级别的应用,仅仅编写以上代码是不够的,对于缓存的处理,更丰富的帮助类,都是必须的.

但仅以上内容对于后面系列的文章就足够了.

另外我十分头疼这个代码插件,为什么不能折叠起来呢?

秒客网