リファレンス: JavaServer Pages標準タグ・ライブラリ(JSTL)

構文の使用方法

イタリック・フォントで記載されているタグ属性には、ランタイム式を使用します。大カッコ([])内のタグ属性は、必須ではありません。タグ・ボディを指定する場合は、そのタグで受入れ可能なタイプのコンテンツ(JSPコンテンツ)で指定します。

タグ・グループ

JSTLコア・タグ
JSTL書式タグ
JSTL SQLタグ
JSTL XMLタグ

JSTL Coreタグ

このタグ・ライブラリは、式、フロー制御およびURLベースのリソースに対する汎用アクセス方式に関するタグを提供します。これらのリソースのコンテンツをJSPページ内に組み込んだり処理できます。

ライブラリ構文

<%@ taglib uri="http://java.sun.com/jstl/core" prefix="c" %>

JSTL Coreタグ
名前 構文
catch - ネストされたアクションによりスローされるjava.lang.Throwableを捕捉します。 <c:catch
      [var] />

choose - 相互に排他的な条件付き実行のコンテキストを提供します。 <c:choose/>
forEach - オブジェクトのコレクションを対象に、このタグのネストされたボディ・コンテンツを反復します。または、決まった回数を反復します。 <c:forEach
      [items]
      [begin]
      [end]
      [step]
      [var]
      [varStatus] />

forTokens - 指定されたデリミタで区切られたトークンを対象に反復します。 <c:forTokens
      items
      delims
      [begin]
      [end]
      [step]
      [var]
      [varStatus] />

if - test属性で指定された式がtrueの場合に、ボディ・コンテンツを評価します。 <c:if
      test
      [var]
      [scope] />

import - URLベースのリソースのコンテンツをインポートします。 <c:import
      url
      [var]
      [scope]
      [varReader]
      [context]
      [charEncoding] />

otherwise - <c:choose>アクション内の最後の選択肢を表します。 <c:otherwise/>
out - 式を評価し、評価の結果を現在のJspWriterオブジェクトに出力します。 <c:out
      value
      [escapeXml]
      [default] />

JSTL Formatタグ

このタグ・ライブラリは、I18Nとローカル書式およびローカル解析をサポートするタグを提供します。

ライブラリ構文

<%@ taglib uri="http://java.sun.com/jstl/fmt" prefix="fmt" %>

JSTL Formatタグ
名前 構文
bundle - ボディ・コンテンツにより使用されるi18nローカライゼーション・コンテキストを作成します。 <fmt:bundle
      basename
      [prefix] />

formatDate - ロケール依存の方法またはカスタマイズした方法で日付と時間を書式化できます。 <fmt:formatDate
      value
      [type]
      [dateStyle]
      [timeStyle]
      [pattern]
      [timeZone]
      [var]
      [scope] />

formatNumber - ロケール依存の方法またはカスタマイズした方法で、数値を数字、通貨またはパーセントに書式化します。 <fmt:formatNumber
      [value]
      [type]
      [pattern]
      [currencyCode]
      [currencySymbol]
      [groupingUsed]
      [maxIntegerDigits]
      [minIntegerDigits]
      [maxFractionDigits]
      [minFractionDigits]
      [var]
      [scope] />

message - リソース・バンドル内のローカル・メッセージを参照します。 <fmt:message
      [key]
      [bundle]
      [var]
      [scope] />

param - パラメータ置換のための1つのパラメータをコンテナである<fmt:message>アクションに指定します。 <fmt:param
      [value] />

parseDate - ロケール依存の方法またはカスタマイズした方法で日付と時間を書式化できます。 <fmt:parseDate
      [value]
      [type]
      [dateStyle]
      [timeStyle]
      [pattern]
      [timeZone]
      [parseLocale]
      [var]
      [scope] />

parseNumber - ロケール依存の方法またはカスタマイズした方法で、書式化された数字、通貨およびパーセントの文字列表現を解析します。 <fmt:parseNumber
      [value]
      [type]
      [pattern]
      [parseLocale]
      [integerOnly]
      [var]
      [scope] />

requestEncoding - リクエストの文字コードを設定します。 <fmt:requestEncoding
      [value] />

setBundle - i18nローカライゼーション・コンテキストを作成し、これをスコープ変数またはjavax.servlet.jsp.jstl.fmt.localizationContext構成変数に格納します。 <fmt:setBundle
      basename
      [var]
      [scope] />

setLocale - 指定されたロケールをjavax.servlet.jsp.jstl.fmt.locale構成変数に格納します。 <fmt:setLocale
      value
      [variant]
      [scope] />

setTimeZone - 指定されたタイムゾーンをスコープ変数またはタイムゾーン構成変数に格納します。 <fmt:setTimeZone
      value
      [var]
      [scope] />

TimeZone - 時間情報がボディ・コンテンツ内で書式化または解析されるタイムゾーンを指定します。 <fmt:timeZone
      value />

JSTL SQLタグ

このタグ・ライブラリは、JSPの中からデータベースを直接アクセスできるタグを提供します。

ライブラリ構文

<%@ taglib uri="http://java.sun.com/jstl/sql" prefix="sql" %>

JSTL SQLタグ
名前 構文
dateParam - java.util.Date型の値に関して、SQL文内のパラメータ・マーカー(“?”)の値を設定します。 <sql:dateParam
      value
      [type] />

param - SQL文内のパラメータ・マーカー(“?”)の値を設定します。 <sql:query><sql:update>などのSQLExecutionTagアクションのサブタグです。 <sql:param
      [value] />

query - データベースに問い合せます。 <sql:query
      var
      [scope]
      [sql]
      [dataSource]
      [startRow]
      [maxRows] />

setDataSource - データ・ソースをスコープ変数またはデータ・ソース構成変数(javax.servlet.jsp.jstl.sql.dataSource)としてエクスポートします。 <sql:setDataSource
      [var]
      [scope]
      [dataSource]
      [driver]
      [url]
      [user]
      [password] />

transaction - <sql:query>および <sql:update>サブタグのトランザクション・コンテキストを設定します。 <sql:transaction
      [dataSource]
      [isolation] />

update - SQL INSERTUPDATEまたはDELETE文を実行します。 <sql:update
      [var]
      [scope]
      [sql]
      [dataSource] />

JSTL 1.0 XMLライブラリ

このタグ・ライブラリは、XML文書の解析およびXSL変換を行えるタグを提供します。

ライブラリの使用方法

<%@ taglib uri="http://java.sun.com/jstl/xml" prefix="x" %>

JSTL XMLタグ
名前 構文
choose - 相互に排他的な条件付き実行のコンテキストを提供します。 <x:choose/>
forEach - 指定されたXPath式を評価してネストされたボディ・コンテンツを結果に対して反復し、コンテキスト・ノードを反復内の各要素に設定します。 <x:forEach
      [var]
      select />

if - select属性内に指定されているXPath式を評価し、式がtrueに評価された場合にボディ・コンテンツを表示します。 <x:if
      select
      [var]
      [scope] />

otherwise - <x:choose>アクション内の最後の選択肢を表します。 <x:otherwise/>

out - XPath式を評価し、評価の結果を現在のJspWriterオブジェクトに出力します。

<x:out
      select
      [escapeXml] />


JDeveloperのJSTLタグ・ライブラリについて
OJSPタグ・ライブラリおよびユーティリティについて

 

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