Velocity的扩展

   之前一直找不到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工具的原理就一目了然咯~~