Velocity是一种基于JAVA的模板引擎，开发人员使用简单的模板语言就可以快速开发显示层，它使得显示层与程序代码分离，在早期的Webwork版本中，所有UI标签均使用Velocity模板引擎生成，可以在Struts-core-2.0.8.jar中找到template文件夹，其中的archive文件夹下存放着原有的vl文件！
在Struts2中查找vm文件的顺序先查找Web应用程序，再查找类路径。如果你需要使用vm作为显示层，只需要在配置文件中指定result的type属性为velocity，然后将<param>的location属性指定到一个以vm结尾的资源上就可以了！
1.Struts2中的Velocity中文乱码的处理方式：
因为在Velocity-1.4.jar中的org.apache.velocity.runtime.defaults中定义的velocity.properties中定义的input.encoding=ISO8859-1，output.encoding=ISO8859-1，通常最好在VM文件中使用%{getText(‘’)}调用国际化资源文件的内容就不会产生乱码。
2.Velocity的vm文件必须要经过Action才可以访问，以便被程序解析，不可以直接访问vm文件。
3.在vm文件中使用Struts2的标签只需要在原有标签前加#s就可以了，参数之间使用””分隔！
(1.)例如下面是一个表单的定义：
#sform(“action=Student” namespace=”/ilkj/student”)
#stextfield(“label=%{getText(‘student.label.name’)}” “name=student.name”)
#spassword(“label=%{getText(‘student.label.password’)} ” name=student.age”)
#ssubmit(“value=getText(‘globale.label.submit’)”)
#end
(2.)下面是取出session中的一个参数的值
#sproperty(“value=#session.information” “default=noValue”)
(3.)下面是访问Action中的属性
${student.name}，当然你也可以简单写成$student.name的形式。
4.Velocity的内建变量：
stack---ValueStack，可以使用${stack.findString(‘OGNL表达式’)}取值
action---最近执行的Action，例如${action.getStudent().getName()}或者也可以直接写${action.student.name}
response---HttpServletRequest
request---HttpServletResponse
session---HttpSession
application---ServletContext
base---生成应用的上下文，相当与request.getContextPath()
5.注释语法
(1.)单行注释：##
(2.)多行注释：#* ... ... *#
6.暂停执行
#stop---停止执行后面的模板内容
7.转义字符
Velocity使用 \ 转义字符，例如email被定义为andrew830314@163.com（#set($email=’andrew830314@163.com’)），你还想输出$email而不被Velocity解析，那么你可以使用 \$email。
8.引入其他文件
#include(“”)，如果是JSP或者vm文件将会显示内容，其他文本文件显示文本，二进制会显示乱码，引入多个文件使用 , 间隔，#parse(“”)引入一个本地的vm文件，与#include(“”)不同，#parse(“”)只能引入一个文件，并且#parse(“”)可以访问父模板里的变量。
9.模板代码复用
#macro(代码段名称 $参数1 ... ...)
... ...
#end
只要使用#代码段名称($参数1 ... ...)就可以使用这段代码，当然你也可以不使用任何参数
10.判断语句
#if(逻辑表达式)
注意：在Velocity中使用==判断两个变量是否相等，而不是使用equals(“”)方法。
#else
#end
从上面我们还可以总结出，Velocity模板引擎使用#表示一种命令，例如#set是给某个变量设置值，使用$引用变量，使用()表示参数，使用{}表示作用范围。
另外需要注意的时候，Velocity只会按照gettXXX()解析变脸变量，例如student.name实际上找到的student.getName()方法，你可以试着在Action写一个变量而不使用getXXX()方法，看看会不会在vm中取到值，答案是变量会被原样输出。
Velocity使用的都是对象，即使你定义#set ($count=1)也会被包装成Integer使用。
另外，修改vm文件需要重新启动服务器，如果在开发阶段，我们可以设置struts.properties中的struts.devMode=true避免每次重新启动服务器。
最后我们思考一下，如果货币$2.95会被Velocity引擎直接输出，还是去查找2.95这个变量？如果你在思考这个问题，说明你的JAVA基础不过关哦！因为JAVA中的变量不能以数字开头的哦！因此你不必担心货币$2.95会被当作变量解析！另外，如果Velocity引擎未找到变量也会原样输出，例如${student.name}如果未找到会直接原样输出，这也是为什么我们直接访问JSP的时候会看到大量的${}被原样输出。如果变量不存在,你想让它不输出,可以这样写$!{}
使用Struts2整合Velocity或者FreeMarker配置如上的Servlet就可以在模板引擎中使用Struts2的标签了。
不需要在模板页面中像JSP那样引用，前缀都是s在Velocity使用#s...在FreeMarker使用@s. ..。
Velocity：
- HTML code
- <html> <head> <title>UI Tags Example</title> #shead() #sxhead() </head> <body> #surl ("id=url" "value=index.jsp") <a href="${url}">Back to index.jsp</a>! #sform ("action=exampleSubmitVelocity" "method=post" "enctype=multipart/form-data") #stextfield ("label=Name" "name=name") #sxdatetimepicker ("label=Birthday" "name=birthday") #sxdatetimepicker ("label=Wake up time" "name=wakeup" "type=time") #stextarea ("label=Biography" "name=bio" "cols=20" "rows=3") #sselect ("label=Favourite Color" "list={'Red', 'Blue', 'Green'}" "name=favouriteColor" "emptyOption=true" "headerKey=None" "headerValue=None") #sselect ("label=Favourite Language" "list=favouriteLanguages" "name=favouriteLanguage" "listKey=key" "listValue=description" "emptyOption=true" "headerKey=None" "headerValue=None") #scheckboxlist ("label=Friends" "list={'Patrick', 'Jason', 'Jay', 'Toby', 'Rene'}" "name=friends") #scheckbox ("label=Age 18+" "name=legalAge") #sdoubleselect ("label=State" "name=region" "list={'North', 'South'}" "value='North'" "doubleValue='Florida'" "doubleList=top == 'North' ? {'Oregon', 'Washington'} : {'Texas', 'Florida'}" "doubleName=state" "headerKey=-1" "headerValue=---------- Please Select ----------" "emptyOption=true" ) #sdoubleselect ("label=Favourite Vehical" "name=favouriteVehicalType" "list=vehicalTypeList" "listKey=key" "listValue=description" "value='MotorcycleKey'" "doubleValue='YamahaKey'" "doubleList=vehicalSpecificList" "doubleListKey=key" "doubleListValue=description" "doubleName=favouriteVehicalSpecific" "headerKey=-1" "headerValue=---------- Please Select ----------" "emptyOption=true" ) #sfile ("label=Picture" "name=picture") #soptiontransferselect ("label=Favourite Cartoons Characters" "name=leftSideCartoonCharacters" "leftTitle=Left Title" "rightTitle=Right Title" "list={'Popeye', 'He-Man', 'Spiderman'}" "multiple=true" "headerKey=headerKey" "headerValue=--- Please Select ---" "emptyOption=true" "doubleList={'Superman', 'Mickey Mouse', 'Donald Duck'}" "doubleName=rightSideCartoonCharacters" "doubleHeaderKey=doubleHeaderKey" "doubleHeaderValue=--- Please Select ---" "doubleEmptyOption=true" "doubleMultiple=true" ) #ssubmit() #sreset() #end #sa("href=${url}")Back to index.jsp#end </body> </html>
FreeMarker：
- HTML code
- <@s.form action="test"> <@s.textfield label="Name" name="name"/> <@s.select label="Birth Month" headerValue="Select Month" list="months" /> </@s.form>
