velocity与freemaker、jstl并称为java web开发三大标签技术，而且velocity在codeplex上还有.net的移植版本NVelocity，(注：castle团队在github上也维护了一个版本)对于使用异构技术的团队（即要搞.NET又要搞JAVA），总是希望找一种通用的技术，兼容所有技术平台，以便降低学习成本，无疑velocity是一种值得考虑的选择。

一、与strtus2的集成

         <dependency>

             <groupId>org.apache.velocity</groupId>

             <artifactId>velocity</artifactId>

             <version>1.7</version>

         </dependency>

         <dependency>

             <groupId>org.apache.velocity</groupId>

             <artifactId>velocity-tools</artifactId>

             <version>2.0</version>

         </dependency>

pom.xml中加入这二项即可，其它不用刻意配置。struts2同时支持jstl(.jsp)、velocity(.vm)、freemaker(.ftl)三种模板。

二、定义变量

   #set($awbpre='112')

   #set($awbno='89089011')

   #set($airwayBillNo=$awbpre+' - '+$awbno)

   $awbpre - $awbno <br/>

   $airwayBillNo

velocity的语法符号大概分二类，一类用#开头，代表控制符号，#set表示定义变量，另一类用$开头，通常用于显示变量，上面的示例定义了三个变量：
awbpre 值为'112'，awbno值为'89089011'，airwayBillNo值为 '112 - 89089011'

第4,5二行输出内容

三、遍历数组

   #set($list = ["CTU", "SHA", "LAX"])

   #foreach ($item in $list)

      $velocityCount . $item <br/>

   #end

解释：定义了一个数组，然后遍历输出，其中velocityCount为索引变量

四、遍历HashTable

   #foreach($key in $table.keySet())

     $key -> $table.get($key)<br/>

   #end

五、判断是否为空

       #if($null.isNull($orderList.orders) || $orderList.orders.size()==0)

           订单列表为空

       #else

           订单列表：<br/>

           #foreach ($order in $orderList.orders)

               $velocityCount: $order.id / $order.clientName / $order.amount / $order.createTime<br/>

           #end

       #end

上面是判断集合是否为空的，如果判断单个对象是否为空，参考下面这样：

     #if($(orderDto))

         订单对象有值

     #else

         订单对象为空

     #end

     #if(!$(orderDto))

         订单对象为空

     #else

         订单对象有值

     #end

六、宏示例

宏可以理解为“函数”，定义一个宏即相当于定义一个子函数，调用宏，即为调用子函数

     #macro(renderOrderList $orders)

         <table border="1">

           <tr>

               <th>Id</th>

               <th>ClientName</th>

               <th>Amount</th>

               <th>CreateTime</th>

           </tr>

           #foreach($o in $orders)

             <tr><td>$o.id</td><td>$o.clientName</td><td>$o.amount</td><td>$o.createTime</td></tr>

           #end

         </table>

     #end

     #renderOrderList($orderList.orders)

七、数值、日期格式化

     $order.createTime<br/>

     $date.year - $date.month - $date.day <br/>

     $date.format('yyyy-MM-dd HH:mm:ss',$order.createTime,$locale)<br/>

     $date.format('MMMdd',$order.createTime,$locale)<br/>

     $convert.toLocale("en_US") <br/>

     $date.format('MMM,dd',$order.createTime,$convert.toLocale("en_US"))<br/>

     $date.format('yyyy-MM-dd',$order.createTime,$locale)<br/>

     $order.amount<br/>

     $number.format('0.00',$order.amount)<br/>
NumberTool中还有货币格式化的功能：$number.format("currency", $agentBillDto.feeTotal)

要使用格式化功能，需要加一点配置，struts.xml文件中加一行

<constant name="struts.velocity.toolboxlocation" value="WEB-INF/classes/toolbox.xml" />

然后在toolbox.xml中，参考下面的内容：

 <?xml version="1.0" encoding="UTF-8"?> 

 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"

     "http://www.w3.org/2002/xmlspec/dtd/2.10/xmlspec.dtd">

 <toolbox>

     <tool>

         <key>number</key>

         <scope>application</scope>

         <class>org.apache.velocity.tools.generic.NumberTool</class>

     </tool>

     <tool>

         <key>date</key>

         <scope>application</scope>

         <class>org.apache.velocity.tools.generic.DateTool</class>

     </tool>

     <tool>

         <key>text</key>

         <scope>request</scope>

         <class>org.apache.velocity.tools.struts.MessageTool</class>

     </tool>

     <tool>

         <key>convert</key>

         <scope>application</scope>

         <class>org.apache.velocity.tools.generic.ConversionTool</class>

     </tool>

 </toolbox>

这些XXXTool其实是一个很好的例子，因为velocity的vm文件里不能直接写java代码，如果我们想扩展一些常用方法，可以将一些常用方法写成XXXTool工具类，然后在toolbox中注册即可。

八、国际化

  当前语言环境：$locale <br/>

  #stext("name=%{getText('appName')}")

虽然Velocity-Tools 2.0中提供了MessageTool，但是我一直没尝试成功，只能借助struts2本身的标签来处理了。struts2中首先得定义国际化资源文件的BaseName

 <constant name="struts.custom.i18n.resources" value="message"></constant>

然后在classPath目录下，放二个文件message_zh_CN.properties、message_en_US.properties，里面放一个appName=XXX的内容，用#stext就能取到国际化的内容了

九、使用struts2标签

虽然有了velocity基本上可以告别struts2的那一堆tags，但是如果怀念struts2里的标签，也可以继续使用，方法：以“#s”开头就行了，参考下面的示例：

 #stextarea ("label=Biography" "name=bio" "cols=20" "rows=3") <br/>

 #sselect("label=Favourite Color" "list={'Red', 'Blue', 'Green'}" "name=favouriteColor" "emptyOption=true" "headerKey=None" "headerValue=None")    <br/>

十、内建对象

 $request<br/>

 name = $request.getParameter("name")<br/>

 $session<br/>

Velocity可以直接使用struts2的很多内置对象，比如Request、Session、Response，上面的示例演示了如何获取 url请求参数

十一、include、parse实现布局模块化

每个页面，通常会有一些公用的头、尾，可以用include或parse来包括其它vm文件（或txt/html文件），这二个的区别在于include只是简单的把其它文件导入进来，不会执行任何vm语法的解析。而parse导入其它vm文件时，如果其它vm文件里有一些指令，比如定义变量，定义宏之类，parse会解析执行。

 #parse("template/header.vm")

 #include("template/footer.vm")

关于加载的路径，这里要重点解释一下，官方文档上也讲得不清不楚，Velocity支持二种路径加载机制，按classPath或按filePath，默认是按classPath路径加载，即：只要被包含的.vm文件在/WEB-INF/classes目录下即可。上面的示例，将在/WEB-INF/classes/template目录下，搜索header.vm、footer.vm这二个文件，如果找到就加载，否则出错。

最后谈下IDE以.vm的可视化支持问题，目前最新的eclipse上，暂无好用的插件(googlecode上的插件大多已经没人维护了，与最新的eclipse不兼容)，建议使用IntelliJ Idea，它对vm的可视化支持程度较好。

更详细的用法，请参考下面官司文档：

Velocity Engine 用户指南

Velocity Engine 开发人员指南

Velocity Tools 用法概述

velocity模板引擎学习(1)的更多相关文章

  1. velocity模板引擎学习(4)-在standalone的java application中使用velocity及velocity-tools

    通常velocity是配合spring mvc之类的框架在web中使用,但velocity本身其实对运行环境没有过多的限制,在单独的java application中也可以独立使用,下面演示了利用ve ...

  2. velocity模板引擎学习(3)-异常处理

    按上回继续,前面写过一篇Spring MVC下的异常处理.及Spring MVC下的ajax异常处理,今天看下换成velocity模板引擎后,如何处理异常页面: 一.404错误.500错误 <e ...

  3. velocity模板引擎学习(2)-velocity tools 2.0

    使用velocity后,原来的很多标签无法使用了,必须借助velocity tools来完成,目前velocity tools最新版本是2.0,下面是velocity tools的一些注意事项: 1. ...

  4. 使用 Velocity 模板引擎快速生成代码(zhuan)

    http://www.ibm.com/developerworks/cn/java/j-lo-velocity1/ ****************************************** ...

  5. 使用Velocity 模板引擎快速生成代码

    Velocity 模板引擎介绍 在现今的软件开发过程中,软件开发人员将更多的精力投入在了重复的相似劳动中.特别是在如今特别流行的MVC架构模式中,软件各个层次的功能更加独立,同时代码的相似度也更加高. ...

  6. Velocity模板引擎语法

    Velocity 模板引擎介绍 Velocity是一个基于java的模板引擎(template engine).它允许任何人仅仅简单的使用模板语言(template language)来引用由java ...

  7. Velocity模板引擎入门

    类似于PHP中的Smarty,Velocity是一个基于Java的模板引擎(template engine).它允许任何人仅仅简单的使用模板语言(template language)来引用由java代 ...

  8. 【转载】Velocity模板引擎的介绍和基本的模板语言语法使用

    原文地址http://www.itzhai.com/the-introduction-of-the-velocity-template-engine-template-language-syntax- ...

  9. 转 如何使用velocity模板引擎开发网站

    基于 Java 的网站开发,很多人都采用 JSP 作为前端网页制作的技术,尤其在是国内.这种技术通常有一些问题,我试想一下我们是怎样开发网站的,通常有几种方法: 1:功能确定后,由美工设计网页的UI( ...

随机推荐

  1. Hadoop概念学习系列之Hadoop 生态系统（十二）

    当下 Hadoop 已经成长为一个庞大的生态体系,只要和海量数据相关的领域,都有 Hadoop 的身影.下图是一个 Hadoop 生态系统的图谱,详细列举了在 Hadoop 这个生态系统中出现的各种数 ...

  2. MongoDB-安装&启动

    MongoDB安装 使用的版本为3.0,虚拟机操作系统为rhel-server-7.0-x86_641. 将mongodb-linux-x86_64-rhel70-3.0.11.tgz上传并解压到 / ...

  3. PreferenceScreen监听子项的刷新

    有个PreferenceScreen,他有一些个子项目.它的Summary需要根据子项的设置来改变的,所以需要监听子项的刷新事件. preferenceScreen.setOnPreferenceCh ...

  4. 十五天精通WCF——第二天 告别烦恼的config配置

    经常搞wcf的基友们肯定会知道,当你的应用程序有很多的“服务引用”的时候,是不是有一种疯狂的感觉...从一个环境迁移到另外一个环境,你需要改变的 endpoint会超级tmd的多,简直就是搞死了人.. ...

  5. 按要求编写一个Java应用程序： （1）编写一个矩形类Rect，包含： 两个属性：矩形的宽width；矩形的高height。 两个构造方法： 1．一个带有两个参数的构造方法，用于将width和height属性初化； 2．一个不带参数的构造方法，将矩形初始化为宽和高都为10。 两个方法： 求矩形面积的方法area() 求矩形周长的方法perimeter() （2）通过继承Rect类编写一个具有确定位

    package com.hanqi.test; public class Rect { ; ; public double getWidth() { return width; } public vo ...

  6. Java设计模式学习笔记（单例模式）

    最近一直在看<Head First设计模式>,这本书写的确实是很不错的,专注于怎么用最简单的方式最通俗的语言让人了解设计模式.据说GoF的设计模式那本书写的很好,是一本经典,但是就是难懂, ...

  7. oracle 数据库导出数据

    cmd导出数据: exp  ZD_ZD_ZDWW/zdzd1402!@11.111.111.213/orcl file=c:\1234.dmp owner=ZD_ZD_ZDWW

  8. MySQL-procedure(cursor,loop)

    现有一张表spam_keyword,共629条记录,每条记录的word字段的字符数量不等. CREATE TABLE `spam_keyword` ( `kid` ) NOT NULL, `word` ...

  9. Eclipse快捷键-方便查找

    [Ct rl+T] 搜索当前接口的实现类 1. [ALT +/]    此快捷键为用户编辑的好帮手,能为用户提供内容的辅助,不要为记不全方法和属性名称犯愁,当记不全类.方法和属性的名字时,多体验一下[ ...

  10. 网页中导入特殊字体@font-face属性详解

    @font-face是CSS3中的一个模块,他主要是把自己定义的Web字体嵌入到你的网页中. 语法规则 首先我们一起来看看@font-face的语法规则: @font-face { font-fami ...