笔记30 视图解析 ——TilesViewResolver

Apache Tiles，定义适用于所有页面的通用页面布局。Spring MVC以视图解析器的形式为Apache Tiles提供了支持，这个视图解析器能够将逻辑视图名解析为Tile定义。

1.配置Tiles视图解析器

为了在Spring中使用Tiles，需要配置几个bean。一个TilesConfigurer bean，它会负责定位和加载Tile定义并协调生成Tiles。除此之外，还需要TilesViewResolver bean将逻辑视图名称解析为Tile定义。这两个组件又有两种形式：针对Apache Tiles 2和Apache Tiles 3分别都有这么两个组件。

这两组Tiles组件之间最为明显的区别在于包名。针对Apache Tiles 2的TilesConfigurer/TilesViewResolver位于 org.springframework.web.servlet.view.tiles2包中，而针对Tiles 3的组件位于 org.springframework.web.servlet.view.tiles3包中。

使用Tiles 3。

配置TilesConfigurer来解析定义

 @Bean

     public TilesConfigurer tilesConfigurer() {

         TilesConfigurer tiles = new TilesConfigurer();

         // 指定Tile定义的位置

         tiles.setDefinitions(new String[] { "/WEB-INF/layout/tiles.xml", "/WEB-INF/views/**/tiles.xml" });

         tiles.setCheckRefresh(true); // 启用刷新功能

         return tiles;

     }

当配置TilesConfigurer的时候，所要设置的最重要的属性就是definitions。这个属性接受一个String类型的数组，其中每个条目都指定一个Tile定义的XML文件。对于Spittr应用来讲，我们让它在“/WEB-INF/layout/”目录下查找tiles.xml。

配置TilesViewResolver

 @Bean

     public ViewResolver viewResolver() {

         return new TilesViewResolver();

     }

2.定义Tiles

Apache Tiles提供了一个文档类型定义（document type definition， DTD），用来在XML文件中指定Tile的定义。每个定义中需要包含一个<definition>元素，这个元素会有一个或多个<putattribute>元素。例如，如下的XML文档为Spittr应用定义了几个Tile。

tiles.xml

 <?xml version="1.0" encoding="ISO-8859-1" ?>

 <!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="base" template="/WEB-INF/layout/page.jsp">

     <put-attribute name="header" value="/WEB-INF/layout/header.jsp" />

     <put-attribute name="footer" value="/WEB-INF/layout/footer.jsp" />

   </definition>

   <definition name="home" extends="base">

     <put-attribute name="body" value="/WEB-INF/views/home.jsp" />

   </definition>

   <definition name="login" extends="base">

     <put-attribute name="body" value="/WEB-INF/views/login.jsp" />

   </definition>

   <definition name="registerForm2" extends="base">

     <put-attribute name="body" value="/WEB-INF/views/registerForm2.jsp" />

   </definition>

   <definition name="profile" extends="base">

     <put-attribute name="body" value="/WEB-INF/views/profile.jsp" />

   </definition>

   <definition name="spittles" extends="base">

     <put-attribute name="body" value="/WEB-INF/views/spittles.jsp" />

   </definition>

   <definition name="spittle" extends="base">

     <put-attribute name="body" value="/WEB-INF/views/spittle.jsp" />

   </definition>

 </tiles-definitions>

每个<definition>元素都定义了一个Tile，它最终引用的是一个 JSP模板。在名为base的Tile中，模板引用的是“/WEBINF/layout/page.jsp”。某个Tile可能还会引用其他的JSP模板，使这些 JSP模板嵌入到主模板中。对于base Tile来讲，它引用的是一个头部 JSP模板和一个底部JSP模板。

   <definition name="base" template="/WEB-INF/layout/page.jsp">

     <put-attribute name="header" value="/WEB-INF/layout/header.jsp" />

     <put-attribute name="footer" value="/WEB-INF/layout/footer.jsp" />

   </definition>

base Tile所引用的page.jsp模板如下面程序清单所示。

 <%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>

 <%@ taglib uri="http://www.springframework.org/tags" prefix="s" %>

 <%@ taglib uri="http://tiles.apache.org/tags-tiles" prefix="t" %>

 <%@ page session="false" %>

 <html>

   <head>

     <title>Spittr</title>

     <link rel="stylesheet"

           type="text/css"

           href="<s:url value="/resources/style.css" />" >

   </head>

   <body>

     <div id="header">

       <t:insertAttribute name="header"></t:insertAttribute>

     </div>

     <div id="content">

       <t:insertAttribute name="body" >

       </t:insertAttribute>

     </div>

     <div id="footer">

       <t:insertAttribute name="footer" ></t:insertAttribute>

     </div>

   </body>

 </html>

需要重点关注的事情就是如何使用Tile标签库中的 <t:insert Attribute> JSP标签来插入其他的模板。在这里，用它来插入名为header、body和footer的模板。

在base Tile定义中，header和footer属性分别被设置为引用“/WEBINF/layout/ header. jsp”和“/WEB-INF/layout/footer.jsp”

header.jsp

 <%@ taglib uri="http://www.springframework.org/tags" prefix="s" %>

 <a href="<s:url value="/home" />"><img

     src="<s:url value="/resources" />/images/spitter_logo_50.png"

     border=""/></a>

footer.jsp

 Copyright &copy; YuanJun Li

需要注意的是，将通用的元素放到了page.jsp、header.jsp以及footer.jsp 中，其他的Tile模板中不再包含这部分内容。这使得它们能够跨页面重用，这些元素的维护也得以简化。

效果截图:

巴特西

笔记30 视图解析 ——TilesViewResolver

最新文章

热门文章