WebWork2教程（中文版）(4.2)_webwork2官方文档中文版,pdf格式-CSDN博客

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>

&


<script type="text/javascript">
  
  
</script>
<script type="text/javascript"
src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
</script>
  
  
   
   <script type="text/javascript">
   
   
</script><script type="text/javascript"
src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
</script>