Tiles组件的基本使用方法

时间：2022-08-28 00:26:39

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子元素用于向模板中插入具体的网页内容。

     提示：本节介绍的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 

<?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-16 index.jsp 

<%@ page contentType="text/html; charset=UTF-8" %>

<%@ taglib uri="/WEB-INF/struts-tiles.tld" prefix="tiles" %>

<tiles:insert definition="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" %>

<%@ taglib uri="/WEB-INF/struts-tiles.tld" prefix="tiles" %>

<tiles:insert definition="product-definition"/>


     通过Struts Action来调用Tiles组件

    如果Tiles组件代表完整的网页，可以直接通过Struts Action来调用Tiles组件。例如，如果希望通过StrutsAction来调用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文件的数目。例如，如果直接通过StrutsAction来调用名为"index-definition"的Tiles组件，就不必再创建index.jsp文件。

标签：

相关文章