パッケージ jakarta.faces.application

クラス ApplicationConfigurationPopulator

java.lang.ObjectSE
jakarta.faces.application.ApplicationConfigurationPopulator
public abstract class ApplicationConfigurationPopulator extends ObjectSE

このクラスは、既存のアプリケーション構成リソーススキーマを使用して Jakarta Server Faces ランタイムのプログラムによる構成を可能にする java.util.ServiceLoader サービスを定義します。このサービスの実装がいつ、どのように使用されるかについての仕様については、Jakarta Faces Specification Document のセクション 11.3.2「アプリケーションの起動動作」を参照してください。

導入:
2.2

  • コンストラクターの詳細

    • ApplicationConfigurationPopulator

      public ApplicationConfigurationPopulator()

  • メソッドの詳細

    • populateApplicationConfiguration

      public abstract void populateApplicationConfiguration(DocumentSE toPopulate)

      このサービスを実装するサービスプロバイダーは、リクエストが処理される前に、起動時に実装ごとに 1 回だけ Jakarta Faces ランタイムによって呼び出される必要があります。ランタイムは、populateApplicationConfiguration(org.w3c.dom.Document) メソッドを呼び出す前に、アプリケーション構成リソースファイルの適切な名前空間 https://jakarta.ee/xml/ns/jakartaee にあるように事前構成されていることを除いて、Document 引数が空であることを確認する必要があります。このサービスの実装では、引数  Document に加えられた変更が、仕様で定義されているスキーマに準拠していることを確認する必要があります。Jakarta Faces ランタイムは、サービス実装から制御が戻った後に Document を検証する必要はありませんが、検証する場合があります。

      アーティファクトのオーダー

      ドキュメントが <ordering> 要素を含むように作成されている場合、Jakarta Faces Specification Document のセクション 11.3.8「アーティファクトの順序付け」で指定されているように、ドキュメントはそれに応じて優先順位が付けられます。それ以外の場合、ランタイムはドキュメントを他のアプリケーション構成リソースドキュメントのリストに「最低」の優先度で配置する必要があります。つまり、引数ドキュメントと他のアプリケーション構成リソースとの間で発生する可能性のある競合は、他のドキュメントを優先して解決されます。

      パラメーター:
      toPopulate - 構成を入力するドキュメント。
      導入:
      2.2