NVelocity系列:NVelocity的语法及指令

我喜欢在Asp.Net MVC中使用NVelocity View Engine的一个很重要的理由就是：NVleocity简洁易用的语法。几乎使用#set，#if，#foreach就可以构成完整的应用，下面就介绍一下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。

以上是NVelocity的常用指令，下一篇将会讲NVelocity Macro的使用和如何开发User Directive。