Struts Tiles - <tiles:insert>タグ

タイル(コンポーネント、テンプレート)を挿入します。

属性

attribute
現在のタイル(コンポーネント)のコンテキストでの属性名。 この属性の値は、nameに渡されます。
beanName
値として使用されるBeanの名前。Beanは、指定したコンテキストから取得されます(存在する場合)。 存在しない場合は、pageContext.findAttributeメソッドが使用されます。 beanPropertyも指定する場合、値は対応するBeanプロパティから取得されます。 検出されたBean(またはプロパティ値)が、Attributeクラス(Direct、Instanceなど)のインスタンスの1つである場合、そのクラス・タイプに従って挿入が行われます。 それ以外の場合は、BeanでtoStringメソッドがコールされ、返された文字列が名前として使用されます(name属性を参照)。
beanProperty
Beanプロパティの名前。指定する場合、値はこのプロパティから取得されます。ネストされたプロパティと索引付きプロパティがサポートされます。
beanScope
Beanの検索先となるスコープ。 指定しない場合は、pageContext.findAttributeメソッドが使用されます。スコープには、任意のJSPスコープ、componentまたはtemplateを指定できます。 componentまたはtemplateの場合、Beanはタイル(コンポーネント、テンプレート)のコンテキスト内で検索されます。
component
挿入するコンポーネントのパス(webappsへの相対または絶対パス)。 page、componentおよびtemplateは同義です。すべて同じように動作します。
controllerClass
ページの挿入の直前にコールされるコントローラのクラス・タイプ。 コントローラは、挿入するタイルによりレンダリングされるデータを準備する際に使用されます。 controllerUrlも参照してください。controllerUrlまたはcontrollerClassのどちらか1つのみを使用します。 クラスは、次のいずれかを実装または拡張したものとなります。 (1)org.apache.struts.tiles.Controller、(2)org.apache.struts.tiles.ControllerSupport、または(3)org.apache.struts.action.Action(ラッパーorg.apache.struts.action.ActionControllerが使用されます)。
controllerUrl
ページの挿入の直前にコールされるコントローラのURL。 URLは、通常Strutsアクションを示します。 コントローラ(アクション)は、挿入するタイルによりレンダリングされるデータを準備する際に使用されます。
controllerClassも参照してください。 controllerUrlまたはcontrollerClassのどちらか1つのみを使用します。
definition
挿入する定義の名前。定義は、一元化されたファイルに記述します。現在のところ、この属性で挿入できるのは、ファクトリからの定義のみです。 <template:definition>タグで指定した定義を挿入する場合は、beanNameを使用します。
flush
trueまたはfalse。 trueに設定すると、挿入の前に現在のページの出力ストリームがフラッシュされます。
ignore
この属性をtrueに設定すると、nameにより指定した属性が存在しない場合、何も書き込まれずに処理が終了します。デフォルト値はfalseで、ランタイム例外がスローされます。
name
挿入するエンティティの名前。 この場合、 definitionattribute、タイル(コンポーネント、テンプレート、ページ)の順で検索が行われます。
page
挿入するページのパス(webappsへの相対または絶対パス)。 page、componentおよびtemplateは同義です。すべて同じように動作します。
role
指定したロールにユーザーが属する場合はタグが有効になり、属さない場合はタグが無視(スキップ)されます。
template
タイルまたはテンプレート(JSPページ)のURIを表す文字列。page、componentおよびtemplateは同義です。すべて同じように動作します。

説明

パラメータ(属性と呼ばれる)を渡す可能性のあるタイル(コンポーネント、テンプレート)を挿入します。 タイルは、場合によりパラメータや属性を含むプロシージャと考えることができます。 <template:insert>を使用すると、これらの属性を定義して、挿入されるJSPページ(テンプレート)に渡すことができます。 属性は、ネストされた<template:put>タグまたは<template:putList>タグを使用して定義します。
このタグでは、次のタグ属性のいずれか1つを指定する必要があります。


JDeveloperのStrutsカスタム・タグ・ライブラリについて
リファレンス: Strutsタグ・ライブラリ
リファレンス: Struts Tilesタグ・ライブラリ

 

Copyright © 1997, 2004, Oracle. All rights reserved.