Tiles框架允许在专门的XML文件中配置Tiles组件。例如,以下代码定义了一个名为"index-definition"的Tiles组件,它描述整个index.jsp网页:
<ccid_nobr>
<ccid_code><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></ccid_code> |
</ccid_nobr>
definition元素的name属性指定Tiles组件的名字,path属性指定Tiles组件使用的模板,definition元素的put子元素用于向模板中插入具体的网页内容。
提示:本节介绍的tilestaglibs应用的源程序位于 配套光盘的sourcecode/tilestaglibs/version5/tilestaglibs目录下。如果要在Tomcat上发布这个应用, 只要把version5目录下的整个tilestaglibs子目录拷贝到CATALINA_HOME/webapps目录下即可。
以下是在tilestaglibs应用中使用Tiles组件的步骤。
(1)安装Tiles标签库所需的文件,同16.3节的步骤1
(2)在web.xml文件中配置taglib元素,同16.3节的步骤2
(3)在专门的XML文件中配置Tiles组件, 在本例中把这个配置文件命名为tiles-defs.xml,这个文件位于WEB-INF目录下。例程16-15为tiles-defs.xml文件的代码。
例程16-15 tiles-defs.xml
<ccid_nobr>
<ccid_code><?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></ccid_code> |
</ccid_nobr>
以上代码定义了两个Tiles组件,它们分别代表完整的index.jsp和product.jsp页面。
(4)在Strut配置文件中配置TilesPlugin插件,代码如下:
<ccid_nobr>
<ccid_code><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></ccid_code> |
</ccid_nobr>
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的代码:
<ccid_nobr>
<ccid_code><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></ccid_code> |
</ccid_nobr>
(6)在index.jsp和product.jsp中插入Tiles组件,参见例程16-16和例程16-17:
例程16-16 index.jsp
<ccid_nobr>
<ccid_code><%@ page contentType="text/html; charset=UTF-8" %> <%@ taglib uri="/WEB-INF/struts-tiles.tld" prefix="tiles" %> <tiles:insert definition="index-definition"/> 例程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" %> <%@ taglib uri="/WEB-INF/struts-tiles.tld" prefix="tiles" %> <tiles:insert definition="product-definition"/></ccid_code> |
</ccid_nobr>
通过Struts Action来调用Tiles组件
如果Tiles组件代表完整的网页,可以直接通过Struts Action来调用Tiles组件。例如,如果希望通过Struts Action来调用16.5.1节定义的名为"index-definition"的Tiles组件,可以在Struts配置文件中配置如下Action 映射:
<ccid_nobr>
<ccid_code><action-mappings> <action path="/index" type="org.apache.struts.actions.ForwardAction" parameter="index-definition"> </action> </action-mappings></ccid_code> |
</ccid_nobr>
接下来通过浏览器访问 http://localhost:8080/tilestaglibs/index.do,该请求先被转发到 ForwardAction,ForwardAction再把请求转发给名为"index-definition"的Tiles组件,最后在浏览器端,用 户将看到和index.jsp相同的页面。
通过Struts Action来调用Tiles组件,可以充分发挥Struts框架负责流程控制的功能。此外,可以减少JSP文件的数目。例如,如果直接通过Struts Action来调用名为"index-definition"的Tiles组件,就不必再创建index.jsp文件。