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。

凌众科技专业提供服务器租用、服务器托管、企业邮局、虚拟主机等服务，公司网站：http://www.lingzhong.cn 为了给广大客户了解更多的技术信息，本技术文章收集来源于网络,凌众科技尊重文章作者的版权，如果有涉及你的版权有必要删除你的文章，请和我们联系。以上信息与文章正文是不可分割的一部分,如果您要转载本文章,请保留以上信息，谢谢!