Struts Tiles框架，标签库详解<tiles:insert page="facebook.jsp" />

Tiles框架为创建Web页面提供了一种模板机制，它能将网页的布局和内容分离。它允许先创建模板，然后在运行时动态地将内容插入到模板中。Tiles 框架建立在JSP的include指令的基础上，但它提供了比JSP的 include指令更强大的功能。

Tiles框架具有如下特性： 

    ·创建可重用的模板

    ·动态构建和装载页面 

    ·定义可重用的Tiles组件

    ·支持国际化

 

 

 Tiles框架包含以下内容：

    ·Tiles标签库

    ·Tiles组件的配置文件 

    ·TilesPlugIn插件

    在开发Web站点时，常常要求同一站点的所有Web页面保持一致的外观，比如有相同的布局、页头、页尾和菜单。

采用基本的JSP语句创建复合式网页

 

    创建动态Web页面的最基本的办法是为每个页面创建独立的JSP文件。如果网页的相同部分发生需求变更，必须手工修改所有的JSP文件。可见，采用基本的JSP语句来编写上述网页，会导致JSP代码的大量冗余，增加开发与维护成本。

 

 

 

对比采用JSP的include指令创建复合式网页

    为了减少代码的冗余，可以把index.jsp和product.jsp中相同部分放在单独的JSP文件中，然后在index.jsp和 product.jsp文件中通过JSPinclude指令把其他JSP文件包含进来。这样提高了代码的可重用性。但是JSP include指令不能完全避免代码冗余，尽管这种方案减少了重复代码，但JSP文件的数量增加了，由原来的2个文件增加到7个文件，所以软件的复杂度也增加了。

 

Tiles:Insert标签创建复合式网页

   Tiles标签库的tiles:insert标签和JSP include指令具有相同的功能，也能把其他的JSP页面插入到当前页面中。用tiles:insert标签取代JSP include指令来创建复合式页面，代码仅有稍微的差别，两者的利弊也很相似。单纯使用tiles:insert标签来创建复合式页面，还没有充分发挥 Tiles框架的优势。

 

以下两条语句的作用是相同的：

 

<jsp:include page="indexContent.jsp"/>

 

<tiles:insert page="indexContent.jsp"/>

 

采用Tiles模板创建复合式网页

尽管使用了tiles:insert标签，index.jsp和product.jsp文件还是存在很多的重复代码。为了提高Web页面的可重用性和可维护性，可以引入Tiles的模板机制。通俗的讲，Tiles模板是一种描述页面布局的JSP页面。

Tiles模板仅仅定义Web页面的样式，而不指定内容。在Web应用运行时，才把特定内容插入到模板页面中。同一模板可以被多个Web页面共用。使用模板，可以轻松的实现Web应用的所有页面保持相同的外观和布局，无需为每个页面硬编码。

在一个应用中，大多数页面使用同一模板，某些页面可能需要不同的外观，使用其他的模板，因此一个应用可能有一个以上模板。

<%@ tagliburi="/WEB-INF/struts-tiles.tld" prefix="tiles"%>

 

<tiles:insert attribute="sidebar"/>

<tiles:insert attribute="header"/>

<tiles:insert attribute="content"/>

<tiles:insert attribute="footer"/>

<%@ page contentType="text/html;charset=UTF-8" %>

<%@ taglib uri="/WEB-INF/struts-tiles.tld"prefix="tiles" %>

<tiles:insert page="layout.jsp"flush="true">

     <tiles:put name="sidebar"value="sidebar.jsp"/>

     <tiles:put name="header" value="header.jsp"/> 

      <tiles:put name="content"value="indexContent.jsp"/> 

     <tiles:put name="footer" value="footer.jsp"/> 

</tiles:insert>

 

 

 

采用Tiles模板机制，大大提高了代码的可重用性和可维护性，模板中包含了网页共同的布局。如果布局发生变化，只需要修改模板文件，无需修改具体的网页文件。不过，从例程16-13和16-14可以看出，尽管 index.jsp和product.jsp文件的长度都缩短了，但是两者还是存在重复代码。

 

Tiles组件的基本使用方法

    为了最大程度的提高代码的可重用性和灵活性，Tiles框架引入了Tiles组件的概念。Tiles组件可以代表一个完整的网页，也可以代表网页的一部分。简单的Tiles组件可以组合成复杂的Tiles组件，或被扩展为复杂的Tiles组件。

 

   Tiles框架允许在专门的XML文件中配置Tiles组件。例如，以下代码定义了一个名为"index-definition"的Tiles组件，它描述整个index.jsp网页：

 

<tiles-definitions>

 

  <definition name="index-definition" path="/layout.jsp">

 

     <put name="sidebar" value="sidebar.jsp"/>

 

     <put name="header" value="header.jsp"/> 

 

     <put name="content"value="indexContent.jsp"/> 

 

     <put name="footer" value="footer.jsp"/> 

 

  </definition>

 

</tiles-definitions>

 

   definition元素的name属性指定Tiles组件的名字，path属性指定Tiles组件使用的模板，definition元素的put子元素用于向模板中插入具体的网页内容。

例程16-15 tiles-defs.xml

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

 

<!DOCTYPE tiles-definitions PUBLIC"-//Apache Software Foundation//DTD Tiles Configuration 1.1//EN" "http://jakarta.apache.org/struts/dtds/tiles-config_1_1.dtd">

 

 

 

<tiles-definitions>

 

  <definition name="index-definition" path="/layout.jsp">

 

     <put name="sidebar" value="sidebar.jsp"/>

 

     <put name="header" value="header.jsp"/> 

 

     <put name="content" value="indexContent.jsp"/> 

 

     <put name="footer" value="footer.jsp"/> 

 

  </definition>

 

 

 

  <definition name="product-definition" path="/layout.jsp">

 

     <put name="sidebar" value="sidebar.jsp"/>

 

     <put name="header" value="header.jsp"/> 

 

     <put name="content"value="productContent.jsp"/> 

 

     <put name="footer" value="footer.jsp"/> 

 

  </definition>

 

 

 

</tiles-definitions>

 

    以上代码定义了两个Tiles组件，它们分别代表完整的index.jsp和product.jsp页面。

    （4）在Strut配置文件中配置TilesPlugin插件，代码如下：

 

<plug-in className="org.apache.struts.tiles.TilesPlugin">

 

 <set-property property="definitions-config"value="/WEB-INF/tiles-defs.xml" />

 

 <set-property property="definitions-parser-validate"value="true" />

 

</plug-in>

 

 

 

  TilesPlugin插件用于加载Tiles组件的配置文件。在plug-in元素中包含几个set-property子元素，用于向TilesPlugin插件传入附加的参数：

 

    ·definitions-config参数：指定Tiles组件的配置文件，如果有多个配置文件，则它们之间用逗号分隔。

 

    ·definitions-parser-validate参数：指定XML解析器是否验证Tiles配置文件，可选值包括true和false，默认值为true。

    （5）在web.xml文件中配置ActionServlet

    为了保证在Web应用启动时加载TilesPlugin插件，应该加入ActionServlet控制器，ActionServlet控制器在初始化时能加载所有的插件。以下是在web.xml文件中配置ActionServlet的代码：

<servlet>

 

   <servlet-name>action</servlet-name>

 

   <servlet-class>org.apache.struts.action.ActionServlet</servlet-class>

 

   <init-param>

     <param-name>config</param-name>

     <param-value>/WEB-INF/struts-config.xml</param-value>

   </init-param>

 

   <load-on-startup>3</load-on-startup>

 

</servlet>

 

 

 

<servlet-mapping>

 

   <servlet-name>action</servlet-name>

 

   <url-pattern>*.do</url-pattern>

 

</servlet-mapping>

 

    （6）在index.jsp和product.jsp中插入Tiles组件，参见例程16-16和例程16-17：

 

    例程16-16index.jsp

 

 

 

<%@ page contentType="text/html;charset=UTF-8" %>

 

<%@ tagliburi="/WEB-INF/struts-tiles.tld" prefix="tiles" %>

 

<tiles:insertdefinition="index-definition"/>

 

&nbsp;&nbsp;&nbsp;&nbsp;

例程16-17  product.jsp

 

<ccid_nobr>

 

<table width="400"border="1" cellspacing="0" cellpadding="2"

 

bordercolorlight = "black"bordercolordark = "#FFFFFF" align="center">

 

<tr>

 

   <td bgcolor="e6e6e6" class="code" style="font-size:9pt">

 

   <pre><ccid_code> <%@ page contentType="text/html;charset=UTF-8" %>

 

<%@ tagliburi="/WEB-INF/struts-tiles.tld" prefix="tiles" %>

 

<tiles:insertdefinition="product-definition"/>

 

 

    通过StrutsAction来调用Tiles组件

 

    如果Tiles组件代表完整的网页，可以直接通过Struts Action来调用Tiles组件。例如，如果希望通过Struts Action来调用16.5.1节定义的名为"index-definition"的Tiles组件，可以在Struts配置文件中配置如下Action映射:

 

 

<action-mappings>

 

<action  path="/index"

 

         type="org.apache.struts.actions.ForwardAction"

 

         parameter="index-definition">

 

</action>

 

</action-mappings>

    接下来通过浏览器访问http://localhost:8080/tilestaglibs/index.do，该请求先被转发到ForwardAction，ForwardAction再把请求转发给名为"index-definition"的Tiles组件，最后在浏览器端，用户将看到和index.jsp 相同的页面。

    通过StrutsAction来调用Tiles组件，可以充分发挥Struts框架负责流程控制的功能。此外，可以减少JSP文件的数目。例如，如果直接通过Struts Action来调用名为"index-definition"的Tiles组件，就不必再创建index.jsp文件。

    解析Tiles组件的组合与扩展

   Tiles 组件是一种可重用的组件。可以象搭积木一样，把简单的Tiles组件组装成复杂的Tiles组件，例如，可以把名为"index-definition" 的Tiles组件的左边部分拆分为独立的Tiles组件，名为"sidebar-definition"。

<definition  name="index-definition"path="/layout.jsp">

 

<put name="sidebar"value="sidebar-definition" type="definition"/>

</definition>

 

    以上put子元素的value属性指定被包含的Tiles组件的名字，type属性设为"definition"，表示value属性指定的是Tiles组件，而不是JSP文件。

<definition  name="index-definition"extends="base-definition">

 

标签库 

tiles:insert <tiles:insert page="/layouts/commonLayout.jsp" flush="true" />     插入到JSP页面中：这个例子将tag中指定的页面插入到整个页面中来。page属性可以是指向任何现存网络资源有效的URL。 <tiles:insert attribute='menu' />     通过引用属性来插入Tiles：该例子插入了被 “menu” 属性值引用的Tiles。当前的Tiles的context首先获得该属性值，然后它再用来作为页面目标而插入。   tiles:getAsString <tiles:getAsString name="title" />     作为String来得到一个属性：这个例子得到“tilte”属性的值，并在当前输出流中把它作为字符串打印出来。toString() 方法应用于该属性值，允许作为值来传递任何对象。 tiles:importAttribute     引入一个Tiles属性到指定的上下文(context)中

1.tiles:insert

 <tiles:insert attribute="header" ignore="true">
       <tiles:put name="title" 
                  beanName="title" beanScope="tile"/>
</tiles:insert>
2.使用步骤
  1.使用taglib指令导入 tile 标签库。
  2.使用 tiles:insert 标签来将 tile 布局插入当前页面。
  3.使用 tiles:put 来传递字符串参数。 
  4.使用 tiles:put 来传入参数 tile。 
3.使用xml配制的时候，在struts-config.xml中添加如下代码

   <plug-in className="org.apache.struts.tiles.TilesPlugin" >
     <set-property property="definitions-config" 
                  value="/WEB-INF/tiles-defs.xml" />
     <set-property property="moduleAware" value="true" />
     <set-property property="definitions-parser-validate" value="true" />
   </plug-in>4.在tiles-defs.xml中追加如下代码
5.理解tiles的变量作用范围
      记住 Tiles 框架定义了一个称为“tile 范围”的附加范围，它与页面范围类似。
  像页面范围一样，tile 范围比请求范围更私有。Tile 范围允许 tile 用户给 tile 传递变量
  （称为参数）。本质上，它使得页面像函数一样可调用。
      嵌套的 tile 不会和它们的父亲共享相同的 tile。当前 tile 的 tile 范围已在显示嵌套
  的 tile 之前得到保存。在嵌套的 tile 结束之后，父亲的 tile 范围将恢复到请求中。
  这个神奇的特性是在 InsertTag (org.apache.struts.taglib.tiles.InsertTag) 类的嵌套类 
  InsertHandler 中实现的。
6.tiles:useAttribute 标签

 

 

<tiles-definitions>

   <definition name="siteLayoutDef" path="/siteLayout.jsp">
     <put name="title" value="Rick Hightower Stock Quote System" /> 
     <put name="header" value="/header.jsp" />
     <put name="footer" value="/footer.jsp" />
     <put name="content" type="string">
        Content goes here
     </put>
   </definition>
 ...

   因此 tiles:useAttribute 将把 user 对象从 tile 范围复制到页面范围。一旦 bean 得到定义，
   您就能够像使用页面范围中定义的任何 bean 一样使用它：

7.在 XML 中使用 putList
<definition name="siteLayoutDef3" path="/siteLayout3.jsp">
     <put name="title" value="Rick Hightower Stock Quote System" /> 
     <put name="header" value="/header2.jsp" />
     <put name="footer" value="/footer.jsp" />
     <put name="content" type="string">
        Content goes here
     </put>
     
     <putList name="items" >
       <item value="Home"    
             link="/index.html"  />
       <item value="Wiley"   

             link="http://www.wiley.com"  />
       <item value="Trivera Technologies"   
             link="http://www.triveratech.com/"  />
       <item value="Virtuas"    
             link="http://www.virtuas.com/"  />
       <item value="Rick Hightower"  
             link="http://www.rickhightower.com"  />
       <item value="Rick's Blog"  
             link="http://rickhightower.blogspot.com/"  />
     </putList>
   </definition>

   items 列表（java.util.List）被放入 tile 范围。名称 items 使用 putList 元素的 name 属性来设置。
   item 元素通过把 org.apache.struts.tiles.beans.MenuItem 的一个实例插入该列表来定义一个链接。
   value 属性对应于链接上的标签（label），而 link 则指向链接的 URL。
8.tiles:importAttribute
  tiles:importAttribute 标签将 tile 范围中的属性导入到页面范围。它类似于 tiles:useAttrribute 标签，但它更接近猎枪而不是解剖刀。它是懒散的、肮脏的和便宜的；
  这有效地将条目列表从 tile 范围拷贝到页面范围。
  注意： tiles:importAttribute 可拷贝到任何指定的范围。 
  默认情况下，tiles:importAttribute 将所有这些属性拷贝到页面范围。你也可以通过使用范围属性将这些属性拷贝到其他范围。

9.可以使用 tiles:putList 元素和它的 tiles:add 子元素向 JSP 中的列表添加条

 <%@ taglib uri="/WEB-INF/struts-tiles.tld" prefix="tiles" %>

 <%@ page import="org.apache.struts.tiles.beans.SimpleMenuItem" %>
 <tiles:insert definition="siteLayoutDef4">
     <tiles:put name="title" type="string" 
                value="Get Rick Hightower Stock Quote6" /> 
     <tiles:put name="content" value="indexContent5.jsp"/>
         
     <tiles:putList name="items" >
         <jsp:useBean id="item1" class="SimpleMenuItem"/>
         <jsp:setProperty name="item1" property="link"  
                          value="/index.html"/>
         <jsp:setProperty name="item1" property="value" 
                          value="Home" />
         <tiles:add beanName="item1"/>
     </tiles:putList>
 </tiles:insert>

<tiles:useAttribute id="user"
                     name="user" 
                     classname="rickhightower.UserDomainObject" 
                     />