Class JsfRIRuntimePopulator

java.lang.Object
jakarta.faces.application.ApplicationConfigurationPopulator
com.sun.faces.config.configpopulator.JsfRIRuntimePopulator

public final class JsfRIRuntimePopulator
extends ApplicationConfigurationPopulator
  • Constructor Details

  • Method Details

    • populateApplicationConfiguration

      public void populateApplicationConfiguration​(Document toPopulate)
      Description copied from class: ApplicationConfigurationPopulator

      Service providers that implement this service must be called by the Jakarta Server Faces runtime exactly once for each implementation, at startup, before any requests have been serviced. Before calling the ApplicationConfigurationPopulator.populateApplicationConfiguration(org.w3c.dom.Document) method, the runtime must ensure that the Document argument is empty aside from being pre-configured to be in the proper namespace for an Application Configuration Resources file: http://xmlns.jcp.org/xml/ns/javaee. Implementations of this service must ensure that any changes made to the argument Document conform to that schema as defined in the specification. The Jakarta Server Faces runtime is not required to validate the Document after control returns from the service implementation, though it may do so.

      Ordering of Artifacts

      If the document is made to contain an <ordering> element, as specified in the section Ordering of Artifacts in the specification prose document, the document will be prioritized accordingly. Otherwise, the runtime must place the document in the list of other Application Configuration Resources documents at the "lowest" priority, meaning any conflicts that may arise between the argument document and any other Application Configuration Resources are resolved in favor of the other document.

      Specified by:
      populateApplicationConfiguration in class ApplicationConfigurationPopulator
      Parameters:
      toPopulate - The Document to populate with configuration.