在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 //檢查模 板更改時間間隔