ネストされたボディ・コンテンツをオブジェクトのコレクションに対して反復するか、一定回数だけ反復します。
構文
構文1: オブジェクトのコレクションに対して反復
<c:forEach [var=”varName ”] items=”collection”
[varStatus=”varStatusName”]
[begin=”begin”] [end=”end”] [step=” step”]>
</c:forEach>
構文2: 一定回数だけ反復
<c:forEach [var=”varName”]
[varStatus=”varStatusName”]
begin=” begin” end=”end” [step=”step”]>
</c:forEach>
ボディ・コンテンツ
JSP。反復対象の項目が存在するかぎり、JSPコンテナによってボディ・コンテンツが処理され、現在のJspWriterに書き込まれます。
属性
制約
NULLおよびエラーの処理
説明
beginが項目のサイズ以上である場合、反復は実行されません。
サポートされるコレクションと現在の項目
次に示すデータ型が項目に対してサポートされている必要があります。構文1では、var属性によって公開される各オブジェクトの型は、プリミティブ型の配列とマップを除き、基礎となるコレクションにおけるオブジェクトの型です(次を参照)。構文2では、エクスポートされるオブジェクトはInteger型です。
int
に対するInteger
、floatに対するFloatなど)で自動的にラップされます。java.util.Collection
の実装iterator()
メソッドを介してコレクションから取得されます。コレクションの項目は、そのIterator
オブジェクトによって返された順に処理されます。
java.util.Iterator
の実装Iterator
オブジェクトによって返された順に処理されます。
java.util.Enumeration
の実装Enumeration
オブジェクトによって返された順に処理されます。
java.util.Map
の実装var
属性を介して公開されるオブジェクトはMap.Entry
型です。entrySet()
メソッドを介してMap
から取得され、Iterator
オブジェクトはiterator()
メソッドを介してSetビューから取得されます。コレクションの項目は、Iterator
オブジェクトによって返された順に処理されます。
注意: JSTL 1.1では、Java Servlet 2.4およびJavaServer Pages 2.0の仕様をサポートするJSPコンテナが必要です。JSTL 1.0仕様の実装には、Java Servlet 2.3およびJavaServer Pages 1.2の仕様をサポートするJSPコンテナが必要です。
JSTLタグの状況依存ヘルプを提供するため、JSTLタグ・ライブラリのドキュメントがApache Software Foundation(http://www.apache.org/)で作成され、JDeveloperに含まれています。また、JSTLタグおよび属性の説明を含む『JavaServer Pages Standard Tag Library 1.0 and 1.1 Specifications』を次のWebサイトからダウンロードできます。
http://www.jcp.org/aboutJava/communityprocess/final/jsr052/index2.html
JSTLの詳細は、次の外部リファレンスを参照してください。
『Java Sun JSTL Resources』ページ:
http://java.sun.com/products/jsp/jstl/
JDeveloperのJSTLタグ・ライブラリについて
リファレンス: JavaServer Pages標準タグ・ライブラリ(JSTL)
Copyright © 1997, 2007, Oracle. All rights reserved.