一.目的
- 父模板页面定义好布局,子模板可以重定义布局中的部分内容
- 使模板可以实现类似"类"的继承关系,并不限继承层次
二.继承概榄
父模板: base.ftl<head>
<@block name="head">base_head_content</@block>
</head>
<body>
<@block name="body">base_body_content</@block>
</body>
</html>
<div class='content'>
Powered By rapid-framework
</div>
</@override>
<@extends name="base.flt"/>
子模板child.ftl输出
<head>
base_head_content
</head>
<body>
<div class='content'>
Powered By rapid-framework
</div>
</body>
</html>
三.指令介绍
- @block : 定义块,可以被子模板用@override指令覆盖显示
- @override : 覆盖@block指令显示的内容
- @extends : 继承其它模板,必须放在模板的最后面(注:该指令完全等价于#include指令,只是为了提供统一的语义,即extends比include更好理解)
四.使用说明
要使用如上三个自定义指令,必须在freeemarker的Configuration中注册。使用如下代码:configuration.setSharedVariable("override", new OverrideDirective());
configuration.setSharedVariable("extends", new ExtendsDirective());
PS :项目中的配置,如:springmvc-servlet.xml
<!-- freemarker config for FreeMarkerViewResolver -->
<bean id="freemarkerConfig"
class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
<property name="templateLoaderPath" value="/freemarker/" />
<property name="defaultEncoding" value="GBK" />
<property name="freemarkerVariables">
<map>
<entry key="extends" value-ref="extendsDirective"></entry>
<entry key="override" value-ref="overrideDirective"></entry>
<entry key="block" value-ref="blockDirective"></entry>
<entry key="super" value-ref="superDirective"></entry>
</map>
</property>
</bean>