项目地址:http://tiles.apache.org/
1. 配置
单独配置方案: 在 web.xml 中注册 tiles初始化servlet
<context-param> <param-name>org.apache.tiles.impl.BasicTilesContainer.DEFINITIONS_CONFIG</param-name> <param-value>/WEB-INF/tiles-defs.xml</param-value> </context-param> <listener> <listener-class>org.apache.tiles.web.startup.TilesListener</listener-class> </listener>
与 Spring MVC 集成配置方案:在 xxx-servlet.xml 中
<!-- 与模板框架 Tiles2 的集成 --> <bean id="tilesConfigurer" class="org.springframework.web.servlet.view.tiles2.TilesConfigurer"> <property name="definitions"> <list> <value>/WEB-INF/tiles/tiles-defs.xml</value> </list> </property> </bean> <!-- Tiles2 模板view解析 --> <bean id="viewResolver" class="org.springframework.web.servlet.view.UrlBasedViewResolver"> <property name="viewClass" value="org.springframework.web.servlet.view.tiles2.TilesView" /> </bean>
2. 使用方法
a. 定义模板页面 template.jsp
<%@ page contentType="text/html;charset=utf-8"%> <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%> <%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt"%> <%@ taglib uri="http://tiles.apache.org/tags-tiles" prefix="tiles"%> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <tiles:insertAttribute name="hrefBasepath"></tiles:insertAttribute> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title><tiles:getAsString name="title"/></title> <!-- css --> <tiles:insertAttribute name="commonCss"></tiles:insertAttribute> <!-- Javascripts --> <tiles:insertAttribute name="commonJs"></tiles:insertAttribute> </head> <body> <div id="body-wrapper"> <!-- Wrapper for the radial gradient background --> <tiles:insertAttribute name="menu"></tiles:insertAttribute> <tiles:insertAttribute name="body"></tiles:insertAttribute> </div> </body> </html>
b. 在 tiles-defs.xml 中定义和配置模板
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE tiles-definitions PUBLIC "-//Apache Software Foundation//DTD Tiles Configuration 2.1//EN" "http://tiles.apache.org/dtds/tiles-config_2_1.dtd"> <tiles-definitions> <definition name="index" template="/WEB-INF/jsp/template/template.jsp"> <put-attribute name="title" value="97 King Of Fight" /> <put-attribute name="hrefBasepath" value="/WEB-INF/jsp/views/hrefBasepath.jsp" /> <put-attribute name="commonCss" value="/WEB-INF/jsp/views/commonCss.jsp" /> <put-attribute name="commonJs" value="/WEB-INF/jsp/views/commonJs.jsp" /> <put-attribute name="menu" value="/WEB-INF/jsp/views/menu.jsp" /> <put-attribute name="body" value="/WEB-INF/jsp/views/indexBody.jsp" /> </definition> </tiles-definitions>
同时指定 模板中的 <tiles:insertAttribute></tiles:insertAttribute> 标签所表示的网页片段的内容。
c. 在所有的jsp页面中,都可以通过 <tiles:insertDefinition> 标签类引入该模板的内容,例如下面的 index.jsp
<%@ page contentType="text/html;charset=utf-8"%> <%@ taglib uri="http://tiles.apache.org/tags-tiles" prefix="tiles"%> <tiles:insertDefinition name="index"></tiles:insertDefinition>
该页面,将会引入在 tiles-defs.xml 中注册的 名称为 "index" 的模板。该模板内容将以 template.jsp 为布局方案,同时按配置中指定的片段来替代 <tiles:insertAttribute> 标签,从而形成一个完整的页面。
d. 关于 tiles-defs.xml 中 <definition> 元素的部分使用方法
① 一个<definition>的定义中,可以通过<put-attribue>嵌套另一个<definition> ,也可以通过 extends 属性集成另一个<definition>
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE tiles-definitions PUBLIC "-//Apache Software Foundation//DTD Tiles Configuration 2.1//EN" "http://tiles.apache.org/dtds/tiles-config_2_1.dtd"> <tiles-definitions> <definition name="index.header" template="/WEB-INF/jsp/template/header.jsp"> <put-attribute name="title" value="97 King Of Fight" /> <put-attribute name="hrefBasepath" value="/WEB-INF/jsp/views/hrefBasepath.jsp" /> <put-attribute name="commonCss" value="/WEB-INF/jsp/views/commonCss.jsp" /> <put-attribute name="commonJs" value="/WEB-INF/jsp/views/commonJs.jsp" /> </definition> <definition name="index" template="/WEB-INF/jsp/template/template.jsp"> <!-- 通过 value=name 引用前面的 definition --> <put-attribute name="header" value="index.header"/> <put-attribute name="menu" value="/WEB-INF/jsp/views/menu.jsp" /> <put-attribute name="body" value="/WEB-INF/jsp/views/indexBody.jsp" /> </definition> <!-- 通过属性 extends=name 定义继承,只需修改有变化的部分 --> <definition name="welcome" extends="index"> <put-attribute name="body" value="/WEB-INF/jsp/views/welcomeBody.jsp" /> </definition> </tiles-definitions>
通过测试发现:如果上面的继承部分写成这样
<!-- 通过属性 extends=name 定义继承,只需修改有变化的部分 --> <definition name="welcome" extends="index"> <!-- title 属性是不会被覆盖的 --> <put-attribute name="title" value="Welcome" /> <put-attribute name="body" value="/WEB-INF/jsp/views/welcomeBody.jsp" /> </definition>
因为继承的 index ,index 中没有 title 部分定义,只有header, 而 title 在 header 中, 故不能覆盖 title , 而只可以直接覆盖 header
② 可以用 匿名定义 的方法,来使用 嵌套 定义
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE tiles-definitions PUBLIC "-//Apache Software Foundation//DTD Tiles Configuration 2.1//EN" "http://tiles.apache.org/dtds/tiles-config_2_1.dtd"> <tiles-definitions> <definition name="index" template="/WEB-INF/jsp/template/template.jsp"> <put-attribute name="header"> <definition template="/WEB-INF/jsp/template/header.jsp"> <put-attribute name="title" value="97 King Of Fight" /> <put-attribute name="hrefBasepath" value="/WEB-INF/jsp/views/hrefBasepath.jsp" /> <put-attribute name="commonCss" value="/WEB-INF/jsp/views/commonCss.jsp" /> <put-attribute name="commonJs" value="/WEB-INF/jsp/views/commonJs.jsp" /> </definition> </put-attribute> <put-attribute name="menu" value="/WEB-INF/jsp/views/menu.jsp" /> <put-attribute name="body" value="/WEB-INF/jsp/views/indexBody.jsp" /> </definition> </tiles-definitions>
③ 另一种继承方式:如果页面中只是布局发生改变,而需要引入的内容是一样的。
<definition name="indexLayout2" extends="index" template="/WEB-INF/jsp/template/layout2.jsp"> </definition>
④ 动态定义模板
上面的方法都是在编辑 tiles-defs.xml 文件,是静态配置,需要重启服务,才能有效。
Tiles2 提供了在不许要重启服务,也不需要在 tiles-defs.xml 配置就能动态生成模板的方法。
那就是直接在 jsp 页面中,使用 tiles 标签,动态定义。
有两种方法可以实现, 插入一个匿名模板 和 定义一个模板
<%@ page contentType="text/html;charset=utf-8"%> <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%> <%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt"%> <%@ taglib uri="http://tiles.apache.org/tags-tiles" prefix="tiles"%> <!-- 在该位置动态插入一个匿名模板,不需在 xml 文件中配置,该方案可以在不重启服务的情况下,动态建立一个模板 --> <tiles:insertTemplate template="/WEB-INF/jsp/template/template.jsp"> <tiles:putAttribute name="header"> <tiles:insertTemplate template="/WEB-INF/jsp/template/header.jsp"> <tiles:putAttribute name="title" value="97 King Of Fight" /> <tiles:putAttribute name="hrefBasepath" value="/WEB-INF/jsp/views/hrefBasepath.jsp" /> <tiles:putAttribute name="commonCss" value="/WEB-INF/jsp/views/commonCss.jsp" /> <tiles:putAttribute name="commonJs" value="/WEB-INF/jsp/views/commonJs.jsp" /> </tiles:insertTemplate> </tiles:putAttribute> <tiles:putAttribute name="menu" value="/WEB-INF/jsp/views/menu.jsp" /> <tiles:putAttribute name="body" value="/WEB-INF/jsp/views/indexBody.jsp" /> </tiles:insertTemplate>
<%@ page contentType="text/html;charset=utf-8"%> <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%> <%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt"%> <%@ taglib uri="http://tiles.apache.org/tags-tiles" prefix="tiles"%> <!-- 动态定义模板,不需要在 xml 文件中配置,该方案可以在不重启服务的情况下,动态定义一个模板 --> <tiles:definition name="index3" template="/WEB-INF/jsp/template/template.jsp"> <tiles:putAttribute name="header"> <tiles:insertTemplate template="/WEB-INF/jsp/template/header.jsp"> <tiles:putAttribute name="title" value="97 King Of Fight" /> <tiles:putAttribute name="hrefBasepath" value="/WEB-INF/jsp/views/hrefBasepath.jsp" /> <tiles:putAttribute name="commonCss" value="/WEB-INF/jsp/views/commonCss.jsp" /> <tiles:putAttribute name="commonJs" value="/WEB-INF/jsp/views/commonJs.jsp" /> </tiles:insertTemplate> </tiles:putAttribute> <tiles:putAttribute name="menu" value="/WEB-INF/jsp/views/menu.jsp" /> <tiles:putAttribute name="body" value="/WEB-INF/jsp/views/indexBody.jsp" /> </tiles:definition> <tiles:insertDefinition name="index3"></tiles:insertDefinition>
更详细的使用方法请参照官方文档 地址:http://tiles.apache.org/framework/tutorial/advanced/index.html