NVelocity系列:NVelocity配置详解

在VelocityEngine初始化前，可以通过ExtendedProperties配置NVelocity的运行环境参数，当执行VelocityEngine的Init(ExtendedProperties)后，NVelocity会合并自定义配置和默认配置。NVelocity在NVelocity.Runtime.RuntimeConstants中定义了默认配置项的名称，在内嵌资源文件NVelocity.Runtime.Defaults.nvelocity.properties中定义了所有默认配置项的值。下面列出一些常用配置：

　　模板编码：

　　input.encoding=ISO-8859-1　　　　 //模板输入编码

　　output.encoding=ISO-8859-1　 //模板输出编码

　　#foreach配置

　　directive.foreach.counter.name = velocityCount　　　　 //计数器名称

　　directive.foreach.counter.initial.value = 1　　　　　　　　　　　　　　 //计数器初始值

　　directive.foreach.maxloops = -1　　　　　　　　　　　　　　　　　　　　　　　　　　 //最大循环次数，-1为默认不限制 directive.foreach.iterator.name = velocityHasNex　　　 //迭代器名称

　　#set配置

　　directive.set.null.allowed = false　　　　 //是否可设置空值

　　#include配置

　　directive.include.output.errormsg.start = <!-- include error :　　　　 //错误信息提示开始字符串

　　directive.include.output.errormsg.end　　 =　 see error log -->　　　　　 //错误信息提示结束字符串

　　#parse配置

　　directive.parse.max.depth = 10　　　　 //解析深度

　　模板加载器配置

　　resource.loader = file　　　　 //模板加载器类型，默认为文件，可定义多个

　　file.resource.loader.description = Velocity File Resource Loader　　　　 //加载器描述

　　file.resource.loader.class = NVelocity.Runtime.Resource.Loader.FileResourceLoader　　　　 //加载器类名称

　　file.resource.loader.path = .　　　　　　　　　　　 //模板路径

　　file.resource.loader.cache = false　　　　 //是否启用模板缓存

　　file.resource.loader.modificationCheckInterval = 2　　　　 //检查模板更改时间间隔

　　宏配置

　　velocimacro.permissions.allow.inline = true　　　　　　　　　　　　　　　　　　　　　　　　　　　　　 //是否可以行内定义

　　velocimacro.permissions.allow.inline.to.replace.global = false　　　　 //是否可以用行内定义代替全局定义

　　velocimacro.permissions.allow.inline.local.scope = false　　　　　　　　　　　　 //行内定义是否只用于局部

　　velocimacro.context.localscope = false　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　 //宏上下文是否只用于局部

　　velocimacro.max.depth = 20　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　 //解析深度

　　velocimacro.arguments.strict = false　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　 //宏参数是否启用严格模式

　　资源管理器配置

　　resource.manager.class = NVelocity.Runtime.Resource.ResourceManagerImpl　　　　　　　　　 //管理器类名称

　　resource.manager.cache.class = NVelocity.Runtime.Resource.ResourceCacheImpl　　　　 //缓存器类名称

　　解析器池配置

　　parser.pool.class = NVelocity.Runtime.ParserPoolImpl　　　　 //解析池类名称

　　parser.pool.size = 40　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　 //初始大小

　　#evaluate配置

　　directive.evaluate.context.class = NVelocity.VelocityContext　　　　 //上下问类名称

　　可插入introspector配置

　　runtime.introspector.uberspect = NVelocity.Util.Introspection.UberspectImpl　　　　 //默认introspector类名称

　　在NVelocity中有的配置是可以定义多个的，比如资源加载器。注意一点在传入的实现类名称一定要采用：class fullname;assembly name格式，比如自定义了一个资源加载器EasyNet.Mvc.AssemblyResourceLoader，程序集名称为EasyNet.Mvc，那么应该如下示例定义:

VelocityEngine velocity = new VelocityEngine();

　　　　　　　　　　　 ExtendedProperties props = new ExtendedProperties();

　　　　　　　　　　　 //定义资源加载器
　　　　　　　　　　　 props.AddProperty(RuntimeConstants.RESOURCE_LOADER, "EasyNet.Mvc.AssemblyResourceLoader;EasyNet.Mvc");

　　　　　　　　　　　 //初始化
　　　　　　　　　　　 velocity.Init(props);