From Gossip@caterpillar

Struts Gossip: 使用XML管理模版資源

在Tiles中，您可以使用XML或是JSP來管理版面配置的相關資源，這邊先介紹使用XML定義檔的方式，如之前主題所定義的，定義檔是tiles-defs.xml，在當中如下撰寫：
  • 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=".myLayout" path="/tiles/myLayout.jsp"> 
        <put name="title"  value="Sample Page Title" /> 
        <put name="header" value="/tiles/header.jsp" /> 
        <put name="menu"   value="/tiles/menu.jsp" /> 
        <put name="footer" value="/tiles/footer.jsp" /> 
        <put name="body"   value="/tiles/body.jsp" /> 
    </definition> 

</tiles-definitions>

在<definition>標籤中，我們指定了版面配置的JSP頁面，也就是path屬性所指定的 myLayout.jsp，name屬性表明這個版面配置的名稱，而在接下來的<put>標籤中，我們指定了內容頁面的名稱與JSP頁面實際 的位置。

Tiles的定義檔可以支援國際化，您可以複製以上的內容，撰寫在tiles-defs_zh.xml中，並將encoding改為Big5，就可以在定義檔中使用中文，例如：
  • tiles-defs_zh.xml
<?xml version="1.0" encoding="Big5" ?>
<!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=".myLayout" path="/tiles/myLayout.jsp"> 
        <put name="title"  value="Tiles範例" /> 
        <put name="header" value="/tiles/header.jsp" /> 
        <put name="menu"   value="/tiles/menu.jsp" /> 
        <put name="footer" value="/tiles/footer.jsp" /> 
        <put name="body"   value="/tiles/body.jsp" /> 
    </definition> 
</tiles-definitions>

其中myLayout.jsp的內容如下：
  • myLayout.jsp 
<%@taglib prefix="tiles" uri="/tags/struts-tiles"%> 
<html> 
 <head>
 <title><tiles:getAsString name="title"/></title>
 </head> 
 <body>

 <table border="0" width="100%" cellspacing="5"> 
 <tr> 
    <td colspan="2">
        <tiles:insert attribute="header"/>
    </td> 
 <tr> 
 <tr> 
    <td width="140" valign="top">
        <tiles:insert attribute="menu"/>
     </td> 
    <td valign="top" align="left">
        <tiles:insert attribute="body"/>
    </td> 
 </tr> 
 <tr> 
    <td colspan="2">
        <tiles:insert attribute="footer"/>
    </td> 
 </tr> 
 </table>

 </body> 
</html>

這個版面配置網頁中主要使用表格來切割版面，Tiles標籤可以從attribute屬性得知對應於XML定義檔的真正JSP頁面，例如header將被 實際取代為header.jsp的內容，您可以自行完成其它的JSP頁面內容。

接下可以開始使用定義好的版面配置，例如在welcome.jsp中如下撰寫：
  • welcome.jsp 
<%@page contentType="text/html; charset=big5"%> 
<%@taglib prefix="tiles" uri="/tags/struts-tiles"%> 
<tiles:insert definition=".myLayout" flush="true"/>

在<tiles:insert>標籤中指定我們將使用.myLayout的版面配置定義，如果您連上welcome.jsp，則實際上您 會看到以下的內容：
 <html>
 <head><title>Tiles範例</title></head>
 <body>

 <table border="0" width="100%" cellspacing="5">
 <tr>
    <td colspan="2">
 <center><h1>Tiles測試範例<h1>
    </td>
 <tr>
 <tr>
    <td width="140" valign="top">
 選單一<br>
 選單二<br>
 選單三<br>
    </td>
    <td valign="top" align="left">
 Tiles提供一個類似於視窗程式版面管理的機制，透過定義檔，您可
以定義版面配置，以及當中所要置入的內容網頁，內容與版面配置的
標籤可以分離，您可以隨時抽換每一個內容網頁，也可以重用每一個
版面配置。
    </td>
 </tr>
 <tr>
    <td colspan="2">
 <center>版權所有(c)http://www.caterpillar.onlyfun.net/
    </td>
 </tr>
 </table>
 
 </body>
 </html>
 
如果您將來要改變版面配置的方式，您可以直接修改tiles-defs.xml中path所指向的Layout頁面，就如同您在視窗程式中改變版面管理員 一樣，如果您要修改指向的內容網頁，也只要更改tiles-defs.xml中相對應的設定，所有的更改集中於Tiles設定檔中加以管理，達到將版面配 置與內容分離的目的。

您可以擴充某個定義，重新定義當中所管理的頁面資源，一個例子如下：
  • tiles-defs_zh.xml 
<?xml version="1.0" encoding="big5" ?>
<!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=".myLayout" path="/tiles/myLayout.jsp"> 
        <put name="title"  value="Tiles範例" /> 
        <put name="header" value="/tiles/header.jsp" /> 
        <put name="menu"   value="/tiles/menu.jsp" /> 
        <put name="footer" value="/tiles/footer.jsp" /> 
        <put name="body"   value="/tiles/body.jsp" /> 
     </definition> 
     <definition name=".myLayout2" extends=".myLayout"> 
        <put name="title"  value="Tiles範例二" /> 
        <put name="header" value="/tiles/header2.jsp" /> 
     </definition> 
</tiles-definitions>

在上面的定義中，.myLayout2擴充自.myLayout，並重新定義了title與header兩個屬性，其它未重新定義的屬性將直接繼承自. myLayout。