Apache Tiles 是一个页面布局框架。
Tiles 最先作为Apache Struts框架的一个组件,后来被独立为Apache的一个独立项目。
Tiles 提供一种模板机制,可以定义某一类页面成为通用模板,该模板一般用来定义整体布局。布局由可以重复的多个块元素组成,每个页面可以有选择的重新定义指定块而达到实现效果。
最好是 Maven 工程,便于 Jar的管理
工程结构目录
1、 向工程内添加Jar
<!-- tiles组件包 -->
<dependency>
<groupId>org.apache.tiles</groupId>
<artifactId>tiles-extras</artifactId>
<version>3.0.5</version>
</dependency>
2、创建 tiles-definitions.xml 文件
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE tiles-definitions PUBLIC
"-//Apache Software Foundation//DTD Tiles Configuration 3.0//EN"
"http://tiles.apache.org/dtds/tiles-config_3_0.dtd">
<!-- 主布局 -->
<tiles-definitions>
<definition name="layouts" template="/WEB-INF/views/layout/template.jsp">
<put-attribute name="sysCSS" value="/WEB-INF/views/layout/sysCSS.jsp" />
<put-attribute name="leftColumn" value="/WEB-INF/views/layout/leftColumn.jsp" />
<put-attribute name="topNavigation" value="/WEB-INF/views/layout/topNavigation.jsp" />
<put-attribute name="footerContent" value="/WEB-INF/views/layout/footerContent.jsp" />
<put-attribute name="sysJS" value="/WEB-INF/views/layout/sysJS.jsp" />
</definition>
<definition name="*/*" extends="layouts">
<put-attribute name="useJS" value="/WEB-INF/views/common/empty.jsp" />
<put-attribute name="useCSS" value="/WEB-INF/views/common/empty.jsp" />
<put-attribute name="privateCSS" value="/WEB-INF/views/{1}/{2}.css.jsp"/>
<put-attribute name="pageContent" value="/WEB-INF/views/{1}/{2}.jsp" />
<put-attribute name="javascript" value="/WEB-INF/views/{1}/{2}.js.jsp" />
</definition>
</tiles-definitions>
3、spring-mvc 添加 Tiles 引用
<!-- Tiles -->
<bean id="tilesViewResolver" class="org.springframework.web.servlet.view.tiles3.TilesViewResolver">
<property name="order" value="1" />
</bean>
<bean id="tilesConfigurer" class="org.springframework.web.servlet.view.tiles3.TilesConfigurer">
<property name="definitions">
<list>
<value>/WEB-INF/titles/tiles-definitions.xml</value>
</list>
</property>
</bean>
4、添加 layout 下相对应文件
注解: template.jsp 为模板页,布局样式在此处。其中
<tiles:insertAttribute name="pageContent" />
代表和tiles-definitions.xml 中引用的页面一致。
列:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<title></title>
<meta name="viewport" content="initial-scale=1, maximum-scale=1" />
<link rel="shortcut icon" href="/favicon.ico" />
<meta name="apple-mobile-web-app-capable" content="yes" />
<meta name="apple-mobile-web-app-status-bar-style" content="black" />
<tiles:insertAttribute name="sysCSS" />
<tiles:insertAttribute name="useCSS" />
<tiles:insertAttribute name="privateCSS" />
</head>
<body>
<tiles:insertAttribute name="pageContent" />
<tiles:insertAttribute name="sysJS" />
<tiles:insertAttribute name="useJS" />
<tiles:insertAttribute name="javascript" />
<tiles:insertAttribute name="footerContent" />
</body>
</html>
重点:需要在父页面加入
<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%>
<%@ taglib uri="http://tiles.apache.org/tags-tiles" prefix="tiles" %>
<%@ taglib uri="http://tiles.apache.org/tags-tiles-extras" prefix="tilesx" %>
项目一般都需要多个页面都加入一些 注解 引入文件,可以把这些写入一个共通里。
例如:include.jsp
<%@ page session="false"%>
<%@ 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://www.springframework.org/tags" prefix="spring"%>
<%@ taglib uri="http://www.springframework.org/tags/form" prefix="form"%>
<%@ taglib uri="http://tiles.apache.org/tags-tiles" prefix="tiles" %>
<%@ taglib uri="http://tiles.apache.org/tags-tiles-extras" prefix="tilesx" %>
<%-- <%@ taglib uri="http://www.springframework.org/security/tags" prefix="sec"%> --%>
<%-- <%@ taglib uri="http://terasoluna.org/tags" prefix="t"%>
<%@ taglib uri="http://terasoluna.org/functions" prefix="f"%> --%>
<c:set var="root" value="${pageContext.request.contextPath}"/>
<c:set var="vendors" value="${root}/resources"/>
<c:set var="img" value="${root}/resources/images"/>
web.xml 添加
<jsp-config>
<jsp-property-group>
<url-pattern>*.jsp</url-pattern>
<el-ignored>false</el-ignored>
<page-encoding>UTF-8</page-encoding>
<scripting-invalid>false</scripting-invalid>
<include-prelude>/WEB-INF/views/common/include.jsp</include-prelude>
</jsp-property-group>
</jsp-config>
添加以后,在*.jsp 里 获取 工程下内容 直接用${img}
获取 例如:${img}/XXX.jsp