Struts2与Velocity模板

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
   
   >