velocity学习总结

1）嵌套vm，在vm中可使用#parse来嵌套另外一个vm，对应的在jsp方面就是嵌套jsp，但嵌套在内的jsp和外部的jsp无法共用变量，非常不方便，而velocity不存在这方面的问题，变量完全共享，如：
->a.vm 里嵌套 b.vm；
->a.vm 里定义了变量 $param；
->b.vm 里可以直接使用$param，无任何限制。
但需要特别注意的是，如果b.vm里同时定义有变量$param，则b.vm里将使用b.vm里定义的值；

 

2）内置对象
Velocity内置了一些对象，在vm模版里可以直接调用，列举如下：
$request、$response、$session，另外，模板内还可以使用 $msg内的消息工具访问 Struts 的国际化资源，达到简便实现国际化的方法。

例如，我们在toolbox.xml文件中配置了如下代码

<tool>
<key>msg</key>
<scope>request</scope>
<class>
org.apache.velocity.tools.struts.MessageTool
</class>
</tool>

并且我们有一个编译好了的文件：ApplicationResources_zh_CN.properties。它的内容如下：
name=六月天

在.vm文件中，就可以这样写：${msg.get("name")}

 

3）taglib的改造
taglib是Struts中一个重要的功能，但也有不足之处，后继参与开发和维护的人员不能很容易的掌握其作用，以及这些特殊的标签容易使页面的美工设计人员不容易处理等等。
如果原来View层编码规范，在jsp中出现的java代码比较少或者没有，则改造到Velocity也就比较容易。

替代taglib的方法很多，也很简便，比如Macro宏，类似JavaBean的使用方式等，而Dlog4J采用了综合的方法，具体说就是使用 ObjectTools extends VelocityTool，并在Velocity的配置文件velocity-toolbox.xml中配置好在模版上的变量名，进而所有的vm模版都可以直接使用ObjectTools，vm模版全部通过ObjectTools来统一访问DAO进而读取数据展示。

4）vm的reload问题(重载与缓存)
有时会发现vm模版修改后进行新请求时，页面会继续采用更改前的模版，这是因为模版的加载是有一定时间间隔的，如要更改立即生效，需要在velocity-(*).jar 包中，找到\org\apache\velocity\runtime\defaults 目录，更改Velocity默认的配置文件：velocity.properties，修改如下2项：
file.resource.loader.cache，模版文件是否进行缓冲
file.resource.loader.modificationCheckInterval，模版资源的修改检测间隔。
用rar把velocity-(*).jar 解压，得到资源文件后修改再更新回.jar 内。

 

5）exception处理问题
由于与Struts结合，使用了Velocity工具包：velocity-tools.jar，其中的org.apache.velocity.tools.view.servlet.VelocityViewServlet 是默认的Velocity处理引擎，所有的异常处理也都交到VelocityViewServlet的error方法处理，没有类似jsp的 errorPage，所以不能对异常进行方便的包装，所以要想封装exception，只有通过改造VelocityViewServlet来实现。

Dlog4J中增加了dlog4j.VelocityServlet，继承VelocityViewServlet并覆盖了error的处理办法，从而实现对异常的封装和包裹。

6）数组访问
对数组的访问在Velocity中存在问题，因为Velocity只能访问对象的方法，而数组又是一个特殊的Array，所以虽然数组可以进行循环列举，但却不能定位访问特定位置的元素，如 strs[2]，数组对固定位置元素的访问调用了Array的反射方法get(Object array, int index)，而Velocity没能提供这样的访问，所以数组要么改成List等其他类容器的方式来包装，要么就通过公用Util类的方式来提供，传入数组对象和要访问的位置参数，从而达到返回所需值的目的。

另外在这里值得一提的是，FreeMarker在模板方面，比Velocity有了更多的改进，包括在数组处理方面提供：使用类似[i]语法的索引方式访问数组元素，以及可以查询数组长度。

评论

1 楼 aokunsang 2011-03-28  

这位仁兄，请问个velocity整合spring+strtus2的问题。
applicationContext.xml文件中就添加个

<bean id="velocityConfig" class="org.springframework.web.servlet.view.velocity.VelocityConfigurer">
		<property name="configLocation">
			<value>WEB-INF/velocity.properties</value>
		</property>
	</bean>

竟然在tomcat启动的时候报错：
信息: Velocimacro : added #springFormCheckboxes(  path options separator attributes ) : source = org/springframework/web/servlet/view/velocity/spring.vm
2011-3-28 17:32:29 org.springframework.ui.velocity.CommonsLoggingLogSystem logVelocityMessage
信息: Velocimacro : added #springShowErrors(  separator classOrStyle ) : source = org/springframework/web/servlet/view/velocity/spring.vm
2011-3-28 17:32:29 org.springframework.ui.velocity.CommonsLoggingLogSystem logVelocityMessage
信息: Velocimacro : added #springCloseTag(  ) : source = org/springframework/web/servlet/view/velocity/spring.vm
2011-3-28 17:32:29 org.springframework.ui.velocity.CommonsLoggingLogSystem logVelocityMessage
严重: Velocimacro : Velocimacro : Error using VM library : org/springframework/web/servlet/view/velocity/spring.vm
2011-3-28 17:32:29 org.springframework.ui.velocity.CommonsLoggingLogSystem logVelocityMessage
严重: java.lang.NumberFormatException: For input string: "0 "
at java.lang.NumberFormatException.forInputString(Unknown Source)
at java.lang.Integer.parseInt(Unknown Source)
at java.lang.Integer.<init>(Unknown Source)
at org.apache.commons.collections.ExtendedProperties.getInteger(ExtendedProperties.java:1390)
at org.apache.commons.collections.ExtendedProperties.getInteger(ExtendedProperties.java:1343)
at org.apache.commons.collections.ExtendedProperties.getInt(ExtendedProperties.java:1315)
at org.apache.velocity.runtime.RuntimeInstance.getInt(RuntimeInstance.java:1337)
at org.apache.velocity.runtime.directive.Foreach.init(Foreach.java:327)