NVelocity 1.1、StringTemplate
3.2和ASP.NET的ASPX页面做了个性能测试对比,对比结果如下:
结果就是,在2台不同的机器上,ASPX:StringTemplate:NVelocity分别为1.00:8.53:1.61和
1.00:7.34:1.71,StringTemplate的性能最弱,NVelocity有点接近ASPX的解析效率。
我喜欢在Asp.Net MVC中使用NVelocity View Engine的一个很重要的理由就是:NVleocity简洁易用的语法。几乎使用#set,#if,#foreach就可以构成完整的应用,下面就介绍一下NVelocity中的语法及常用指令。
NVelocity常用语法指令
默认情况下,NVelocity解析是不分大小写的,当然可以通过设置runtime.strict.math=true,采用严格解析模式。
对变量的引用:
$ [ ! ][ { ][ a..z, A..Z ][ a..z, A..Z, 0..9, -, _ ][ } ]。
在NVelocity中,对变量的引用都是以$开头加上变量名称。当使用!时表示当此变量值为空时,显示空字符串。比如当$article为空,那
会显示“$article“,而$!article会显示为“”。{}为变量名称限定,有时候变量名称后会有字符串,这是就需要用到{}了。比
如$articleshow,想引用$article,这时只要修改为${article}就可以。其实,NVelocity对整个模板解析后都会变成这
种模式。
对属性的引用:
$ [ { ][ a..z, A..Z ][ a..z, A..Z, 0..9, -, _ ]* .[a..z, A..Z ][ a..z, A-Z, 0..9, -, _ ]* [ } ] 。
例如$article.Title或者${article.Title}。
对方法的引用
:$ [ { ][ a..z, A..Z ][ a..z, A..Z, 0..9, -, _
]* .[ a..z, A..Z ][ a..z, A..Z, 0..9, -, _ ]*( [ optional parameter
list... ] ) [ } ]。
例如:$article.GetListByTitle('nvelocity')或${article.GetListByTitle('nvelocity')}。其实对对象的属性值也可以用$article.get_Title()获得。
赋值指令#set
:# [ { ] set [ } ] ( $ref = [ ", ' ]arg[ ", ' ] )。
例如:$article.Title='NVelocity',$$article.Categories=[1,2,3],当然右侧也可以使用复
杂的表达式:$article.Title=$otherArticle.Title.SubString(0,3),算术表达
式:$article.Page=4/3等等。属性赋值也可以用$article.set_Title('NVelocity')。
条件指令#if
:# [ { ] if [ } ] ( [condition] ) [output] [ #
[ { ] elseif [ } ] ( [condition] ) [output] ]* [ # [ { ] else [ } ]
[output] ] # [ { ] end [ } ] 。
条件可以是返回bool的复查表达式。例如:#if($article.Total>1) $article.Title #else 没有数据 #end。
循环指令#foreach
:# [ { ] foreach [ } ] ($refinarg)statement# [ { ] end [ } ]。
例如:#foreach($article in $articles) $article.Title #end。
引用静态资源指令#include
:# [ { ] include [ } ] ( arg[ arg2 ... argn] )。
例如:#include('tmp.js'),会把tmp.js文件内容插入当前流。当然可以使用表达式:#include($article.Url)。
引用并解析资源指令#parse
:# [ { ] parse [ } ] ( arg )。
例如:#parse('tmp.js'),与#include不同是,假如tmp.js文件中有NVelocity的指令,变量会进行处理,并把结果插入到当前流。
停止指令stop
:# [ { ] stop [ } ] 。
当NVelocity解析到此指令时,会停止解析过程。一般用户调试。
计算指令#evaluate:# [ { ] evaluate [ } ] ( arg )。
例如:#evaluate('$article.Title'),会在当前输出$article.Title
应用方法:
先引入以下名称空间:
using Commons.Collections;
using NVelocity;
using NVelocity.App;
using NVelocity.Context;
第一步:创建一个VelocityEngine的实例
VelocityEngine velocity = new VelocityEngine(); //也可以使用带参构造函数直接实例。
ExtendedProperties props = new ExtendedProperties();
velocity.Init(props);
第二步:加载模板文件
这时通过的是Template类,并使用VelocityEngine的GetTemplate方法加载模板
Template template = velocity.GetTemplate(@"path/to/myfirsttemplate.vm");
第三步:整合模板
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());