进一步提升 Struts 2 对 Velocity 的支持力度-1
|
- UID
- 1066743
|
进一步提升 Struts 2 对 Velocity 的支持力度-1
Struts 2 是 Struts 框架的一个全新版本，它废弃了原有 Struts 1.x 的框架结构，在 WebWork 的基础上全面提升了代码的配置灵活性、可测试性以及超强的扩展性。Struts 2 更是提供了对 Velocity 和 FreeMarker 模板引擎的支持，这破天荒的举动大大的方便了 Velocity 和 FreeMarker 的开发者，从而也更有效的推动了模板技术的发展。
在进行 Struts 2 和 Velocity 结合的试验中发现下面几个问题：
- 与 VelocityTools 1.3 存在兼容性问题；
- 不支持 Velocity Layout；
- 处理 velocity 模板时存在编码问题；
好在由于 Struts 2 的超强扩展性，使得这三个问题的解决变得非常简单，而且我们无需修改 Struts 2 的源码，下面分别给出三个问题的解决办法。
第一个问题：与 VelocityTools 1.3 存在兼容性问题这个问题是因为 VelocityTools 这个项目从 1.2 升级到 1.3 时修改了一些类的方法（Method）导致的。在 1.3 这个版本中 ToolboxManager 类的 getToolboxContext 方法改名为 getToolbox，因此在启动程序的时候就会报 getToolboxContext 方法没找到的异常。
Struts 2 是在 VelocityManager 类的 createContext 方法中调用 ToolboxManager 的，而 Struts 2 允许通过配置来修改 VelocityManager 的实现类，因此我们只需要从 VelocityManager 继承一个子类，并重写 createContext 方法即可。重写的代码很简单，直接从 VelocityManager 的 createContext 方法中拷贝代码然后将 getToolboxContext 改为 getToolbox。
接着需要修改 Struts 2 的配置来启用这个新的子类，配置如下（struts.xml）：
1
| <constant name="struts.velocity.manager.classname" value="struts2.VelocityFixedManager"/>
|
或者是 struts.properties：
1
| struts.velocity.manager.classname = struts2.VelocityFixedManager
|
第二个问题：不支持 Velocity Layout首先简单的介绍一下 Velocity 的 Layout 技术。Velocity 的 Layout 是通过 VelocityTools 这个项目来实现的。大多数网站上每个页面基本上都会遵循相同的排版，例如一个页面由 banner 条、内容和底部版权说明组成。那么对于该网站上的每个网页，我们都需要编写重复的代码来显示 banner 条以及底部版权说明。而 Velocity 的 Layout 技术可以让我们把页面的布局和页面的内容分开到不同 velocity 模板文件中。要使用 Layout 技术只需要把 VelocityViewServlet 换成 VelocityLayoutServlet 即可。VelocityLayoutServlet 内置了一个变量 $screen_content，它首先执行内容模板页面并把执行后的字符串结果存入 $screen_content 变量中，然后再去执行布局页面，这样就相当于把内容页面嵌入到布局页面。
关于 ResultTypeStruts 2 中把各种各样的视图例如 JSP、Velocity、FreeMarker 等等都封装成 ResultType 的子类，也就是说每一种视图 Struts 2 都有与之对应的 ResultType 的实现类， 本文中 Velocity 视图对应的类是 VelocityResult
但是这个问题在 Struts 2 环境中就要麻烦很多。因为 Struts 2 并不是采用 Velocity Tools 那种基于 Servlet 的方式来调用 velocity 模板，所以我们没法只是简单的替换成 VelocityLayoutServlet 就能解决。在 Struts 2 的默认配置中定义了一个名为 velocity 的 ResultType，它对应的类是 org.apache.struts2.dispatcher.VelocityResult 。该类没有跟 Velocity Tools 打交道，而是直接调用 Velocity 的核心 API 来执行 velocity 模板。因此我们只好根据 Velocity Tools 项目中 VelocityLayoutServlet 的思路来改写 Struts 2 对 velocity 模板的处理方法。
在处理之前我们先大概解释一下 VelocityLayoutServlet 的工作原理，先看几个程序源码：
1
2
3
4
5
6
7
8
9
10
11
| <!-- layout.vm -- >
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<HTML>
<HEAD>
<TITLE>${page_title}</TITLE>
</HEAD>
<BODY>
${screen_content}
</BODY>
</HTML>
|
上面是布局页面的代码，这个布局页面包含两个变量，一个是 $page_title，用来指定页面标题；第二个是 $screen_content，这是 VelocityLayoutServlet 定义的变量，这个变量最终会被替换成实际页面的内容。
1
2
3
4
5
6
7
| ## index.vm
#set($layout = “layout.vm”) ##选择布局页面
#set($page_title =”Struts2Velocity”)
#set($name = “Winter Lau”)
<p>
Hello <b>$name</b>, Welcome to Struts2 with velocity <br/>
</p>
|
上面是另外一个页面 index.vm 的代码。当 VelocityLayoutServlet 处理 index.vm 时，首先执行 index.vm，并把执行后的结果保存在一个字符串中，并往 VelocityContext 中增加变量名为 $screen_content，值为 index.vm 的执行结果，然后执行 layout.vm 页面，这样最终呈现在用户面前的就是 index.vm 嵌入在 layout.vm 的效果。
因此我们可以依照上面的原理，从 VelocityResult 中继承一个子类并重写其 doExecute 这个方法。详细的代码请看附件中的源码。
类编写完毕同样需要对 Struts 进行如下配置（struts.xml），这个配置是告诉 Struts 使用 struts2.VelocityLayoutResult 这个类来处理采用 velocity 开发的视图：
1
2
3
| <result-types>
<result-type name="velocity" class="struts2.VelocityLayoutResult"/>
</result-types>
|
接下来就可以测试新的功能了，我们配置 action 如下，打开浏览器访问 http://localhost:<port>/index.do 看看效果吧。
1
2
3
| <action name="index">
<result type="velocity">/index.vm</result>
</action>
|
这样我们不需要 VelocityTools 也可以让 Struts 2 支持 Velocity Layout 了。 |
|
|
|
|
|
