這是Jakarta Struts程式設計一書中使用Tiles框架系列的第三部分，主要闡述瞭如何使用標記庫(包括：insert, definition, put, putList, add, get, getAsString, useAttribute, importAttribute, and initonent .
Tiles標記庫（The Tiles Tag Library）
這一部分介紹Tiles 框架使用的jsp自訂標記。表14-1列出了框架可用的標記 。這些標記與其他一些基於模板的框架所提供的標記是非常相似的，但是Tiles框架中蘊含著更豐富的功能。
表 14-1: Tiles框架標記庫中的標記
標記名（Tag name） 、 、 、 〜 〜 〜 、） 〜都 〜 、、）] 增加一個元素到環境清單中。
definition 建立一個Tiles元件定義。
Get 從請求作用域中得到內容（content），這個內容是put 標
記所置入的。
GetAsString 將tile/component/template屬性指定的值到目前的
JspWriter。
importAttribute 引入一個Tiles屬性到指定的上下文(context)中；
initComponentDefinitions 初始化一個Tiles定義工廠。
Insert 插入一個Tiles組件。
Put 設定一個屬性到一個Tiles上下文。
PutList 宣告一個列表，這個列表被傳遞為一個屬性。
useAttribute 在頁面中使用一個屬性值。
insert 標記
insert 標記是負責頁面中插入內容。在一個Tiles佈局中, insert標記使用屬性值指定的內容。在非Tile佈局中，insert標記是用來獲得一個框架（layout）並且使用put 標記把內容傳遞給佈局中。
表14-2列出insert 標記的屬性：
表14-2:insert 標記的屬性
屬性名(Attribute
屬性名(Attribute ) 》 〜 目前Tiles /元件上下文的屬性名稱，這個屬性值是由name 屬性來傳遞的。
beanName Bean 的名稱作為值來使用.Bean是從指定的內容中獲得。
假如有的話，Bean可以從指定的上下文中獲得。否則就得使用pageContext.findAttribute( ) 方法取得。 假如beanPRoperty 屬性已經指定，也可以從對應Bean屬性得到這個值 。
假如，這個Bean（或Bean的屬性值）是某個屬性類別(Direct, Instance,等等)的實例, 那麼插入過程要依照類別的類型而定。另外，呼叫Bean 的toString( ) 方法，並傳回值為String，並傳給name屬性。
beanProperty Bean 屬性（property）的名字，假如指定，那麼這個值從
Bean的屬性（property）中獲得.
beanScope 〔〔)，假如的作用範圍。 Bean的範圍可以是任何的JSP, 元件（component），或是模板（template）。在後兩者情況（組件，模板），bean 可以在Tiles (tile)/組件(component)/模板（template）內容中
component 一個描述tile 或模板（template）URI的字符串. 模板（template），頁（page）和元件（component）屬性必須有嚴格相同的行為
controllerUrl 在頁被插入前，控制器(controller)的直接URI 。 這個URI通常用來指示一個strUCt action. 這個控制器(action) 是用來為inserted tile 預備資料的。只能有 一個controllerUrl 或 controllerClass
controllerClass 頁面(page)被插入前，直接呼叫的一種控制（control）類別的類型。這個類別是用來為inserted tile 預備資料的。只能有 一個controllerUrl 或 controllerClass 。這個類別實作或擴充下列類別之一:org.apache.struts.tiles.Controller, org.apache.struts.tiles.ControllerSupport,或org.apache.struts.action.Action.
definition Insert定義的名稱。定義在一個集中的文件中被定義。現在，僅僅一個工廠（factory）的定義可以用這個屬性插入。插入一個用definition定義的定義，用beanName="".
flush true 或false. 假如true, 當前頁會在tile insertion.前輸出流
ignore name 這個屬性而存在的屬性所存在的屬性而存在的屬性，只是會回傳一個什麼都沒有寫得結果。初始值設定為false,可以拋出一個 runtime exception
name 一個要被插入得實體（entity）的名字。找出依照下面的順序 definition, attribute, 然後 page.
page 一個表示tile 或 template 的URI字串。 template,page, 和 component 屬性要嚴格的有同樣的行為
role 假如使用者是指定的角色，那麼這個標記才會起作用，否則，這個標記會被忽略掉，並且不會寫出任何內容。
template 一個表示tile 或 template 的URI字串。 template,page, 和 component 屬性要嚴格的有同樣的行為
definition 標籤
definition 標籤用bean的定義方法創建一個tile (template)，這個新創建的bean在輸出 scoperequested scoperequested。 definition 標籤的有些語法和insert 一樣。新的定義可以擴充在definition factory (xml file)中已經描述過的定義，並且可以重載先前定義的參數。
Table 14-3 列出了definition 標籤支援的屬性
屬性名 描述
extends 可以用來擴展在父定義的父定義了這個父定義。
id 定義bean的名稱，這個屬性是必需的
page 要插入template/component 的URL 。和template.一樣。
role 在插入一個定義前，進行檢查role.假如當前用戶並沒有定義這個role,那麼這個定義將不會被插入。再插入的時候進行檢查，而不是在定義的時候。
scope 在新定義bean 的時候被創建。假如沒有指定，預設值是page scope.
template tile/component/template (a JSP page)的URL .
下面的片段展示瞭如何在JSP中使用definition標籤。
page="/layouts/storefrontDefaultLayout.jsp"
scope="request">
/tiles:definition>
一個完整的例子將在這章後面的"Declaring Definitions in a JSP Page" 中展示
put 標籤🎀 標籤用一個組件發送到組件。 這個標籤只能在insert 或 definition 標籤內部使用。 put標籤的值被value 屬性或標籤體指定。也經常被指定值得類型。
string: 文如其名
page 或template: 內容包含指定的URL. 名字通常以URL用.
definition: 內容從指定(from factory)的定義獲得. 名字以已定義的名字使用。假如type 已經使用, 他就會被get 或insert 標籤插入到tile. 假如type 屬性沒有被指定，則內容是不確定的untyped,除非它來自一個typed bean.
提示: Setting direct="true" 與setting type="string" 是相同的.
Table 14-4 列出了put 標籤的屬性。
屬性名 描述
beanName Bean 的名稱，和值（value）的使用方法一樣.Bean是從非凡的內容中獲得。如果有的話，還可以用pageContext.findAttribute( ) 方法來取得。 假如beanProperty 屬性已經指定，可以從對應Bean屬性取得這個值 。
beanProperty Bean 屬性（property）的名字，假如指定，那麼這個值從Bean的屬性（property）中得到.
beanScope Bean的作用範圍，假如沒有指定，pageScope Bean的作用範圍，假如沒有指定，pageScope Bean的作用範圍，假如沒有使用，page Bean的範圍可以是任何的JSP, 元件（component），或是模板（template）。在後兩者情況（組件，模板），bean 可以在 Tiles (tile)/組件(component)/模板（template） 內容中
content Content 在tile 範圍內。 屬性相當於value 屬性，增加是為了於JSP template tags 相容。 .
Direct Content的控制方法: true表示Content直接顯示; false意味著content 被包含。 false 是預設值。也是指定content 型別的一種方法。假如 direct="true", content是 "string"; 假如 direct="false", content 是 "page".增加這個屬性是為了於JSP template tags 相容。 .
Name 屬性的名稱(name).
Role 假如使用者是指定的角色，那麼這個標記才會起作用，否則，這個標記會被忽略掉，並且不會寫出任何內容。
Type content 的型別(type)。有效值是"string", "page", "template", 或 "definition".
value 屬性的值，可以是String 或 Object. 值是直接被指派的。 (value="avalue") 或從一個bean 獲得。一個value, content, 或 beanName 一定存在。
putList 標籤
putList 標籤建立一個list，在 tile 中以值傳遞。 list 元素用add 標籤增加。這個標籤只能在insert 或definition 標籤中使用。
Table 14-5 列出putList 標籤的屬性。
屬性名 描述
Name List 的名稱。這個屬性是被要求的。
add 標籤
add 標籤是增加一個element 到四周的list 中。這個標籤只能在putList 標籤中使用。這個值可以直接被指派。 (value="avalue") 或從一個bean中獲得。 一個value 或beanName 必須被指定。
Table 14-6 列出 add 標籤的屬性。
屬性名 描述
beanName Bean 的名稱，和值（value）的使用方法是使用非凡的內容。假如有的話，還可以用pageContext.find
以上就是在Struts中使用Tiles框架的內容，更多相關文章請關注PHP中文網（www.php.cn）！
