javax.servlet.jsp.tagext
クラス TagLibraryValidator

java.lang.Object
  |
  +--javax.servlet.jsp.tagext.TagLibraryValidator

public abstract class TagLibraryValidator

extends Object

JSPページの翻訳時の検証クラスです。 JSPページに関連するXMLドキュメントを検証します。

TLDファイルはTagLibraryValidatorクラスとタグライブラリの初期化引数に関連します。

JSPコンテナは以下のような時、適切なサブクラスの適切なインスタンスを配置する必要があります。

• 新しいインスタンスを初期化するとき、または現在使用可能なものを再利用するとき
• インスタンス中でsetInitParams(Map)メソッドを呼び出すとき

初期化されると、validate(String, String, PageData)メソッドが呼び出されます。 最初の2つの引数はtaglib指示子の中で使われる接頭子とURI引数です。

TagLibraryValidatorのインスタンスは内部で検証を行うための拡張したオブジェクト (例: XSchema validator)を作成します。 そして、指示された翻訳動作が実行されている間、全てのページで再利用されます。

JSPコンテナはvalidate()メソッドの呼び出しが直列化されることを保証しません。 だから、TagLibraryValidator が必要とされる同期化を行わなくてはいけません。

JSPコンテナは、より高品質なエラー検証を提供するために、jsp:id属性を （随意に）サポートすることができます。 jsp:idがサポートされる時、コンテナは、JSPページがコンテナに渡された時に追跡し、 jsp:id属性の値として渡される一意な"id"を個々のエレメントに対して割り当てます。 XMLビュー中で見ることのできる個々のXMLエレメントは、この属性とともに拡張されます。 それ以後、TagLibraryValidatorは、１つ以上の検証メッセ-ジ（ValidationMessage） オブジェクト中の属性を使うことができます。 次に、コンテナは、これらの値を使って、 エラーの位置を示す、より正確な情報を提供できるようになります。

コンストラクタの概要

TagLibraryValidator()

メソッドの概要

Map	getInitParameters() 初期化パラメータを変更不可能なMapとして取得します。
void	release() このインスタンスによって評価用として保持されているすべてのデータを解放します。
void	setInitParameters(Map map) 評価手続きのためにTLD内の初期化データをセットします。
ValidationMessage[]	validate(String prefix, String uri, PageData page) JSPページの検証をします。

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

TagLibraryValidator

public TagLibraryValidator()

メソッドの詳細

setInitParameters

public void setInitParameters(Map map)

評価手続きのためにTLD内の初期化データをセットします。 パラメータ名はキーになり、パラメータ値は値になります。

パラメータ:

map - 初期化パラメータを記述したMap

getInitParameters

public Map getInitParameters()

初期化パラメータを変更不可能なMapとして取得します。 パラメータ名はキーになり、パラメータ値は値になります。

戻り値:

変更不可能なmapの初期化パラメータ

validate

public ValidationMessage[] validate(String prefix,
                                    String uri,
                                    PageData page)

JSPページの検証をします。 JSPページ中の指示子ごとに1回呼び出されます。 ページの検証がうまく行った場合、nullが返されます。 それ以外の場合はValidationMessageオブジェクトの配列が返ります。 配列の長さが0だった場合も、エラー無しで翻訳がされたことを示します。

パラメータ:

prefix - 指示子の接頭属性の値

uri - 指示子のuri属性の値

戻り値:

エラーでない場合、nullオブジェクト、または長さ0の配列。それ以外の場合、ValidationMessageの配列

release

public void release()

このインスタンスによって評価用として保持されているすべてのデータを解放します。