扩展Velocity,实现模板的继承

badqiu · 发表于 2013-2-7 16:03:42

与我之前的扩展freemarker类似，现新增加三个指令：block,override,extends
一.目的：

父模板页面定义好布局,子模板可以重定义布局中的部分内容
使模板可以实现类似"类"的继承关系,并不限继承层次

二.继承概榄：

父模板：base.vm
<html><head>#block("head") base_head_content #end </head><body> #block("body") base_body_content #end</body></html>
子模板: child.vm

#override("body")<div class='content'>Powered By rapid-framework</div> #end#extends("base.vm") 子模板child.vm输出

<html><head>base_head_content </head><body> <div class='content'>Powered By rapid-framework</div> </body></html> 可以看到，输出中body部分被子模板重定义(override)了，而head部分则还是显示父模板(block)中的内容。

三.指令介绍:

#block : 定义块，可以被子模板用#override指令覆盖显示
#override : 覆盖#block指令显示的内容
#extends : 继承其它模板，必须放在模板的最后面（注：该指令完全等价于#parse指令，只是为了提供统一的语义，即extends比parse更好理解）

四.使用说明:

在velocity的properties中可以设置:
userdirective=cn.org.rapid_framework.velocity.directive.BlockDirective,cn.org.rapid_framework.velocity.directive.OverrideDirective,cn.org.rapid_framework.velocity.directive.ExtendsDirective然后再初始化，即中使用自定义指令：velocityEngine.init(properties);使用注意(关乎性能):
必须为velocity的ResourceLoader开启cache,因为 engine.getTemplate(name) 默认是没有使用cache的,而#extends是需要经常调用该函数,所以必须为ResourceLoader指定开启cache,如FileResourceLoader

file.resource.loader.cache = true
以上三个指令属于rapid-framework的扩展，后续新版本发布将包含该项扩展，敬请关注。
具体指令源码请查看:
http://rapid-framework.googlecode.com/svn/trunk/rapid-framework/src/rapid_framework_common/cn/org/rapid_framework/velocity/directive/

		自动登录	找回密码
密码			立即注册