struts2 与 velocity 整合 探究

我这边引出几个问题。

问题1，struts2 是怎么让 velocity 按照指定的 ResourceLoader 加载 vm 模板的?

 

首先，struts 默认的查找vm模板的路径有两种：

1，以 webapp 为相对路径下面去找

2，从 classpath 下面去找

那么看下面的代码 org.apache.struts2.views.velocity.VelocityManager：

private void applyDefaultConfiguration(ServletContext context, Properties p) {
        // ensure that caching isn't overly aggressive

        /**
         * Load a default resource loader definition if there isn't one present.
         * Ben Hall (22/08/2003)
         */
        if (p.getProperty(Velocity.RESOURCE_LOADER) == null) {
            p.setProperty(Velocity.RESOURCE_LOADER, "strutsfile, strutsclass");
        }

 

这里就指明了  velocity.RESOURCE_LOADER 有两个，一个是 stutsfile, 一个是 strutsclass;

 

然后分别指明了 这两个 resource.loader 的详细参数如下：

  p.setProperty("strutsfile.resource.loader.description", "Velocity File Resource Loader");
            p.setProperty("strutsfile.resource.loader.class", "org.apache.velocity.runtime.resource.loader.FileResourceLoader");
            p.setProperty("strutsfile.resource.loader.path", context.getRealPath(""));
            p.setProperty("strutsfile.resource.loader.modificationCheckInterval", "2");
            p.setProperty("strutsfile.resource.loader.cache", "true");

 

  p.setProperty("strutsclass.resource.loader.description", "Velocity Classpath Resource Loader");
        p.setProperty("strutsclass.resource.loader.class", "org.apache.struts2.views.velocity.StrutsResourceLoader");
        p.setProperty("strutsclass.resource.loader.modificationCheckInterval", "2");
        p.setProperty("strutsclass.resource.loader.cache", "true");

 

于是velocityEngine 引擎在初始化resource.loader 的时候就会初始化这2个loader 了。

 

那么，如果在开发阶段，不希望模板被cache ，能够修改完之后立马看到效果。可以在/WEB-INF/velocity.properties里面加上：

strutsclass.resource.loader.cache = false

strutsfile.resource.loader.cache = false

 

============================================================

问题2，struts2 怎么让 velocity 可以支持 layout ?

struts 2 自身带的velocityResult 是不支持 velocity 的layout的，它直接调用的是一个velocityEngine.如果需要它支持的话，需要仿照 velocity-tools中的

VelocityLayoutServlet 来重写 VelocityResult.

 

源代码请看附件

然后在struts.xml中进行配置

 <package name="babystore" extends="struts-default" abstract="true">
    	<result-types>
    		 <result-type name="velocity" class="com.yajun.babystore.common.struts.VelocityLayoutResult" default="true"/>
    	</result-types>
    </package>
    
	<package name="default" extends="babystore">
		<action name="HelloWorld" class="helloWorldClass">
			<result name="success">/success.vm</result>
		</action>

。。。。。。

 

 

参考： http://www.ibm.com/developerworks/cn/java/j-lo-struts2-velocity/index.html

 

============================================================

 

问题3，struts2 有哪些提供的方便的 tag，如何运用？

struts2 的tag 分为两种：

第一种 Generic Tag:http://struts.apache.org/2.2.1.1/docs/generic-tag-reference.html

第二种 UI Tags ：http://struts.apache.org/2.2.1.1/docs/ui-tags.html

 

这些Tag 都是Component的子类如图：

那么这些Component 怎么和velocity ,freemarke 或者其他模板结合的呢？ 我这里介绍和velocity结合的方式：

 

先看下图：

 

可以看到在velocity 这个包里面对上面的 component 都有对应的 类支持。

这些类都继承自org.apache.velocity.runtime.directive.Directive 

这个类是用来实现类似velocity 中的 #set 这样的语法的（前面带个#号的那种）

注意到还有个基类：

public abstract class AbstractDirective extends Directive {
    public String getName() {
        return "s" + getBeanName();
    }

 

发现在每个 beanName 前都加了个字符串s 。这就是为什么 velocity的模板中要用 #surl, #stext, #sform 的原因了。看到这段代码，也就不奇怪了。

 

那么知道了上面的东西之后，想看哪些tag 或者我叫做Component 的是常用的，或者怎么用，就看上面的源码吧。

 

 

问题4，struts2 如何支持 velocity-tools 的 toolbox ?

 

在struts.xml里配置

 

<constant name="struts.velocity.toolboxlocation" value="/WEB-INF/toolbox.xml"></constant>

 

然后再WEB-INF/toolbox.xml 下面加上：toolbox.xml

<?xml version="1.0"?>
<toolbox>
	<tool>
		<key>link</key>
		<scope>request</scope>
		<class>
			org.apache.velocity.tools.struts.StrutsLinkTool
     </class>
	</tool>
	<tool>
		<key>msg</key>
		<scope>request</scope>
		<class>
			org.apache.velocity.tools.struts.MessageTool
     </class>
	</tool>
	<tool>
		<key>errors</key>
		<scope>request</scope>
		<class>
			org.apache.velocity.tools.struts.ErrorsTool
     </class>
	</tool>
	<tool>
		<key>form</key>
		<scope>request</scope>
		<class>
			org.apache.velocity.tools.struts.FormTool
     </class>
	</tool>
	<tool>
		<key>tiles</key>
		<scope>request</scope>
		<class>
			org.apache.velocity.tools.struts.TilesTool
     </class>
	</tool>
	<tool>
		<key>validator</key>
		<scope>request</scope>
		<class>
			org.apache.velocity.tools.struts.ValidatorTool
     </class>
	</tool>
</toolbox>

 

问题5，struts 与 velocity 整合以后，有哪些内置的变量可以直接用？

• req - the current HttpServletRequest
• res - the current HttpServletResponse
• stack - the current OgnlValueStack
• ognl - an instance of OgnlTool
• ui - a (now deprecated) instance of a ui tag renderer