Struts Tiles 标签库

tiles:insert

<tiles:insert page="/layouts/commonLayout.jsp" flush="true" />

插入到JSP页面中：这个例子将tag中指定的页面插入到整个页面中来。page属性可以是指向任何现存网络资源有效的URL。

<tiles:insert attribute='menu' />

通过引用属性来插入Tiles：该例子插入了被 “menu” 属性值引用的Tiles。当前的Tiles的context首先获得该属性值，然后它再用来作为页面目标而插入。

tiles:getAsString

<tiles:getAsString name="title" />

作为String来得到一个属性：这个例子得到“tilte”属性的值，并在当前输出流中把它作为字符串打印出来。toString() 方法应用于该属性值，允许作为值来传递任何对象。

tiles:importAttribute

引入一个Tiles属性到指定的上下文(context)中

1.tiles:insert

<tiles:insert attribute="header" ignore="true">
<tiles:put name="title"
beanName="title" beanScope="tile"/>
</tiles:insert>
2.使用步骤
1.使用taglib指令导入 tile 标签库。
2.使用 tiles:insert 标签来将 tile 布局插入当前页面。
3.使用 tiles:put 来传递字符串参数。
4.使用 tiles:put 来传入参数 tile。
3.使用xml配制的时候，在struts-config.xml中添加如下代码

<plug-in className="org.apache.struts.tiles.TilesPlugin" >
<set-property property="definitions-config"
value="/WEB-INF/tiles-defs.xml" />
<set-property property="moduleAware" value="true" />
<set-property property="definitions-parser-validate" value="true" />
</plug-in>4.在tiles-defs.xml中追加如下代码<!--StartFragment -->
5.理解tiles的变量作用范围
记住 Tiles 框架定义了一个称为“tile 范围”的附加范围，它与页面范围类似。
像页面范围一样，tile 范围比请求范围更私有。Tile 范围允许 tile 用户给 tile 传递变量
（称为参数）。本质上，它使得页面像函数一样可调用。
嵌套的 tile 不会和它们的父亲共享相同的 tile。当前 tile 的 tile 范围已在显示嵌套
的 tile 之前得到保存。在嵌套的 tile 结束之后，父亲的 tile 范围将恢复到请求中。
这个神奇的特性是在 InsertTag (org.apache.struts.taglib.tiles.InsertTag) 类的嵌套类
InsertHandler 中实现的。
6.tiles:useAttribute 标签
<!--StartFragment -->

 

 

<tiles-definitions>

   <definition name="siteLayoutDef" path="/siteLayout.jsp">
     <put name="title" value="Rick Hightower Stock Quote System" /> 
     <put name="header" value="/header.jsp" />
     <put name="footer" value="/footer.jsp" />
     <put name="content" type="string">
        Content goes here
     </put>
   </definition>
 ...

因此 tiles:useAttribute 将把 user 对象从 tile 范围复制到页面范围。一旦 bean 得到定义，
您就能够像使用页面范围中定义的任何 bean 一样使用它：

7.在 XML 中使用 putList
<definition name="siteLayoutDef3" path="/siteLayout3.jsp"></definition><definition name="siteLayoutDef3" path="/siteLayout3.jsp">
<put name="title" value="Rick Hightower Stock Quote System" />
<put name="header" value="/header2.jsp" />
<put name="footer" value="/footer.jsp" />
<put name="content" type="string">
Content goes here
</put>

<putList name="items" >
<item value="Home"
link="/index.html" />
<item value="Wiley"

link="http://www.wiley.com" />
<item value="Trivera Technologies"
link="http://www.triveratech.com/" />
<item value="Virtuas"
link="http://www.virtuas.com/" />
<item value="Rick Hightower"
link="http://www.rickhightower.com" />
<item value="Rick's Blog"
link="http://rickhightower.blogspot.com/" />
</putList>
</definition>

items 列表（java.util.List）被放入 tile 范围。名称 items 使用 putList 元素的 name 属性来设置。
item 元素通过把 org.apache.struts.tiles.beans.MenuItem 的一个实例插入该列表来定义一个链接。
value 属性对应于链接上的标签（label），而 link 则指向链接的 URL。
8.tiles:importAttribute
tiles:importAttribute 标签将 tile 范围中的属性导入到页面范围。它类似于 tiles:useAttrribute 标签，但它更接近而不是解剖刀。它是懒散的、肮脏的和便宜的；
这有效地将条目列表从 tile 范围拷贝到页面范围。
注意： tiles:importAttribute 可拷贝到任何指定的范围。
默认情况下，tiles:importAttribute 将所有这些属性拷贝到页面范围。你也可以通过使用范围属性将这些属性拷贝到其他范围。

9.可以使用 tiles:putList 元素和它的 tiles:add 子元素向 JSP 中的列表添加条<!--StartFragment -->

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

 <%@ page import="org.apache.struts.tiles.beans.SimpleMenuItem" %>
 <tiles:insert definition="siteLayoutDef4">
     <tiles:put name="title" type="string" 
                value="Get Rick Hightower Stock Quote6" /> 
     <tiles:put name="content" value="indexContent5.jsp"/>
         
     <tiles:putList name="items" >
         <jsp:useBean id="item1" class="SimpleMenuItem"/>
         <jsp:setProperty name="item1" property="link"  
                          value="/index.html"/>
         <jsp:setProperty name="item1" property="value" 
                          value="Home" />
         <tiles:add beanName="item1"/>
     </tiles:putList>
 </tiles:insert>

<tiles:useAttribute id="user"
                     name="user" 
                     classname="rickhightower.UserDomainObject" 
                     />