クラス FaceletCache<V>
この API は、Facelets ViewDeclarationLanguage
が Facelets のインスタンスを作成してキャッシュする機能を定義します。
キャッシュは、ビューフェイスレットとビューメタデータフェイスレットの 2 種類のフェイスレットを処理します。前者は、UIComponent
ツリーの構築を提供する通常の Facelet です。この種の Facelet には、getFacelet(java.net.URL)
および isFaceletCached(java.net.URL)
メソッドを介してアクセスします。後者は、ViewDeclarationLanguage.getViewMetadata(jakarta.faces.context.FacesContext, java.lang.String)
に対応する特別な種類の Facelet です。この種の Facelet には、getViewMetadataFacelet(java.net.URL)
および isViewMetadataFaceletCached(java.net.URL)
メソッドを介してアクセスします。
- 導入:
- 2.1
ネストされたクラスのサマリー
ネストされたクラス修飾子と型クラス説明static interface
Facelet または View Metadata Facelet インスタンスを作成するためのファクトリインターフェース。コンストラクターの概要
コンストラクターメソッドのサマリー
修飾子と型メソッド説明abstract V
getFacelet
(URLSE url) キャッシュされた Facelet インスタンスを返します。protected FaceletCache.MemberFactory<V>
protected FaceletCache.MemberFactory<V>
View MetadataFacelet インスタンスを作成する目的でsetCacheFactories(jakarta.faces.view.facelets.FaceletCache.MemberFactory<V>, jakarta.faces.view.facelets.FaceletCache.MemberFactory<V>)
に渡されたFaceletCache.MemberFactory
を返します。abstract V
キャッシュされた ViewMetadataFacelet インスタンスを返します。abstract boolean
isFaceletCached
(URLSE url) この URL にキャッシュされた Facelet インスタンスが存在するかどうかを判別します。abstract boolean
キャッシュされた ViewMetadataFacelet インスタンスがこの URL に存在するかどうかを判別します。void
setCacheFactories
(FaceletCache.MemberFactory<V> faceletFactory, FaceletCache.MemberFactory<V> viewMetadataFaceletFactory) これは、リクエストが処理される前に、起動時にランタイムによって呼び出される必要があり、FaceletCache
実装が、フェイスレットのインスタンスの作成およびメタデータフェイスレットの表示に使用されるFaceletCache.MemberFactory
インスタンスを提供できるようにします。
コンストラクターの詳細
FaceletCache
public FaceletCache()
メソッドの詳細
getFacelet
キャッシュされた Facelet インスタンスを返します。使用可能なインスタンスがない場合は、Facelet
FaceletCache.MemberFactory
を使用して作成され、キャッシュに保存されます。- パラメーター:
url
- 取得される Facelet のURL
- 戻り値:
- キャッシュされた、または新しい
Facelet
- 例外:
NullPointerExceptionSE
- 引数url
がnull
の場合。IOExceptionSE
- このメソッドのサービスに応答するために必要なファイルをロードできない場合。
isFaceletCached
この URL にキャッシュされた Facelet インスタンスが存在するかどうかを判別します。キャッシュされたインスタンスが存在する場合は true を返し、存在しない場合は false を返します。
- パラメーター:
url
- フェイスレット用のURL
- 戻り値:
- キャッシュされたインスタンスが存在する場合は true、存在しない場合は false
- 例外:
NullPointerExceptionSE
- 引数url
がnull
の場合。
getViewMetadataFacelet
キャッシュされた ViewMetadataFacelet インスタンスを返します。使用可能なインスタンスがない場合は、View Metadata Facelet
FaceletCache.MemberFactory
を使用して作成され、キャッシュに保存されます。- パラメーター:
url
- 取得されているビューメタデータフェイスレットのURL
- 戻り値:
- キャッシュされた、または新しいビューメタデータ
Facelet
インスタンス - 例外:
NullPointerExceptionSE
- 引数url
がnull
の場合。IOExceptionSE
- このメソッドのサービスに応答するために必要なファイルをロードできない場合。
isViewMetadataFaceletCached
キャッシュされた ViewMetadataFacelet インスタンスがこの URL に存在するかどうかを判別します。キャッシュされたインスタンスが存在する場合は true を返し、存在しない場合は false を返します。
- パラメーター:
url
- ビューメタデータフェイスレットのURL
- 戻り値:
- キャッシュされたインスタンスが存在する場合は true、存在しない場合は false
- 例外:
NullPointerExceptionSE
- 引数url
がnull
の場合。
setCacheFactories
public void setCacheFactories(FaceletCache.MemberFactory<V> faceletFactory, FaceletCache.MemberFactory<V> viewMetadataFaceletFactory) これは、リクエストが処理される前に、起動時にランタイムによって呼び出される必要があり、
FaceletCache
実装が、フェイスレットのインスタンスの作成およびメタデータフェイスレットの表示に使用されるFaceletCache.MemberFactory
インスタンスを提供できるようにします。- パラメーター:
faceletFactory
- Facelets のインスタンスを作成するために使用されるFaceletCache.MemberFactory
インスタンス。viewMetadataFaceletFactory
- メタデータ Facelets のインスタンスを作成するために使用されるFaceletCache.MemberFactory
インスタンス。- 例外:
NullPointerExceptionSE
- いずれかの引数がnull
の場合- 導入:
- 2.3
getMemberFactory
getMetadataMemberFactory
View MetadataFacelet インスタンスを作成する目的で
setCacheFactories(jakarta.faces.view.facelets.FaceletCache.MemberFactory<V>, jakarta.faces.view.facelets.FaceletCache.MemberFactory<V>)
に渡されたFaceletCache.MemberFactory
を返します。- 戻り値:
- View MetadataFacelet インスタンスを作成する目的で
setCacheFactories(jakarta.faces.view.facelets.FaceletCache.MemberFactory<V>, jakarta.faces.view.facelets.FaceletCache.MemberFactory<V>)
に渡されるFaceletCache.MemberFactory
。