<jsp:invoke> - JSP リファレンス

<jsp:invoke>

xmlns:jsp="http://java.sun.com/JSP/Page"

JSP 2.0 以降

SYNOPSIS

<jsp:invoke

fragment^*="属性名"

var="変数名"

varReader="変数名"

scope="page|request|session|application"

説明

<jsp:invoke> は、それが記述されたタグファイル (カスタムタグ) の属性値として渡されたフラグメントを評価し、結果を JspWriter に出力または変数に格納します。指定された属性名に対するフラグメントが null の場合には長さ 0 の文字列が渡された時と同じ動作になります。<jsp:doBody> の挙動と似ていますが、あちらはタグで囲まれた部分をフラグメントとして評価します。

<%@variable%> を使用することでフラグメント内の EL やカスタムタグに変数を渡すことが出来ます。

<jsp:invoke> はタグファイル内で繰り返し実行することが出来ます。

参照: <jsp:attribute> <jsp:doBody>

属性

fragment="属性名"

required

フラグメントの評価処理を行う属性の名前。

var="変数名"

optional

フラグメントの処理結果を格納する変数名。java.lang.String のインスタンスが格納されます。

varReader 属性と両方を指定することは出来ません。

varReader="変数名"

optional

フラグメントの評価結果を入力ストリームとして格納する変数名。 java.io.Reader のインスタンスが格納されます。

コンテナによってはフラグメントの出力サイズによってファイルなどにスワップアウトするよう実装されている可能性があります。

var 属性と両方を指定することは出来ません。

scope="page|request|session|application"

optional

var または varReader で指定した評価結果の変数を格納するスコープです。 page, request, session, application のいずれかを指定します。

スコープに session を指定する場合、呼び出し側の JSP がセッションを開始していない可能性があることに注意してください。セッションが開始されていない状況で session スコープへアクセスすると IllegalStateException が発生します。

使用例

タグファイルチュートリアル参照。

JSP リファレンス

SYNOPSIS

説 明

属 性

使用例

説明

属性