OnlyLonely & Marshall’s

之前一直找不到velocity的扩展接口，导致工作一直做不下去。今天看了一个下午＋一个晚上的文档，终于找到了突破口（看来我是挺笨的）。就在VelocityTools这一块。
在IBM实习时养成的很好的习惯－－看源码－－真是受用终身啊。通过不断的对比VelocityTools的文档，javadoc和源码，发现原来在那个toolbox.xml里大有文章。

首先，要指定toolbox.xml的位置，在web.xml里

<servlet>
<servlet-name>velocity</servlet-name>
<servlet-class>org.apache.velocity.tools.view.servlet.VelocityViewServlet</servlet-class>
<load-on-startup>10</load-on-startup>
<init-param>
<param-name>org.apache.velocity.toolbox</param-name>
<param-value>/WEB-INF/toolbox.xml</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>velocity</servlet-name>
<url-pattern>*.vm</url-pattern>
</servlet-mapping>

这是toolbox.xml的一部份：

<toolbox>

<tool>
<key>math</key>
<scope>application</scope>
<class>org.apache.velocity.tools.generic.MathTool</class>
<request-path>/catalog/*</request-path>
</tool>

</toolbox>

<key>里就是在VTL里写的$math，这样就算引入一个对象了。
<scope>是生命周期，有关init()方法的调用。
其它两个的作用从字面上和表达就可以猜出来了。

对于扩展的类，与web容器相关的主要是一个public void init(java.lang.Object object)的方法，传入的参数是org.apache.velocity.tools.view.context.ViewContext接口，但需要手动转换。从这个接口，可以得到request, session, response, servletContext等对象，同时根据scope的不同在调用次数上也会有不同。application的只初始化一次，request每次请求都会重新初始化，session就是在session建立时初始化。
看过这些以后，对那些VelocityStruts工具的原理就一目了然咯~~