English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية
JSP指令は、JSPページ全体に関連する属性(例えば、ウェブページのエンコーディング方式やスクリプト言語)を設定するために使用されます。
文法形式は以下の通りです:
<%@ directive attribute="value" %>
指令には多くの属性があります。これらはキーワード対の形式で存在し、カンマで区切られています。
JSPの3つの指令タグ:
指令 | 説明 |
---|---|
<%@ page ... %> | ウェブページが依存する属性を定義します。例えば、スクリプト言語、エラーページ、キャッシュの要件などです。 |
<%@ include ... %> | 他のファイルを含みます。 |
<%@ taglib ... %> | タグライブラリの定義を導入します。 |
Page指令はコンテナに現在のページの使用説明を提供します。JSPページには複数のpage指令を含むことができます。
Page指令の文法形式:
<%@ page attribute="value" %>
等価なXML形式:
<jsp:directive.page attribute="value" /> />
以下の表にPage指令に関連する属性を示します:
属性 | 説明 |
---|---|
buffer | outオブジェクトが使用するバッファーのサイズを指定します。 |
autoFlush | outオブジェクトのキャッシュバッファーを制御します。 |
contentType | 現在のJSPページのMIMEタイプと文字エンコーディングを指定します。 |
errorPage | JSPページで例外が発生した場合に転送するエラーハンドリングページを指定します。 |
isErrorPage | 現在のページが別のJSPページのエラーハンドリングページとして使用できるかどうかを指定します。 |
extends | servletがどのクラスを継承するかを指定します。 |
import | 使用するJavaクラスをインポートします。 |
info | JSPページの説明情報を定義します。 |
isThreadSafe | JSPページへのアクセスがスレッドセーフかどうかを指定します。 |
language | JSPページで使用されるスクリプト言語を定義します。デフォルトはJavaです。 |
session | JSPページがsessionを使用するかどうかを指定する |
isELIgnored | EL表現の実行を指定する |
isScriptingEnabled | スクリプト要素が使用できるかどうかを確認する |
JSPはinclude指示を使用して他のファイルを含むことができます。含まれるファイルはJSPファイル、HTMLファイル、テキストファイルであれば何でも良いです。含まれるファイルはこのJSPファイルの一部のように、同時にコンパイルおよび実行されます。
Include指示の文法フォーマットは以下の通りです:
<%@ include file="ファイル相対 URL アドレス" %>
include 指示内のファイル名は実際には相対的なURLアドレスです。
ファイルにパスを関連付けない場合、JSPコンパイラはデフォルトで現在のパスで検索します。
等価のXML文法:
<jsp:directive.include file="ファイル相対 URL アドレス"> />
JSP APIはユーザーがカスタムタグをカスタマイズすることを許可し、カスタムタグライブラリはカスタムタグのセットです。
Taglib指示は、ライブラリパス、カスタムタグを含むカスタムタグセットの定義を導入します。
Taglib指示の文法:
<%@ taglib uri="uri" prefix="prefixOfTag" %>
uri属性はタグライブラリの場所を決定し、prefix属性はタグライブラリの接頭辞を指定します。
等価のXML文法:
<jsp:directive.taglib uri="uri" prefix="prefixOfTag"> />