badqiu

XPer
随笔 - 46, 文章 - 3, 评论 - 195, 引用 - 0
数据加载中……

扩展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/

posted on 2009-12-28 20:55 badqiu 阅读(3448) 评论(0)  编辑  收藏


只有注册用户登录后才能发表评论。


网站导航: