This tag library contains tags that are useful in managing conditional generation of output text, looping over object collections for repetitive generation of output text, and application flow management.

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

For tags that do value comparisons (equal, greaterEqual, greaterThan, lessEqual, lessThan, notEqual), the following rules apply:

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

• The specified value is examined. If it can be converted successfully to a double or a long, it is assumed that the ultimate comparison will be numeric (either floating point or integer). Otherwise, a String comparison will be performed.


• 指定された値は検査されます。それがdouble または long へ変換可能 な場合、最終的な比較が数 ( 浮動小数点または整数 ) であることを仮定します。 そうでなければ、 String 比較が行われます。
• The variable to be compared to is retrieved, based on the selector attribute(s) (cookie, header, name, parameter, property) present on this tag. It will be converted to the appropriate type for the comparison, as determined above.


• 比較される変数は、このタグに存在するセレクタ属性（cookie, header, name, parameter, property）から検索されます。 それは、比較のために適切な型に変換されます。
• A request time exception will be thrown if the specified variable cannot be retrieved, or has a null value.


• 指定された変数が検索できないか、null値の場合、リクエスト時に例外がスローされます。
• The specific comparison for this tag will be performed, and the nested body content of this tag will be evaluated if the comparison returns a true result.


• タグ特定の比較が実行され、比較の結果がtrueの場合、タグの中の内容が評価されます。

For tags that do substring matching (match, notMatch), the following rules apply:

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

• The specified variable is retrieved, based on the selector attribute(s) (cookie, header, name, parameter, property) present on this tag. The variable is converted to a String, if necessary.


• 指定された変数は、このタグ上にあるセレクタ属性（cookie, header, name, parameter, property）に基づいて検索されます。 必要な場合、変数は文字列に変換されます。
• A request time exception will be thrown if the specified variable cannot be retrieved, or has a null value.


• 指定された変数が検索できないか、null値の場合、リクエスト時に例外がスローされます。
• The specified value is checked for existence as a substring of the variable, in the position specified by the location attribute, as follows: at the beginning (if location is set to start), at the end (if location is set to end), or anywhere (if location is not specified).


• 指定された値は、location属性によって指定された位置で、変数の部分文字列として存在を以下のようにチェックします。 : 先頭（locationがstartにセットされた場合）、最後（locationがendにセットされた場合）、 または どこでも（locationがセットされていない場合）。

Many of the tags in this tag library will throw a JspException at runtime when they are utilized incorrectly (such as when you specify an invalid combination of tag attributes). JSP allows you to declare an "error page" in the <%@ page %> directive. If you wish to process the actual exception that caused the problem, it is passed to the error page as a request attribute under key org.apache.struts.action.EXCEPTION.

このタグライブラリにあるタグの多くは、実行時の使用が不正であれば、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を表現します。

Compares the variable specified by one of the selector attributes against the specified constant value. The nested body content of this tag is evaluated if the variable and value are equal.

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

Attribute Name	Description
cookie	The variable to be compared is the value of the cookie whose name is specified by this attribute. 比較される変数は、この属性で指定した名前のクッキーの値です。 [RT Expr]
header	The variable to be compared is the value of the header whose name is specified by this attribute. The name match is performed in a case insensitive manner. 比較される変数は、この属性で指定した名前のヘッダーの値です。 名前の一致は大文字、小文字を無視します。 [RT Expr]
name	The variable to be compared is the JSP bean specified by this attribute, if property is not specified, or the value of the specified property of this bean, if property is specified. 比較される変数は、この属性で指定したJSP bean（propertyが指定されていない場合）、 または この beanの指定した属性値（propertyが指定されている場合）。 [RT Expr]
parameter	The variable to be compared is the first, or only, value of the request parameter specified by this attribute. 比較される変数は、この属性で指定したリクエストパラメータの1番目の（または唯一の）値です。 [RT Expr]
property	The variable to be compared is the property (of the bean specified by the name attribute) specified by this attribute. The property reference can be simple, nested, and/or indexed. 比較される変数は、この属性によって指定された（name属性によって指定されたbeanの)プロパティです。 プロパティの参照は、ネストされたりインデックスが付けられることで単純になります。 [RT Expr]
scope	The bean scope within which to search for the bean named by the name property, or "any scope" if not specified. nameプロパティによって指定されたbean を検索する bean スコープ。 指定されない場合は、任意のスコープ。 [RT Expr]
value	The constant value to which the variable, specified by other attribute(s) of this tag, will be compared. このタグの他の属性に指定された変数が比較される定数値。 [Required] [RT Expr]

Performs a PageContext.forward() or HttpServletResponse.sendRedirect() call for the global ActionForward entry for the specified name. URL rewriting will occur automatically if a redirect is performed.

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

Attribute Name	Description
name	The logical name of the global ActionForward entry that identifies the destination, and forwarding approach, to be used. フォワード対象の識別に使用されるグローバルActionForwardエントリの論理名。 [Required] [RT Expr]

Compares the variable specified by one of the selector attributes against the specified constant value. The nested body content of this tag is evaluated if the variable is greater than or equal to the value.

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

Attribute Name	Description
cookie	The variable to be compared is the value of the cookie whose name is specified by this attribute. 比較される変数は、この属性で指定した名前のクッキーの値です。 [RT Expr]
header	The variable to be compared is the value of the header whose name is specified by this attribute. The name match is performed in a case insensitive manner. 比較される変数は、この属性で指定した名前のヘッダーの値です。 名前の一致は大文字、小文字を無視します。 [RT Expr]
name	The variable to be compared is the JSP bean specified by this attribute, if property is not specified, or the value of the specified property of this bean, if property is specified. 比較される変数は、この属性で指定したJSP bean（propertyが指定されていない場合）、 または この beanの指定した属性値（propertyが指定されている場合）。 [RT Expr]
parameter	The variable to be compared is the first, or only, value of the request parameter specified by this attribute. 比較される変数は、この属性で指定したリクエストパラメータの1番目の（または唯一の）値です。 [RT Expr]
property	The variable to be compared is the property (of the bean specified by the name attribute) specified by this attribute. The property reference can be simple, nested, and/or indexed. 比較される変数は、この属性によって指定された（name属性によって指定されたbeanの)プロパティです。 プロパティの参照は、ネストされたりインデックスが付けられることで単純になります。 [RT Expr]
scope	The bean scope within which to search for the bean named by the name property, or "any scope" if not specified. nameプロパティによって指定されたbean を検索する beanスコープ。 指定されない場合は、任意のスコープ。 [RT Expr]
value	The constant value to which the variable, specified by other attribute(s) of this tag, will be compared. このタグの他の属性に指定された変数が比較される定数値。 [Required] [RT Expr]

Compares the variable specified by one of the selector attributes against the specified constant value. The nested body content of this tag is evaluated if the variable is greater than the value.

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

Attribute Name	Description
cookie	The variable to be compared is the value of the cookie whose name is specified by this attribute. 比較される変数は、この属性で指定した名前のクッキーの値です。 [RT Expr]
header	The variable to be compared is the value of the header whose name is specified by this attribute. The name match is performed in a case insensitive manner. 比較される変数は、この属性で指定した名前のヘッダーの値です。 名前の一致は大文字、小文字を無視します。 [RT Expr]
name	The variable to be compared is the JSP bean specified by this attribute, if property is not specified, or the value of the specified property of this bean, if property is specified. 比較される変数は、この属性で指定したJSP bean（propertyが指定されていない場合）、 または この beanの指定した属性値（propertyが指定されている場合）。 [RT Expr]
parameter	The variable to be compared is the first, or only, value of the request parameter specified by this attribute. 比較される変数は、この属性で指定したリクエストパラメータの1番目の（または唯一の）値です。 [RT Expr]
property	The variable to be compared is the property (of the bean specified by the name attribute) specified by this attribute. The property reference can be simple, nested, or indexed. 比較される変数は、この属性によって指定された（name属性によって指定されたbeanの)プロパティです。 プロパティの参照は、ネストされたりインデックスが付けられることで単純になります。 [RT Expr]
scope	The bean scope within which to search for the bean named by the name property, or "any scope" if not specified. nameプロパティによって指定されたbean を検索する beanスコープ。 指定されない場合は、任意のスコープ。 [RT Expr]
value	The constant value to which the variable, specified by other attribute(s) of this tag, will be compared. このタグの他の属性に指定された変数が比較される定数値。 [Required] [RT Expr]

Repeats the nested body content of this tag once for every element of the specified collection, which must be an Iterator, a Collection, a Map (whose values are to be iterated over), or an array. The collection to be iterated over must be specified in one of the following ways:

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

• As a runtime expression specified as the value of the collection attribute.


• collection属性の値として指定したランタイム表現として指定。
• As a JSP bean specified by the name attribute.


• name属性で指定したJSP beanとして指定。
• As the property, specified by the property, of the JSP bean specified by the name attribute.


• name属性で指定したJSP beanのpropertyに指定したプロパティとして指定。

The collection to be iterated over MUST conform to one of the following requirements in order for iteration to be successful:

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

• An array of Java objects (but not primitive data types such as "int")


• Javaオブジェクトの配列（"int"のようなプリミティブ型でないこと）。
• An implementation of java.util.Collection, including ArrayList and Vector.


• java.util.Collectionの実装。ArrayList と Vectorを含む。
• An implementation of java.util.Enumeration.


• java.util.Enumerationの実装。
• An implementation of java.util.Iterator.


• java.util.Iteratorの実装。
• An implementation of java.util.Map, including HashMap, Hashtable, and TreeMap. NOTE - See below for additional information about accessing Maps.


• java.util.Mapの実装。HashMap、 Hashtable、および TreeMapを含む。 注意 - Mapのアクセスに関しては下の追加情報を参照。

Normally, each object exposed by the iterate tag is an element of the underlying collection you are iterating over. However, if you iterate over a Map, the exposed object is of type Map.Entry that has two properties:

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

• key - The key under which this item is stored in the underlying Map.


• key - このアイテムがMapに格納されるキー。
• value - The value that corresponds to this key.


• value - このキーに対応する値。

So, if you wish to iterate over the values of a Hashtable, you would implement code like the following:

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

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

If the collection you are iterating over can contain null values, the loop will still be performed but no page scope attribute (named by the id attribute) will be created for that loop iteration. You can use the <logic:present> and <logic:notPresent> tags to test for this case.

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

WARNING - Currently, this tag cannot deal with arrays of primitive data types. Only arrays of Java objects (including Strings) are supported.

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

Attribute Name	Description
collection	A runtime expression that evaluates to a collection (conforming to the requirements listed above) to be iterated over. 繰り返されるコレクション(上にリストされた必要条件に一致して)の評価を行うランタイム表現。 [RT Expr]
id	The name of a page scope JSP bean that will contain the current element of the collection on each iteration, if it is not null. （nullでない場合）コレクションの各繰り返しで現在の要素を含むページスコープ JSP bean の名前。 [Required] [RT Expr]
indexId	The name of a page scope JSP bean that will contain the current index of the collection on each iteration. コレクションの各繰り返しで現在のインデックスを含むページスコープ JSP bean の名前。 [RT Expr]
length	The maximum number of entries (from the underlying collection) to be iterated through on this page. This can be either an integer that directly expresses the desired value, or the name of a JSP bean (in any scope) of type java.lang.Integer that defines the desired value. If not present, there will be no limit on the number of iterations performed. このページをとおして繰り返されるエントリ(元のコレクションから)の最大数。 これは希望の値を直接表現する整数あるいは希望の値を定義する型java.lang.IntegerのJSP bean (任意のスコープ内の)の名前です。 指定されない場合、実行された反復の数に制限はありません。 [RT Expr]
name	The name of the JSP bean containing the collection to be iterated (if property is not specified), or the JSP bean whose property getter returns the collection to be iterated (if property is specified). 繰り返されるべきコレクションを含む JSP bean の名前（propertyが指定されていない場合）、 または プロパティ ゲッター が繰り返されるべきコレクションを戻す JSP beanの名前（propertyが指定されている場合）。 [RT Expr]
offset	The zero-relative index of the starting point at which entries from the underlying collection will be iterated through. This can be either an integer that directly expresses the desired value, or the name of a JSP bean (in any scope) of type java.lang.Integer that defines the desired value. If not present, zero is assumed (meaning that the collection will be iterated from the beginning. 元のコレクションで繰り返されるエントリの0相対のインデックス開始位置。 これは希望の値を直接表現する整数あるいは希望の値を定義する型java.lang.IntegerのJSP bean (任意のスコープ内の)の名前です。 指定されない場合、0が仮定されます。（コレクションが先頭から繰り返されるという意味)。 [RT Expr]
property	Name of the property, of the JSP bean specified by name, whose getter returns the collection to be iterated. nameで指定した ゲッター が繰り返されるべきコレクションを戻す JSP beanのプロパティ名。 [RT Expr]
scope	The bean scope within which to search for the bean named by the name property, or "any scope" if not specified. nameプロパティによって指定されたbean を検索する beanスコープ。 指定されない場合は、任意のスコープ。 [RT Expr]
type	Fully qualified Java class name of the element to be exposed through the JSP bean named from the id attribute. If not present, no type conversions will be performed. NOTE: The actual elements of the collection must be assignment-compatible with this class, or a request time ClassCastException will occur. id属性で指定した JSP bean で表現される要素の完全修飾された Javaクラス名。 指定されない場合、型変換は行われません。 注 : コレクションの実際の要素はこのクラスに代入互換でなければならず、そうでない場合はリクエスト時にClassCastException が発生します。 [RT Expr]

Compares the variable specified by one of the selector attributes against the specified constant value. The nested body content of this tag is evaluated if the variable is less than or equal to the value.

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

Attribute Name	Description
cookie	The variable to be compared is the value of the cookie whose name is specified by this attribute. 比較される変数は、この属性で指定した名前のクッキーの値です。 [RT Expr]
header	The variable to be compared is the value of the header whose name is specified by this attribute. The name match is performed in a case insensitive manner. 比較される変数は、この属性で指定した名前のヘッダーの値です。 名前の一致は大文字、小文字を無視します。 [RT Expr]
name	The variable to be compared is the JSP bean specified by this attribute, if property is not specified, or the value of the specified property of this bean, if property is specified. 比較される変数は、この属性で指定したJSP bean（propertyが指定されていない場合）、 または この beanの指定した属性値（propertyが指定されている場合）。 [RT Expr]
parameter	The variable to be compared is the first, or only, value of the request parameter specified by this attribute. 比較される変数は、この属性で指定したリクエストパラメータの1番目の（または唯一の）値です。 [RT Expr]
property	The variable to be compared is the property (of the bean specified by the name attribute) specified by this attribute. The property reference can be simple, nested, or indexed. 比較される変数は、この属性によって指定された（name属性によって指定されたbeanの)プロパティです。 プロパティの参照は、ネストされたりインデックスが付けられることで単純になります。 [RT Expr]
scope	The bean scope within which to search for the bean named by the name property, or "any scope" if not specified. nameプロパティによって指定されたbean を検索する beanスコープ。 指定されない場合は、任意のスコープ。 [RT Expr]
value	The constant value to which the variable, specified by other attribute(s) of this tag, will be compared. このタグの他の属性に指定された変数が比較される定数値。 [Required] [RT Expr]

Compares the variable specified by one of the selector attributes against the specified constant value. The nested body content of this tag is evaluated if the variable is less than the value.

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

Attribute Name	Description
cookie	The variable to be compared is the value of the cookie whose name is specified by this attribute. 比較される変数は、この属性で指定した名前のクッキーの値です。 [RT Expr]
header	The variable to be compared is the value of the header whose name is specified by this attribute. The name match is performed in a case insensitive manner. 比較される変数は、この属性で指定した名前のヘッダーの値です。 名前の一致は大文字、小文字を無視します。 [RT Expr]
name	The variable to be compared is the JSP bean specified by this attribute, if property is not specified, or the value of the specified property of this bean, if property is specified. 比較される変数は、この属性で指定したJSP bean（propertyが指定されていない場合）、 または この beanの指定した属性値（propertyが指定されている場合）。 [RT Expr]
parameter	The variable to be compared is the first, or only, value of the request parameter specified by this attribute. 比較される変数は、この属性で指定したリクエストパラメータの1番目の（または唯一の）値です。 [RT Expr]
property	The variable to be compared is the property (of the bean specified by the name attribute) specified by this attribute. The property reference can be simple, nested, and/or indexed. 比較される変数は、この属性によって指定された（name属性によって指定されたbeanの)プロパティです。 プロパティの参照は、ネストされたりインデックスが付けられることで単純になります。 [RT Expr]
scope	The bean scope within which to search for the bean named by the name property, or "any scope" if not specified. nameプロパティによって指定されたbean を検索する beanスコープ。 指定されない場合は、任意のスコープ。 [RT Expr]
value	The constant value to which the variable, specified by other attribute(s) of this tag, will be compared. このタグの他の属性に指定された変数が比較される定数値。 [Required] [RT Expr]

Matches the variable specified by one of the selector attributes (as a String) against the specified constant value. If the value is a substring (appropriately limited by the location attribute), the nested body content of this tag is evaluated.

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

Attribute Name	Description
cookie	The variable to be matched is the value of the cookie whose name is specified by this attribute. 一致させる変数は、この属性で指定した名前のクッキーの値です。 [RT Expr]
header	The variable to be matched is the value of the header whose name is specified by this attribute. The name match is performed in a case insensitive manner. 一致させる変数は、この属性で指定した名前のヘッダーの値です。 名前の一致は大文字、小文字を無視します。 [RT Expr]
location	If not specified, a match between the variable and the value may occur at any position within the variable string. If specified, the match must occur at the specified location (either start or end) of the variable string. 指定されない場合、変数と値の一致が可変文字列内のどこかで発生する場合があります。 指定された場合、一致は可変文字列の指定された位置（startまたはendのどちらかで）で行われます。 [RT Expr]
name	The variable to be matched is the JSP bean specified by this attribute, if property is not specified, or the value of the specified property of this bean, if property is specified. 一致させる変数は、この属性で指定したJSP bean（propertyが指定されていない場合）、 または この beanの指定した属性値（propertyが指定されている場合）。 [RT Expr]
parameter	The variable to be matched is the first, or only, value of the request parameter specified by this attribute. 一致させる変数は、この属性で指定したリクエストパラメータの1番目の（または唯一の）値です。 [RT Expr]
property	The variable to be matched is the property (of the bean specified by the name attribute) specified by this attribute. The property reference can be simple, nested, and/or indexed. 一致させる変数は、この属性によって指定された（name属性によって指定されたbeanの)プロパティです。 プロパティの参照は、ネストされたりインデックスが付けられることで単純になります。 [RT Expr]
scope	The bean scope within which to search for the bean named by the name property, or "any scope" if not specified. nameプロパティによって指定されたbean を検索する beanスコープ。 指定されない場合は、任意のスコープ。 [RT Expr]
value	The constant value which is checked for existence as a substring of the specified variable. 指定した変数の部分文字列として存在をチェックされる定数値。 [Required] [RT Expr]

Compares the variable specified by one of the selector attributes against the specified constant value. The nested body content of this tag is evaluated if the variable and value are not equal.

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

Attribute Name	Description
cookie	The variable to be compared is the value of the cookie whose name is specified by this attribute. 比較される変数は、この属性で指定した名前のクッキーの値です。 [RT Expr]
header	The variable to be compared is the value of the header whose name is specified by this attribute. The name match is performed in a case insensitive manner. 比較される変数は、この属性で指定した名前のヘッダーの値です。 名前の一致は大文字、小文字を無視します。 [RT Expr]
name	The variable to be compared is the JSP bean specified by this attribute, if property is not specified, or the value of the specified property of this bean, if property is specified. 比較される変数は、この属性で指定したJSP bean（propertyが指定されていない場合）、 または この beanの指定した属性値（propertyが指定されている場合）。 [RT Expr]
parameter	The variable to be compared is the first, or only, value of the request parameter specified by this attribute. 比較される変数は、この属性で指定したリクエストパラメータの1番目の（または唯一の）値です。 [RT Expr]
property	The variable to be compared is the property (of the bean specified by the name attribute) specified by this attribute. The property reference can be simple, nested, and/or indexed. 比較される変数は、この属性によって指定された（name属性によって指定されたbeanの)プロパティです。 プロパティの参照は、ネストされたりインデックスが付けられることで単純になります。 [RT Expr]
scope	The bean scope within which to search for the bean named by the name property, or "any scope" if not specified. nameプロパティによって指定されたbean を検索する beanスコープ。 指定されない場合は、任意のスコープ。 [RT Expr]
value	The constant value to which the variable, specified by other attribute(s) of this tag, will be compared. このタグの他の属性に指定された変数が比較される定数値。 [Required] [RT Expr]

Matches the variable specified by one of the selector attributes (as a String) against the specified constant value. If the value is not a substring (appropriately limited by the location attribute), the nested body content of this tag is evaluated.

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

Attribute Name	Description
cookie	The variable to be matched is the value of the cookie whose name is specified by this attribute. 一致させる変数は、この属性で指定した名前のクッキーの値です。 [RT Expr]
header	The variable to be matched is the value of the header whose name is specified by this attribute. The name match is performed in a case insensitive manner. 一致させる変数は、この属性で指定した名前のヘッダーの値です。 名前の一致は大文字、小文字を無視します。 [RT Expr]
location	If not specified, a match between the variable and the value may occur at any position within the variable string. If specified, the match must occur at the specified location (either start or end) of the variable string. 指定されない場合、変数と値の一致が可変文字列内のどこかで発生する場合があります。 指定された場合、一致は可変文字列の指定された位置（startまたはendのどちらかで）で行われます。 [RT Expr]
name	The variable to be matched is the JSP bean specified by this attribute, if property is not specified, or the value of the specified property of this bean, if property is specified. 一致させる変数は、この属性で指定したJSP bean（propertyが指定されていない場合）、 または この beanの指定した属性値（propertyが指定されている場合）。 [RT Expr]
parameter	The variable to be matched is the first, or only, value of the request parameter specified by this attribute. 一致させる変数は、この属性で指定したリクエストパラメータの1番目の（または唯一の）値です。 [RT Expr]
property	The variable to be matched is the property (of the bean specified by the name attribute) specified by this attribute. The property reference can be simple, nested, and/or indexed. 一致させる変数は、この属性によって指定された（name属性によって指定されたbeanの)プロパティです。 プロパティの参照は、ネストされたりインデックスが付けられることで単純になります。 [RT Expr]
scope	The bean scope within which to search for the bean named by the name property, or "any scope" if not specified. nameプロパティによって指定されたbean を検索する beanスコープ。 指定されない場合は、任意のスコープ。 [RT Expr]
value	The constant value which is checked for existence as a substring of the specified variable. 指定した変数の部分文字列として存在をチェックされる定数値。 [Required] [RT Expr]

Depending on which attribute is specified, this tag checks the current request, and evaluates the nested body content of this tag only if the specified value is not present. Only one of the attributes may be used in one occurrence of this tag, unless you use the property attribute, in which case the name attribute is also required.

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

Attribute Name	Description
cookie	Checks for the existence of a cookie with the specified name. 指定した名前のクッキーが存在するかをチェックします。 [RT Expr]
header	Checks for the existence of an HTTP header with the specified name. The name match is performed in a case insensitive manner. 指定した名前の HTTPヘッダー が存在するかをチェックします。 名前の一致は大文字、小文字を無視します。 [RT Expr]
name	Checks for the existence of a JSP bean, in any scope, with the specified name. If property is also specified, checks for a non-null property value for the specified property. 全てのスコープで、指定した名前の JSP bean が存在するかをチェックします。 propertyもあわせて指定された場合は、指定されたプロパティに対する nullでないプロパティ値をチェックします。 [RT Expr]
parameter	Checks for the existence of at least one occurrence of the specified request parameter on this request, even if the parameter value is a zero-length string. パラメータ値が長さ0の文字列であっても、少なくとも1回は発生するこのリクエスト中の指定されたリクエストパラメータの存在をチェックします。 [RT Expr]
property	Checks for the existence of a non-null property value, returned by a property getter method on the JSP bean (in any scope) that is specified by the name attribute. Property references can be simple, nested, and/or indexed. name属性で指定した JSP bean（任意のスコープ）のプロパティ ゲッター によって戻される nullでないプロパティ値の存在をチェックします。 プロパティの参照は、ネストされたりインデックスが付けられることで単純になります。 [RT Expr]
role	Checks whether the currently authenticated user (if any) has been associated with the specified security role. 現在の認証済みユーザが（もしあれば）指定されたセキュリティ ロールと関連付けられているかをチェックします。 [RT Expr]
scope	The bean scope within which to search for the bean named by the name property, or "any scope" if not specified. nameプロパティによって指定されたbean を検索する beanスコープ。 指定されない場合は、任意のスコープ。 [RT Expr]
user	Checks whether the currently authenticated user principal has the specified name. 現在の認証済みユーザが指定された名前を持っているかをチェックします。 [RT Expr]

Depending on which attribute is specified, this tag checks the current request, and evaluates the nested body content of this tag only if the specified value is present. Only one of the attributes may be used in one occurrence of this tag, unless you use the property attribute, in which case the name attribute is also required.

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

Attribute Name	Description
cookie	Checks for the existence of a cookie with the specified name. 指定した名前のクッキーが存在するかをチェックします。 [RT Expr]
header	Checks for the existence of an HTTP header with the specified name. The name match is performed in a case insensitive manner. 指定した名前の HTTPヘッダー が存在するかをチェックします。 名前の一致は大文字、小文字を無視します。 [RT Expr]
name	Checks for the existence of a JSP bean, in any scope, with the specified name. If property is also specified, checks for a non-null property value for the specified property. 全てのスコープで、指定した名前の JSP bean が存在するかをチェックします。 propertyもあわせて指定された場合は、指定されたプロパティに対する nullでないプロパティ値をチェックします。 [RT Expr]
parameter	Checks for the existence of at least one occurrence of the specified request parameter on this request, even if the parameter value is a zero-length string. パラメータ値が長さ0の文字列であっても、少なくとも1回は発生するこのリクエスト中の指定されたリクエストパラメータの存在をチェックします。 [RT Expr]
property	Checks for the existence of a non-null property value, returned by a property getter method on the JSP bean (in any scope) that is specified by the name attribute. Property references can be simple, nested, and/or indexed. name属性で指定した JSP bean（任意のスコープ）のプロパティ ゲッター によって戻される nullでないプロパティ値の存在をチェックします。 プロパティの参照は、ネストされたりインデックスが付けられることで単純になります。 [RT Expr]
role	Checks whether the currently authenticated user (if any) has been associated with the specified security role. 現在の認証済みユーザが（もしあれば）指定されたセキュリティ ロールと関連付けられているかをチェックします。 [RT Expr]
scope	The bean scope within which to search for the bean named by the name property, or "any scope" if not specified. nameプロパティによって指定されたbean を検索する beanスコープ。 指定されない場合は、任意のスコープ。 [RT Expr]
user	Checks whether the currently authenticated user principal has the specified name. 現在の認証済みユーザが指定された名前を持っているかをチェックします。 [RT Expr]

Performs an HttpServletResponse.sendRedirect() call to the hyperlink specified by the attributes to this tag. URL rewriting will be applied automatically, to maintain session state in the absence of cookies.

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

The base URL for this redirect is calculated based on which of the following attributes you specify (you must specify exactly one of them):

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

• forward - Use the value of this attribute as the name of a global ActionForward to be looked up, and use the context-relative URI found there.


• forward - グローバルActionForward名をこの属性値を探すために使用します。 そして、そこで見つけた コンテキスト相対URIを使用します。
• href - Use the value of this attribute unchanged.


• href - この属性値を変更せずに使用します。
• page - Use the value of this attribute as a context-relative URI, and generate a server-relative URI by including the context path.


• page - コンテキスト相対URIとしてこの属性の値を使用します。 そして、コンテキストパスを含むことで サーバ相対URIを生成します。

Normally, the redirect you specify with one of the attributes described in the previous paragraph will be left unchanged (other than URL rewriting if necessary). However, there are two ways you can append one or more dynamically defined query parameters to the hyperlink -- specify a single parameter with the paramId attribute (and its associated attributes to select the value), or specify the name (and optional property) attributes to select a java.util.Map bean that contains one or more parameter ids and corresponding values.

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

To specify a single parameter, use the paramId attribute to define the name of the request parameter to be submitted. To specify the corresponding value, use one of the following approaches:

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

• Specify only the paramName attribute - The named JSP bean (optionally scoped by the value of the paramScope attribute) must identify a value that can be converted to a String.


• paramName 属性のみを指定する - 指定されたJSP bean (paramScope属性の値によってスコープ指定されることもある) は、 文字列に変換できる値を識別します。
• Specify both the paramName and paramProperty attributes - The specified property getter method will be called on the JSP bean identified by the paramName (and optional paramScope) attributes, in order to select a value that can be converted to a String.


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

If you prefer to specify a java.util.Map that contains all of the request parameters to be added to the hyperlink, use one of the following techniques:

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

• Specify only the name attribute - The named JSP bean (optionally scoped by the value of the scope attribute) must identify a java.util.Map containing the parameters.


• name 属性のみを指定する - 指定された JSP bean (scope属性の値によってスコープ指定されることもある) は、 パラメータを含む java.util.Map を識別します。
• Specify both name and property attributes - The specified property getter method will be called on the bean identified by the name (and optional scope) attributes, in order to return the java.util.Map containing the parameters.


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

As the Map is processed, the keys are assumed to be the names of query parameters to be appended to the hyperlink. The value associated with each key must be either a String or a String array representing the parameter value(s). If a String array is specified, more than one value for the same query parameter name will be created.

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

Attribute Name	Description
anchor	Optional anchor tag ("#xxx") to be added to the generated hyperlink. Specify this value without any "#" character. 生成されたハイパーリンクに付加されるオプションのアンカタグ（"#xxx"）。 この値は、"#" を含まずに指定してください。 [RT Expr]
forward	Logical name of a global ActionForward that contains the actual content-relative URI of the destination of this redirect. This URI may be dynamically modified by the inclusion of query parameters, as described in the tag description. You must specify exactly one of the forward attribute, the href attribute, the linkName attribute, or the page attribute. このリダイレクト先の有効なcontent-relativeなURIを含むグローバルActionForward の論理名。 このURIは、タグの説明にあるように照会パラメータを含むことで動的に修正されるかもしれません。 必ず、forward属性、href属性、 linkName属性、またはpage属性のどれか1つを正確に指定しなければなりません。 [RT Expr]
href	The URL to which this redirect will transfer control. This URL may be dynamically modified by the inclusion of query parameters, as described in the tag description. You must specify exactly one of the forward attribute, the href attribute, the linkName attribute, or the page attribute. このリダイレクトで転送されるURL。 このURLは、タグの説明にあるように照会パラメータを含むことで動的に修正されるかもしれません。 必ず、forward属性、href属性、 linkName属性、またはpage属性のどれか1つを正確に指定しなければなりません。 [RT Expr]
name	The name of a JSP bean that contains a Map representing the query parameters (if property is not specified), or a JSP bean whose property getter is called to return a Map (if property is specified). 照会パラメータ表す Map を含む JSP bean の名前（propertyが指定されていない場合）、 または プロパティ ゲッター が Map を戻す JSP bean の名前（propertyが指定されている場合）。 [RT Expr]
page	The context-relative path (beginning with a "/" character) to which this hyperlink will transfer control if activated. This hyperlink may be dynamically modified by the inclusion of query parameters, as described in the tag description. You must specify exactly one of the forward attribute, the href attribute, the linkName attribute, or the page attribute. もしアクティブならば、このハイパーリンクが転送される("/"文字から始まる)コンテキスト相対パス。 このハイパーリンクは、タグの説明にあるように照会パラメータを含むことで動的に修正されるかもしれません。 必ず、forward属性、href属性、 linkName属性、またはpage属性のどれか1つを正確に指定しなければなりません。 [RT Expr]
paramId	The name of the request parameter that will be dynamically added to the generated hyperlink. The corresponding value is defined by the paramName and (optional) paramProperty attributes, optionally scoped by the paramScope attributel 生成されたハイパーリンクに動的に追加されるリクエストパラメータの名前。 対応する値は、paramScope属性によってスコープ設定され、paramNameおよびparamProperty属性(オプション)により定義されます。 [RT Expr]
paramName	The name of a JSP bean that is a String containing the value for the request parameter named by paramId (if paramProperty is not specified), or a JSP bean whose property getter is called to return a String (if paramProperty is specified). The JSP bean is constrained to the bean scope specified by the paramScope property, if it is specified. (paramPropertyが指定されない場合に)paramIdで指定したリクエストパラメータを含む文字列であるJSP bena名、 または (paramPropertyが指定された場合) 文字列を返すためにプロパティ ゲッター が呼ばれるJSP bean。 JSP beanは、それが指定される場合にparamScopeプロパティで指定して bean スコープに制限されます。 [RT Expr]
paramProperty	The name of a property of the bean specified by the paramName attribute, whose return value must be a String containing the value of the request parameter (named by the paramId attribute) that will be dynamically added to this hyperlink. paramName属性（その返り値はこのハイパーリンクに動的に加えられるリクエストパラメータ(paramId属性によって指定された)の値を含む文字列)によって指定された bean のプロパティの名前。 [RT Expr]
paramScope	The scope within which to search for the bean specified by the paramName attribute. If not specified, all scopes are searched. paramName属性によって指定されたbeanを検索するスコープ。 指定されない場合、すべてのスコープが検索されます。 [RT Expr]
property	The name of a property of the bean specified by the name attribute, whose return value must be a java.util.Map containing the query parameters to be added to the hyperlink. You must specify the name attribute if you specify this attribute. name属性（その戻り値はハイパーリンクに加えられる照会パラメータを含んでいるjava.util.Map）によって指定されたbeanのプロパティ名。 この属性を指定する場合、必ず name属性を指定する必要があります。 [RT Expr]
scope	The scope within which to search for the bean specified by the name attribute. If not specified, all scopes are searched. name 属性によって指定された bean を検索するスコープ。 指定されない場合は、すべてのスコープが検索されます。 [RT Expr]
transaction	Set to true if you want the current transaction control token included in the generated URL for this redirect. このリダイレクトのために生成したURLに現在のトランザクション制御トークンを含める場合は、trueにセットしてください。 [RT Expr]