このタグライブラリは、出力テキストの条件付生成の管理、オブジェクトコレクションによる 出力テキストの反復的な生成、および、アプリケーションフロー管理に有効なタグを含みます。

タグが値の比較 (equal, greaterEqual, greaterThan, lessEqual, lessThan, notEqual) を行うために、次のルールが適用されます。

• 指定された値は検査されます。それがdouble または long へ変換可能 な場合、最終的な比較が数 ( 浮動小数点または整数 ) であることを仮定します。 そうでなければ、 String 比較が行われます。
• 比較される変数は、このタグに存在するセレクタ属性（cookie, header, name, parameter, property）から検索されます。 それは、比較のために適切な型に変換されます。
• 指定された変数が検索できないか、null値の場合、リクエスト時に例外がスローされます。
• タグ特定の比較が実行され、比較の結果がtrueの場合、タグの中の内容が評価されます。

部分文字列の一致(match,notMatch)を行うタグについては、次のルールが適用されます:

• 指定された変数は、このタグ上にあるセレクタ属性（cookie, header, name, parameter, property）に基づいて検索されます。 必要な場合、変数は文字列に変換されます。
• 指定された変数が検索できないか、null値の場合、リクエスト時に例外がスローされます。
• 指定された値は、location属性によって指定された位置で、変数の部分文字列として存在を以下のようにチェックします。 : 先頭（locationがstartにセットされた場合）、最後（locationがendにセットされた場合）、 または どこでも（locationがセットされていない場合）。

このタグライブラリにあるタグの多くは、実行時の使用が不正であれば、JspExceptionをスローします （タグ属性に無効な組み合わせを指定した場合など）。 JSPは、<%@ page %>指令の中で、"error page"の宣言が可能です。 その問題を引き起こした実際の例外を処理したい場合は、キーorg.apache.struts.action.EXCEPTIONの下の リクエスト属性としてエラーページに渡されます。

Tag Name	Description
equal	要求された変数が指定した値と等しい場合、このタグ内の内容を評価します。
forward	ActionForward エントリによって指定したページへのフォワード制御。
greaterEqual	要求された変数が指定した値より大きいか等しい場合、このタグ内の内容を評価します。
greaterThan	要求された変数が指定した値より大きい場合、このタグ内の内容を評価します。
iterate	指定したコレクションで、このタグ内の内容を繰り返し評価します。
lessEqual	要求された変数が指定した値より小さいか等しい場合、このタグ内の内容を評価します。
lessThan	要求された変数が指定した値より小さい場合、このタグ内の内容を評価します。
match	指定した値が要求した変数の部分文字列に一致する場合、このタグ内の内容を評価します。
notEqual	要求された変数が指定した値と等しくない場合、このタグ内の内容を評価します。
notMatch	指定した値が要求した変数の部分文字列に一致しない場合、このタグ内の内容を評価します。
notPresent	指定した値がこのリクエストの中にない場合、このタグ内の内容を生成します。
present	指定した値がこのリクエストの中にある場合、このタグ内の内容を生成します。
redirect	HTTP Redirectを表現します。

セレクタ属性のうちのどれか1つで指定された変数と、指定された定数を比較します。 変数および値が等しい場合、このタグ内の内容が評価されます。

Attribute Name	Description
cookie	比較される変数は、この属性で指定した名前のクッキーの値です。 [RT Expr]
header	比較される変数は、この属性で指定した名前のヘッダーの値です。 名前の一致は大文字、小文字を無視します。 [RT Expr]
name	比較される変数は、この属性で指定したJSP bean（propertyが指定されていない場合）、 または この beanの指定した属性値（propertyが指定されている場合）。 [RT Expr]
parameter	比較される変数は、この属性で指定したリクエストパラメータの1番目の（または唯一の）値です。 [RT Expr]
property	比較される変数は、この属性によって指定された（name属性によって指定されたbeanの)プロパティです。 プロパティの参照は、ネストされたりインデックスが付けられることで単純になります。 [RT Expr]
scope	nameプロパティによって指定されたbean を検索する bean スコープ。 指定されない場合は、任意のスコープ。 [RT Expr]
value	このタグの他の属性に指定された変数が比較される定数値。 [Required] [RT Expr]

指定された名前へのグローバルActionForwardエントリの PageContext.forward() または HttpServletResponse.sendRedirect() 呼び出しを実行します。 リダイレクトが実行される場合、URLリライティングは自動的に行われます。

Attribute Name	Description
name	フォワード対象の識別に使用されるグローバルActionForwardエントリの論理名。 [Required] [RT Expr]

セレクタ属性のうちのどれか1つで指定された変数と、指定された定数を比較します。 変数および値が大きいか等しい場合、このタグ内の内容が評価されます。

Attribute Name	Description
cookie	比較される変数は、この属性で指定した名前のクッキーの値です。 [RT Expr]
header	比較される変数は、この属性で指定した名前のヘッダーの値です。 名前の一致は大文字、小文字を無視します。 [RT Expr]
name	比較される変数は、この属性で指定したJSP bean（propertyが指定されていない場合）、 または この beanの指定した属性値（propertyが指定されている場合）。 [RT Expr]
parameter	比較される変数は、この属性で指定したリクエストパラメータの1番目の（または唯一の）値です。 [RT Expr]
property	比較される変数は、この属性によって指定された（name属性によって指定されたbeanの)プロパティです。 プロパティの参照は、ネストされたりインデックスが付けられることで単純になります。 [RT Expr]
scope	nameプロパティによって指定されたbean を検索する beanスコープ。 指定されない場合は、任意のスコープ。 [RT Expr]
value	このタグの他の属性に指定された変数が比較される定数値。 [Required] [RT Expr]

セレクタ属性のうちのどれか1つで指定された変数と、指定された定数を比較します。 変数および値が大きい場合、このタグ内の内容が評価されます。

Attribute Name	Description
cookie	比較される変数は、この属性で指定した名前のクッキーの値です。 [RT Expr]
header	比較される変数は、この属性で指定した名前のヘッダーの値です。 名前の一致は大文字、小文字を無視します。 [RT Expr]
name	比較される変数は、この属性で指定したJSP bean（propertyが指定されていない場合）、 または この beanの指定した属性値（propertyが指定されている場合）。 [RT Expr]
parameter	比較される変数は、この属性で指定したリクエストパラメータの1番目の（または唯一の）値です。 [RT Expr]
property	比較される変数は、この属性によって指定された（name属性によって指定されたbeanの)プロパティです。 プロパティの参照は、ネストされたりインデックスが付けられることで単純になります。 [RT Expr]
scope	nameプロパティによって指定されたbean を検索する beanスコープ。 指定されない場合は、任意のスコープ。 [RT Expr]
value	このタグの他の属性に指定された変数が比較される定数値。 [Required] [RT Expr]

指定されたコレクション(Iterator、Collection、Mapまたは配列)のすべての要素ごとに、 このタグ内の内容を一度繰り返します。 繰り返されるコレクションは次の方法のうちの1つで指定しなければなりません：

• collection属性の値として指定したランタイム表現として指定。
• name属性で指定したJSP beanとして指定。
• name属性で指定したJSP beanのpropertyに指定したプロパティとして指定。

繰り返されるコレクションは、反復が成功するために次の必要条件のうちの1つに必ず合致しなければなりません:

• Javaオブジェクトの配列（"int"のようなプリミティブ型でないこと）。
• java.util.Collectionの実装。ArrayList と Vectorを含む。
• java.util.Enumerationの実装。
• java.util.Iteratorの実装。
• java.util.Mapの実装。HashMap、 Hashtable、および TreeMapを含む。 注意 - Mapのアクセスに関しては下の追加情報を参照。

通常、iterateタグによって表される各オブジェクトは、繰り返しているコレクションの要素です。 しかしながら、Mapを繰り返し処理する場合、展開されたオブジェクトはMap.Entry型であり、2つのプロパティを持ちます:

• key - このアイテムがMapに格納されるキー。
• value - このキーに対応する値。

Hashtableの値を繰り返し処理したい場合、次のようのコードを実装してください:

<logic:iterate id="element" name="myhashtable">
Next element is <bean:write name="element" property="value"/>
</logic:iterate>

繰り返し処理するコレクションが null値を含む場合、 ループは行われるでしょうが、ページスコープ属性(id属性によって指定)は そのループのためには作成されません。 このケースをテストするには、<logic:present> と <logic:notPresent> タグを使用してください。

警告 - 現在、このタグは多くのプリミティブ型を処理することができません。 Javaオブジェクト(String を含む)の配列だけがサポートされています。

Attribute Name	Description
collection	繰り返されるコレクション(上にリストされた必要条件に一致して)の評価を行うランタイム表現。 [RT Expr]
id	（nullでない場合）コレクションの各繰り返しで現在の要素を含むページスコープ JSP bean の名前。 [Required] [RT Expr]
indexId	コレクションの各繰り返しで現在のインデックスを含むページスコープ JSP bean の名前。 [RT Expr]
length	このページをとおして繰り返されるエントリ(元のコレクションから)の最大数。 これは希望の値を直接表現する整数あるいは希望の値を定義する型java.lang.IntegerのJSP bean (任意のスコープ内の)の名前です。 指定されない場合、実行された反復の数に制限はありません。 [RT Expr]
name	繰り返されるべきコレクションを含む JSP bean の名前（propertyが指定されていない場合）、 または プロパティ ゲッター が繰り返されるべきコレクションを戻す JSP beanの名前（propertyが指定されている場合）。 [RT Expr]
offset	元のコレクションで繰り返されるエントリの0相対のインデックス開始位置。 これは希望の値を直接表現する整数あるいは希望の値を定義する型java.lang.IntegerのJSP bean (任意のスコープ内の)の名前です。 指定されない場合、0が仮定されます。（コレクションが先頭から繰り返されるという意味)。 [RT Expr]
property	nameで指定した ゲッター が繰り返されるべきコレクションを戻す JSP beanのプロパティ名。 [RT Expr]
scope	nameプロパティによって指定されたbean を検索する beanスコープ。 指定されない場合は、任意のスコープ。 [RT Expr]
type	id属性で指定した JSP bean で表現される要素の完全修飾された Javaクラス名。 指定されない場合、型変換は行われません。 注 : コレクションの実際の要素はこのクラスに代入互換でなければならず、そうでない場合はリクエスト時にClassCastException が発生します。 [RT Expr]

セレクタ属性のうちのどれか1つで指定された変数と、指定された定数を比較します。 変数および値が小さいか等しい場合、このタグ内の内容が評価されます。

Attribute Name	Description
cookie	比較される変数は、この属性で指定した名前のクッキーの値です。 [RT Expr]
header	比較される変数は、この属性で指定した名前のヘッダーの値です。 名前の一致は大文字、小文字を無視します。 [RT Expr]
name	比較される変数は、この属性で指定したJSP bean（propertyが指定されていない場合）、 または この beanの指定した属性値（propertyが指定されている場合）。 [RT Expr]
parameter	比較される変数は、この属性で指定したリクエストパラメータの1番目の（または唯一の）値です。 [RT Expr]
property	比較される変数は、この属性によって指定された（name属性によって指定されたbeanの)プロパティです。 プロパティの参照は、ネストされたりインデックスが付けられることで単純になります。 [RT Expr]
scope	nameプロパティによって指定されたbean を検索する beanスコープ。 指定されない場合は、任意のスコープ。 [RT Expr]
value	このタグの他の属性に指定された変数が比較される定数値。 [Required] [RT Expr]

セレクタ属性のうちのどれか1つで指定された変数と、指定された定数を比較します。 変数および値が小さい場合、このタグ内の内容が評価されます。

Attribute Name	Description
cookie	比較される変数は、この属性で指定した名前のクッキーの値です。 [RT Expr]
header	比較される変数は、この属性で指定した名前のヘッダーの値です。 名前の一致は大文字、小文字を無視します。 [RT Expr]
name	比較される変数は、この属性で指定したJSP bean（propertyが指定されていない場合）、 または この beanの指定した属性値（propertyが指定されている場合）。 [RT Expr]
parameter	比較される変数は、この属性で指定したリクエストパラメータの1番目の（または唯一の）値です。 [RT Expr]
property	比較される変数は、この属性によって指定された（name属性によって指定されたbeanの)プロパティです。 プロパティの参照は、ネストされたりインデックスが付けられることで単純になります。 [RT Expr]
scope	nameプロパティによって指定されたbean を検索する beanスコープ。 指定されない場合は、任意のスコープ。 [RT Expr]
value	このタグの他の属性に指定された変数が比較される定数値。 [Required] [RT Expr]

指定された定数値に対するセレクタ属性(Stringとして)のうちの1つに指定された変数を一致させます。 値が部分文字列(適切にlocation属性によって制限された)である場合、このタグ内の内容が評価されます。

Attribute Name	Description
cookie	一致させる変数は、この属性で指定した名前のクッキーの値です。 [RT Expr]
header	一致させる変数は、この属性で指定した名前のヘッダーの値です。 名前の一致は大文字、小文字を無視します。 [RT Expr]
location	指定されない場合、変数と値の一致が可変文字列内のどこかで発生する場合があります。 指定された場合、一致は可変文字列の指定された位置（startまたはendのどちらかで）で行われます。 [RT Expr]
name	一致させる変数は、この属性で指定したJSP bean（propertyが指定されていない場合）、 または この beanの指定した属性値（propertyが指定されている場合）。 [RT Expr]
parameter	一致させる変数は、この属性で指定したリクエストパラメータの1番目の（または唯一の）値です。 [RT Expr]
property	一致させる変数は、この属性によって指定された（name属性によって指定されたbeanの)プロパティです。 プロパティの参照は、ネストされたりインデックスが付けられることで単純になります。 [RT Expr]
scope	nameプロパティによって指定されたbean を検索する beanスコープ。 指定されない場合は、任意のスコープ。 [RT Expr]
value	指定した変数の部分文字列として存在をチェックされる定数値。 [Required] [RT Expr]

セレクタ属性のうちのどれか1つで指定された変数と、指定された定数を比較します。 変数および値が等しくない場合、このタグ内の内容が評価されます。

Attribute Name	Description
cookie	比較される変数は、この属性で指定した名前のクッキーの値です。 [RT Expr]
header	比較される変数は、この属性で指定した名前のヘッダーの値です。 名前の一致は大文字、小文字を無視します。 [RT Expr]
name	比較される変数は、この属性で指定したJSP bean（propertyが指定されていない場合）、 または この beanの指定した属性値（propertyが指定されている場合）。 [RT Expr]
parameter	比較される変数は、この属性で指定したリクエストパラメータの1番目の（または唯一の）値です。 [RT Expr]
property	比較される変数は、この属性によって指定された（name属性によって指定されたbeanの)プロパティです。 プロパティの参照は、ネストされたりインデックスが付けられることで単純になります。 [RT Expr]
scope	nameプロパティによって指定されたbean を検索する beanスコープ。 指定されない場合は、任意のスコープ。 [RT Expr]
value	このタグの他の属性に指定された変数が比較される定数値。 [Required] [RT Expr]

指定された定数値に対するセレクタ属性(Stringとして)のうちの1つに指定された変数を一致させます。 値が部分文字列(適切にlocation属性によって制限された)でない場合、このタグ内の内容が評価されます。

Attribute Name	Description
cookie	一致させる変数は、この属性で指定した名前のクッキーの値です。 [RT Expr]
header	一致させる変数は、この属性で指定した名前のヘッダーの値です。 名前の一致は大文字、小文字を無視します。 [RT Expr]
location	指定されない場合、変数と値の一致が可変文字列内のどこかで発生する場合があります。 指定された場合、一致は可変文字列の指定された位置（startまたはendのどちらかで）で行われます。 [RT Expr]
name	一致させる変数は、この属性で指定したJSP bean（propertyが指定されていない場合）、 または この beanの指定した属性値（propertyが指定されている場合）。 [RT Expr]
parameter	一致させる変数は、この属性で指定したリクエストパラメータの1番目の（または唯一の）値です。 [RT Expr]
property	一致させる変数は、この属性によって指定された（name属性によって指定されたbeanの)プロパティです。 プロパティの参照は、ネストされたりインデックスが付けられることで単純になります。 [RT Expr]
scope	nameプロパティによって指定されたbean を検索する beanスコープ。 指定されない場合は、任意のスコープ。 [RT Expr]
value	指定した変数の部分文字列として存在をチェックされる定数値。 [Required] [RT Expr]

指定された属性に従ってこのタグは現在のリクエストをチェックして、指定された値が存在しない場合のみ、タグ内の内容が評価されます。 このタグの1回の発生につき、1つの属性だけがこの使用されます（property属性以外は）。 property属性を使用した場合name属性も必要です。

Attribute Name	Description
cookie	指定した名前のクッキーが存在するかをチェックします。 [RT Expr]
header	指定した名前の HTTPヘッダー が存在するかをチェックします。 名前の一致は大文字、小文字を無視します。 [RT Expr]
name	全てのスコープで、指定した名前の JSP bean が存在するかをチェックします。 propertyもあわせて指定された場合は、指定されたプロパティに対する nullでないプロパティ値をチェックします。 [RT Expr]
parameter	パラメータ値が長さ0の文字列であっても、少なくとも1回は発生するこのリクエスト中の指定されたリクエストパラメータの存在をチェックします。 [RT Expr]
property	name属性で指定した JSP bean（任意のスコープ）のプロパティ ゲッター によって戻される nullでないプロパティ値の存在をチェックします。 プロパティの参照は、ネストされたりインデックスが付けられることで単純になります。 [RT Expr]
role	現在の認証済みユーザが（もしあれば）指定されたセキュリティ ロールと関連付けられているかをチェックします。 [RT Expr]
scope	nameプロパティによって指定されたbean を検索する beanスコープ。 指定されない場合は、任意のスコープ。 [RT Expr]
user	現在の認証済みユーザが指定された名前を持っているかをチェックします。 [RT Expr]

指定された属性に従ってこのタグは現在のリクエストをチェックして、指定された値が存在する場合のみ、タグ内の内容が評価されます。 このタグの1回の発生につき、1つの属性だけがこの使用されます（property属性以外は）。 property属性を使用した場合name属性も必要です。

Attribute Name	Description
cookie	指定した名前のクッキーが存在するかをチェックします。 [RT Expr]
header	指定した名前の HTTPヘッダー が存在するかをチェックします。 名前の一致は大文字、小文字を無視します。 [RT Expr]
name	全てのスコープで、指定した名前の JSP bean が存在するかをチェックします。 propertyもあわせて指定された場合は、指定されたプロパティに対する nullでないプロパティ値をチェックします。 [RT Expr]
parameter	パラメータ値が長さ0の文字列であっても、少なくとも1回は発生するこのリクエスト中の指定されたリクエストパラメータの存在をチェックします。 [RT Expr]
property	name属性で指定した JSP bean（任意のスコープ）のプロパティ ゲッター によって戻される nullでないプロパティ値の存在をチェックします。 プロパティの参照は、ネストされたりインデックスが付けられることで単純になります。 [RT Expr]
role	現在の認証済みユーザが（もしあれば）指定されたセキュリティ ロールと関連付けられているかをチェックします。 [RT Expr]
scope	nameプロパティによって指定されたbean を検索する beanスコープ。 指定されない場合は、任意のスコープ。 [RT Expr]
user	現在の認証済みユーザが指定された名前を持っているかをチェックします。 [RT Expr]

このタグの属性に指定したハイパーリンクを呼び出すために、HttpServletResponse.sendRedirect() を実行します。 URLリライティングは、クッキー不使用の状態でセッション状態を維持するためには自動的に実施されます。

このリダイレクトのためのベースURLは、次のうちの属性（どれか一つを必ず正確に指定する必要があります）に基づいて求められます。

• forward - グローバルActionForward名をこの属性値を探すために使用します。 そして、そこで見つけた コンテキスト相対URIを使用します。
• href - この属性値を変更せずに使用します。
• page - コンテキスト相対URIとしてこの属性の値を使用します。 そして、コンテキストパスを含むことで サーバ相対URIを生成します。

通常、今説明した属性のうちの1つで指定されたリダイレクトが変更されることはないでしょう(URLリライティングが必要な場合以外は)。 しかしながら、定義された照会パラメータを1つ以上動的にハイパーリンクに追加するには2つの方法があります。 -- paramId属性(値を選択するためにその関連する属性)で単一のパラメータを指定するか、 1つ以上のパラメータidと対応する値を含む java.util.Map bean を選択するためのname （とオプションのproperty）属性を指定します。

単一パラメータを指定する場合、サブミットされるリクエストパラメータの名前を定義するためのparamId属性を使用してください。 対応する値を指定する場合、次のアプローチにどれかを使用してください。

• paramName 属性のみを指定する - 指定されたJSP bean (paramScope属性の値によってスコープ指定されることもある) は、 文字列に変換できる値を識別します。
• paramName と paramProperty 属性の両方を指定する - 指定されたプロパティ ゲッター メソッドは、文字列に変換することができる値を選択するために paramName （とオプションのparamScope） 属性で識別された JSP beanを使用します。

ハイパーリンクに加えられるリクエストパラメータをすべて含むjava.util.Mapの指定を好む場合、 次のテクニックのどれかを使用してください。

• name 属性のみを指定する - 指定された JSP bean (scope属性の値によってスコープ指定されることもある) は、 パラメータを含む java.util.Map を識別します。
• name と property 属性の両方を指定する - 指定されたプロパティ ゲッター メソッドは、パラメータを含む java.util.Map を戻すために、 name （とオプションのscope） 属性で識別された bean を使用します。

Map が処理されると、キーはハイパーリンクに付加される照会パラメータ名であると仮定されます。 各キーに関連した値はパラメータ値を表わす文字列あるいは文字列配列のいずれかです。 文字列配列が指定される場合、同じ照会パラメータ名に対応する1つ以上の値が作成されます。

Attribute Name	Description
anchor	生成されたハイパーリンクに付加されるオプションのアンカタグ（"#xxx"）。 この値は、"#" を含まずに指定してください。 [RT Expr]
forward	このリダイレクト先の有効なcontent-relativeなURIを含むグローバルActionForward の論理名。 このURIは、タグの説明にあるように照会パラメータを含むことで動的に修正されるかもしれません。 必ず、forward属性、href属性、 linkName属性、またはpage属性のどれか1つを正確に指定しなければなりません。 [RT Expr]
href	このリダイレクトで転送されるURL。 このURLは、タグの説明にあるように照会パラメータを含むことで動的に修正されるかもしれません。 必ず、forward属性、href属性、 linkName属性、またはpage属性のどれか1つを正確に指定しなければなりません。 [RT Expr]
name	照会パラメータ表す Map を含む JSP bean の名前（propertyが指定されていない場合）、 または プロパティ ゲッター が Map を戻す JSP bean の名前（propertyが指定されている場合）。 [RT Expr]
page	もしアクティブならば、このハイパーリンクが転送される("/"文字から始まる)コンテキスト相対パス。 このハイパーリンクは、タグの説明にあるように照会パラメータを含むことで動的に修正されるかもしれません。 必ず、forward属性、href属性、 linkName属性、またはpage属性のどれか1つを正確に指定しなければなりません。 [RT Expr]
paramId	生成されたハイパーリンクに動的に追加されるリクエストパラメータの名前。 対応する値は、paramScope属性によってスコープ設定され、paramNameおよびparamProperty属性(オプション)により定義されます。 [RT Expr]
paramName	(paramPropertyが指定されない場合に)paramIdで指定したリクエストパラメータを含む文字列であるJSP bena名、 または (paramPropertyが指定された場合) 文字列を返すためにプロパティ ゲッター が呼ばれるJSP bean。 JSP beanは、それが指定される場合にparamScopeプロパティで指定して bean スコープに制限されます。 [RT Expr]
paramProperty	paramName属性（その返り値はこのハイパーリンクに動的に加えられるリクエストパラメータ(paramId属性によって指定された)の値を含む文字列)によって指定された bean のプロパティの名前。 [RT Expr]
paramScope	paramName属性によって指定されたbeanを検索するスコープ。 指定されない場合、すべてのスコープが検索されます。 [RT Expr]
property	name属性（その戻り値はハイパーリンクに加えられる照会パラメータを含んでいるjava.util.Map）によって指定されたbeanのプロパティ名。 この属性を指定する場合、必ず name属性を指定する必要があります。 [RT Expr]
scope	name 属性によって指定された bean を検索するスコープ。 指定されない場合は、すべてのスコープが検索されます。 [RT Expr]
transaction	このリダイレクトのために生成したURLに現在のトランザクション制御トークンを含める場合は、trueにセットしてください。 [RT Expr]