Struts 2 & Tiles 整合

在本章中，讓我們一起了解將 Tiles 框架與 Struts2 整合的步驟。Apache Tiles 是一個模板框架，旨在簡化 Web 應用程式使用者介面的開發。

首先，我們需要從 Apache Tiles 網站下載 tiles jar 檔案。您需要將以下 jar 檔案新增到專案的類路徑中。

tiles-api-x.y.z.jar
tiles-compat-x.y.z.jar
tiles-core-x.y.z.jar
tiles-jsp-x.y.z.jar
tiles-servlet-x.y.z.jar

除了上述內容外，我們還必須從 Struts2 下載中將以下 jar 檔案複製到您的 WEB-INF/lib 中。

commons-beanutils-x.y.zjar
commons-digester-x.y.jar
struts2-tiles-plugin-x.y.z.jar

現在讓我們設定 web.xml 以進行 Struts-Tiles 整合，如下所示。這裡有兩點需要注意。首先，我們需要告訴 tiles 在哪裡可以找到 tiles 配置檔案 tiles.xml。在我們的例子中，它將在 /WEB-INF 資料夾下。接下來，我們需要初始化 Struts2 下載附帶的 Tiles 監聽器。

<?xml version = "1.0" Encoding = "UTF-8"?>
<web-app xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"
   xmlns = "http://java.sun.com/xml/ns/javaee" 
   xmlns:web = "http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
   xsi:schemaLocation = "http://java.sun.com/xml/ns/javaee 
   http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
   id = "WebApp_ID" version = "2.5">
   <display-name>Struts2Example15</display-name>
	
   <context-param>
      <param-name>
         org.apache.tiles.impl.BasicTilesContainer.DEFINITIONS_CONFIG
      </param-name>
      
      <param-value>
         /WEB-INF/tiles.xml
      </param-value>
   </context-param>

   <listener>
      <listener-class>
         org.apache.struts2.tiles.StrutsTilesListener
      </listener-class>
   </listener>

   <filter>
      <filter-name>struts2</filter-name>
      <filter-class>
         org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter
      </filter-class>
   </filter>

   <filter-mapping>
      <filter-name>struts2</filter-name>
      <url-pattern>/*</url-pattern>
   </filter-mapping>

   <welcome-file-list>
      <welcome-file>index.jsp</welcome-file>
   </welcome-file-list>
</web-app>

接下來，讓我們在 /WEB-INF 資料夾下建立 tiles.xml，內容如下：

<?xml version = "1.0" Encoding = "UTF-8" ?>

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

<tiles-definitions>

   <definition name = "baseLayout" template="/baseLayout.jsp">
      <put-attribute name = "title"  value = "Template"/>
      <put-attribute name = "banner" value = "/banner.jsp"/>
      <put-attribute name = "menu"   value = "/menu.jsp"/>
      <put-attribute name = "body"   value = "/body.jsp"/>
      <put-attribute name = "footer"   value = "/footer.jsp"/>
   </definition>

   <definition name = "tiger" extends = "baseLayout">
      <put-attribute name = "title"  value = "Tiger"/>
      <put-attribute name = "body"   value = "/tiger.jsp"/>      
   </definition>

   <definition name = "lion" extends = "baseLayout">
      <put-attribute name = "title"  value = "Lion"/>
      <put-attribute name = "body"   value = "/lion.jsp"/>      
   </definition>
  
</tiles-definitions>

接下來，我們在 baseLayout.jsp 中定義一個基本的骨架佈局。它有五個可重用/可覆蓋的區域。即 title、banner、menu、body 和 footer。我們為 baseLayout 提供預設值，然後建立兩個從預設佈局擴充套件的自定義項。tiger 佈局與基本佈局類似，只是它使用 tiger.jsp 作為其主體，並將文字“Tiger”作為標題。同樣，lion 佈局與基本佈局類似，只是它使用 lion.jsp 作為其主體，並將文字“Lion”作為標題。

讓我們看一下各個 jsp 檔案。以下是 baseLayout.jsp 檔案的內容：

<%@ taglib uri = "http://tiles.apache.org/tags-tiles" prefix = "tiles"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
   "http://www.w3.org/TR/html4/loose.dtd">

<html>
   <head>
      <meta http-equiv="Content-Type" content="text/html; charset = UTF-8">
      <title>
         <tiles:insertAttribute name = "title" ignore="true" />
      </title>
   </head>

   <body>
      <tiles:insertAttribute name = "banner" /><br/>
      <hr/>
      <tiles:insertAttribute name = "menu" /><br/>
      <hr/>
      <tiles:insertAttribute name = "body" /><br/>
      <hr/>
      <tiles:insertAttribute name = "footer" /><br/>
   </body>
</html>

在這裡，我們只是組合了一個包含 tiles 屬性的基本 HTML 頁面。我們在需要的地方插入 tiles 屬性。接下來，讓我們建立一個 banner.jsp 檔案，其內容如下：

<img src="https://tutorialspoint.tw/images/tp-logo.gif"/>

menu.jsp 檔案將包含以下幾行，它們是到 TigerMenu.action 和 LionMenu.action struts action 的連結。

<%@taglib uri = "/struts-tags" prefix = "s"%>

<a href = "<s:url action = "tigerMenu"/>" Tiger</a><br>
<a href = "<s:url action = "lionMenu"/>" Lion</a><br>

lion.jsp 檔案將包含以下內容：

<img src="http://upload.wikimedia.org/wikipedia/commons/d/d2/Lion.jpg"/>
The lion

tiger.jsp 檔案將包含以下內容：

<img src="http://www.freewebs.com/tigerofdarts/tiger.jpg"/>
The tiger

接下來，讓我們建立 action 類檔案 MenuAction.java，其中包含以下內容：

package com.tutorialspoint.struts2;

import com.opensymphony.xwork2.ActionSupport;

public class MenuAction extends ActionSupport {
   public String tiger() { return "tiger"; }
   public String lion() { return "lion"; }
}

這是一個非常簡單的類。我們聲明瞭兩個方法 tiger() 和 lion()，它們分別返回 tiger 和 lion 作為結果。讓我們將它們全部放在 struts.xml 檔案中：

<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">

<struts>
   <package name = "default" extends = "struts-default">
      <result-types>
         <result-type name = "tiles" 
         class="org.apache.struts2.views.tiles.TilesResult" />
      </result-types>

      <action name = "*Menu" method = "{1}" 
         class = "com.tutorialspoint.struts2.MenuAction">
         <result name = "tiger" type = "tiles">tiger</result>
         <result name = "lion" type = "tiles">lion</result>
      </action>

   </package>
</struts>

讓我們檢查一下我們在上述檔案中做了什麼。首先，我們聲明瞭一個名為“tiles”的新結果型別，因為我們現在使用 tiles 而不是普通的 jsp 作為檢視技術。Struts2 支援 Tiles View 結果型別，因此我們建立結果型別“tiles”為“org.apache.struts2.view.tiles.TilesResult”類。

接下來，我們想說，如果請求是針對 /tigerMenu.action，則將使用者帶到 tiger tiles 頁面，如果請求是針對 /lionMenu.action，則將使用者帶到 lion tiles 頁面。

我們使用一些正則表示式來實現這一點。在我們的 action 定義中，我們說任何與模式“*Menu”匹配的內容都將由此 action 處理。將呼叫 MenuAction 類中的匹配方法。也就是說，tigerMenu.action 將呼叫 tiger()，而 lionMenu.action 將呼叫 lion()。然後，我們需要將結果的結果對映到相應的 tiles 頁面。

現在右鍵單擊專案名稱，然後單擊 匯出 > WAR 檔案 以建立 War 檔案。然後將此 WAR 部署到 Tomcat 的 webapps 目錄中。最後，啟動 Tomcat 伺服器並嘗試訪問 URL https://:8080/HelloWorldStruts2/tigerMenu.jsp。這將產生以下螢幕：

同樣，如果您轉到 lionMenu.action 頁面，您將看到 lion 頁面，它使用相同的 tiles 佈局。

列印頁面