Struts Tiles框架,標籤庫詳解

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。當前的Tilescontext首先獲得該屬性值,然後它再用來作爲頁面目標而插入。

 

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" 
                     />
 

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章