扩展Velocity,实现模板的继承
与我之前的扩展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/
页:
[1]