WebWork2教程（中文版）(4.2)
4.2、在WebWork中使用Velocity
使用Velocity作为视图，有两种方法：
l 使用velocity结果类型来呈现Velocity模板
l 在web.xml中注册WebWorkVelocityServlet，直接请求Velocity模板文件来呈现；这种方法要在web.xml中为WebWorkVelocityServlet添加一个Servlet映射，如下：
<servlet>
<servlet-name>velocity</servlet-name>
<servlet-class>com.opensymphony.webwork.views.velocity.WebWorkVelocityServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>velocity</servlet-name>
<url-pattern>*.vm</url-pattern>
</servlet-mapping>
使用velocity结果类型意味着Velocity模板是通过Action来呈现。如果访问.vm文件，不会呈现该文件，而是返回文本文件。因此，Velocity模板文件应该放在WEB-INF目录下，使其无法直接访问。
使用WebWorkVelocityServlet意味着可以通过请求.vm文件来呈现Velocity模板，这可能需要在模板中实现安全检查。
无论使用哪种方法，在写模板时，Velocity的所有特性都是有效的，并且有一些WebWork的特定功能可以使用。这里假设你对Velocity很熟悉，重点放在WebWork的特定功能上。
（1）WebWork的特定功能
WebWork在Value Stack中提供了一些可以访问的对象，包括：
l 当前的HttpServletRequest
l 当前的HttpServletResponse
l 当前的OgnlValueStack
l OgnlTool实例
l 当前Action类的所有属性
要访问Value Stack中的对象，需要在模板中正确使用Velocity引用：
l $req=HttpServletRequest
l $res=HttpServletResponse
l $stack=OgnlValueStack
l $ognl=OgnlTool
l $name-of-property=当前Action类的属性
（2）使用velocity结果类型
下面的例子是使用Velocity模板作为结果，来实现前面的Hello例子，注意<property value="person" />标记被$person引用所替代：
xwork.xml：
<!DOCTYPE xwork PUBLIC "-//OpenSymphony Group//XWork 1.0//EN"
"http://www.opensymphony.com/xwork/xwork-1.0.dtd">
<xwork>
<!-- Include webwork defaults (from WebWork-2.1 JAR). -->
<include file="webwork-default.xml" />
<!-- Configuration for the default package. -->
<package name="default" extends="webwork-default">
<!-- Default interceptor stack. -->
<default-interceptor-ref name="defaultStack" />
<!-- Action: Lesson 4.2: HelloAction using Velocity as result. -->
<action name="helloVelocity" class="lesson03.HelloAction">
<result name="error" type="dispatcher">ex01-index.jsp</result>
<result name="success" type="velocity">ex01-success.vm</result>
</action>
</package>
</xwork>
HelloAction.java：（同前面的例子）
ex01-index.jsp：（同前面的例子）
ex01-success.vm：
<html>
<head>
<title>WebWork Tutorial - Lesson 4.2 - Example 1</title>
</head>
<body>
Hello, $person
</body>
</html>
（3）在Velocity中使用WebWork标记
使用Velocity模板替代JSP标记，会失去使用JSP标记的能力。然而，WebWork的Velocity Servlet提供了一种在Velocity模板中使用JSP标记的方法：使用#tag、#bodytag和#param Velocimacros。下面是通用语法：
#tag (name-of-tag list-of-attributes)
或：
#bodytag (name-of-tag list-of-attributes)
#param (key value)
#param (key value)
...
#end
下面的例子使用Velocity实现4.1.1节中示范UI标记用法的例子：
xwork.xml：
<!DOCTYPE xwork PUBLIC "-//OpenSymphony Group//XWork 1.0//EN"
"http://www.opensymphony.com/xwork/xwork-1.0.dtd">
<xwork>
<!-- Include webwork defaults (from WebWork-2.1 JAR). -->
<include file="webwork-default.xml" />
<!-- Configuration for the default package. -->
<package name="default" extends="webwork-default">
<!-- Default interceptor stack. -->
<default-interceptor-ref name="defaultStack" />
<!-- Actions: Lesson 4.2: FormProcessingAction using Velocity. -->
<action name="formProcessingVelocityIndex" class="lesson04_02.FormProcessingIndexAction">
<result name="success" type="velocity">ex02-index.vm</result>
</action>
<action name="formProcessingVelocity" class="lesson04_01_01.FormProcessingAction">
<result name="input" type="velocity">ex02-index.vm</result>
<result name="success" type="velocity">ex02-success.vm</result>
<interceptor-ref name="validationWorkflowStack" />
</action>
</package>
</xwork>
ex02-index.vm：
<html>
<head>
<title>WebWork Tutorial - Lesson 4.2 - Example 2</title>
<style type="text/css">
.errorMessage { color: red; }
</style>
</head>
<body>
<p>UI Form Tags Example using Velocity:</p>
#bodytag (Form "action='formProcessingVelocity.action'" "method='post'")
#tag (Checkbox "name='checkbox'" "label='A checkbox'" "fieldValue='checkbox_value'")
#tag (File "name='file'" "label='A file field'")
#tag (Hidden "name='hidden'" "value='hidden_value'")
#tag (Label "label='A label'")
#tag (Password "name='password'" "label='A password field'")
#tag (Radio "name='radio'" "label='Radio buttons'" "list={'One', 'Two', 'Three'}")
#tag (Select "name='select'" "label='A select list'" "list={'One', 'Two', 'Three'}"
"emptyOption=true")
#tag (Textarea "name='textarea'" "label='A text area'" "rows='3'" "cols='40'")
#tag (TextField "name='textfield'" "label='A text field'")
#tag (Submit "value='Send Form'")
#end
</body>
</html>
ex02-success.vm：
<html>
<head>
<title>WebWork Tutorial Lesson 4.2 - Example 2</title>
</head>
<body>
<p>UI Form Tags Example result using Velocity:</p>
<ul>
<li>checkbox: $!checkbox</li>
<li>file: $!file</li>
<li>hidden: $!hidden</li>
<li>password: $!password</li>
<li>radio: $!radio</li>
<li>select: $!select</li>
<li>textarea: $!textarea</li>
<li>textfield: $!textfield</li>
</ul>
</body>
</html>
FormProcessingAction.java：（同4.1.1节的例子）
FormProcessingAction-validation.xml：（同4.1.1节的例子）
下面的例子使用Velocity实现4.1.1节中自定义组件的例子，注意#param的用法：
ex03.vm：
<html>
<head>
<title>WebWork Tutorial - Lesson 4.2 - Example 3</title>
</head>
<body>
<p>Custom Component Example:</p>
<p>
#bodytag (Component "template=/files/templates/components/datefield.vm")
#param ("label" "Date")
#param ("name" "mydatefield")
#param ("size" "3")
#end
</p>
</body>
</html>
/files/templates/components/datefield.vm：（同4.1.1节的例子）
4.3、在WebWork中使用Freemaker（略）
