在本章中,讓我們?yōu)g覽用 Struts 2 集成 Tiles 框架的步驟。Apache Tiles 是模板框架,用于簡(jiǎn)化 web 應(yīng)用程序用戶接口開(kāi)發(fā)的。
首先,我們需要從 Apache Tiles 網(wǎng)站下載 tiles jar 文件。你需要將下列 jar 文件添加到項(xiàng)目的類(lèi)路徑中。
tiles-api-x.y.z.jar
tiles-compat-x.y.z.jar
tiles-core-x.y.z.jar
tiles-jsp-x.y.z.jar
除了上述文件,我么還需要將下列來(lái)自 struts 2 的 jar 文件復(fù)制到你的 WEB-INF/lib 中。
commons-beanutils-x.y.zjar
commons-digester-x.y.jar
現(xiàn)在讓我們?yōu)?Struts-Tiles 集成配置 web.xml 文件,如下所示。這里有兩個(gè)重要的點(diǎn)需要注意。首先,我們需要告訴 tiles 在哪里可以找到 tiles 配合文件 tiles.xml。在我們的例子中,它位于 /WEB-INF 文件夾下。接下來(lái),我們需要初始化來(lái)自 Struts2 下載的 Tiles 監(jiān)聽(tīng)器。
<?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>
接下來(lái),讓我們?cè)?/WEB-INF 文件夾下創(chuàng)建 tiles.xml,其內(nèi)容如下所示:
<?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>
接下來(lái),我們?cè)?baseLayout.jsp 文件中定義一個(gè)基本框架布局。它有五個(gè)可重用的/可覆蓋的域。即 title, banner, menu, body 和 footer。我們?yōu)檫@個(gè)基本布局提供了默認(rèn)值,然后創(chuàng)建了從默認(rèn)值中擴(kuò)展的兩個(gè)自定義值。tiger 布局與基本布局類(lèi)似,除了它使用 tiger.jsp 作為它的主體,文本 "Tiger" 作為標(biāo)題。類(lèi)似的,lion 布局也與基本布局相似,除了它使用 lion.jsp 作為它的主體,文本 "Lion" 作為標(biāo)題。
讓我們看看單獨(dú)的 jsp 文件。以下是 baseLayout.jsp 文件的內(nèi)容:
<%@ 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 頁(yè)面放到一起。我們將 tiles 屬性放到我們需要的位置。接下來(lái),讓我們創(chuàng)建 banner.jsp 文件,其內(nèi)容如下所示:
<img src="http://www.tutorialspoint.com/images/tp-logo.gif"/>
menu.jsp 文件有如下所示的行,能夠鏈接到 TigerMenu.action 和 LionMenu.action struts 操作。
<%@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 文件有如下所示的內(nèi)容:
<img src="http://upload.wikimedia.org/wikipedia/commons/d/d2/Lion.jpg"/> The lion
tiger.jsp 文件有如下所示的內(nèi)容:
<img src="http://www.freewebs.com/tigerofdarts/tiger.jpg"/> The tiger
接下來(lái),讓我們創(chuàng)建操作類(lèi)文件 MenuAction.java,其內(nèi)容如下所示:
package com.tutorialspoint.struts2;
import com.opensymphony.xwork2.ActionSupport;
public class MenuAction extends ActionSupport {
public String tiger() { return "tiger"; }
public String lion() { return "lion"; }
}
這是一個(gè)非常簡(jiǎn)單的額類(lèi)。我們聲明兩種方法 tiger() 和 lion() 來(lái)分別返回輸出 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>
檢查在上述文件中做的工作。首先,我們?yōu)橐晥D技術(shù)聲明了一個(gè)命名為 "tiles" 的新的結(jié)果類(lèi)型,而不是簡(jiǎn)單的 jsp,作為我們正在使用的 tiles。Struts2 有 Tiles 視圖結(jié)果類(lèi)型支持,所以我們創(chuàng)建的結(jié)果類(lèi)型 "tiles" 會(huì)成為 "org.apache.struts2.view.tiles.TilesResult" 類(lèi)。
接下來(lái),如果說(shuō)請(qǐng)求是為 /tigerMenu.action 的,那么將用戶帶到 tiger tiles 頁(yè)面,如果請(qǐng)求是為 /lionMenu.action 的,那么將用戶帶到 lion tiles 頁(yè)面。
我們通過(guò)使用一些常規(guī)表達(dá)式來(lái)實(shí)現(xiàn)這點(diǎn)。在我們的操作定義中,我們說(shuō)匹配模式 "*Menu" 將由這個(gè)操作處理。匹配方法包括在 MenuAction 類(lèi)中。也就是,tigerMenu.action 會(huì)包括 tiger() 且 lionMenu.action 會(huì)包括 lion()。然后我們需要將產(chǎn)生的結(jié)果映射到適當(dāng)?shù)?tiles 頁(yè)面中。
現(xiàn)在鼠標(biāo)右鍵單擊項(xiàng)目名,然后單擊 Export > WAR 文件來(lái)創(chuàng)建一個(gè) War 文件。然后在 Tomcat 的應(yīng)用程序目錄中部署該 WAR 文件。最后,啟動(dòng) Tomcat 服務(wù)器并嘗試訪問(wèn) URL http://localhost:8080/HelloWorldStruts2/tigerMenu.jsp
. 這會(huì)呈現(xiàn)如下所示的畫(huà)面:
http://wiki.jikexueyuan.com/project/struts-2/images/struts_tiles.gif" alt="" />
同樣的,如果你進(jìn)入 lionMenu.action 頁(yè)面,那么你將會(huì)看到 lion 頁(yè)面,它使用的相同的 tiles 布局。