Package jakarta.faces.application

Class ApplicationFactory

  • All Implemented Interfaces:
    FacesWrapper<ApplicationFactory>
    public abstract class ApplicationFactory
extends Object
implements FacesWrapper<ApplicationFactory>

    ApplicationFactory is a factory object that creates (if needed) and returns Application instances. Implementations of Jakarta Faces must provide at least a default implementation of Application.

    There must be one ApplicationFactory instance per web application that is utilizing Jakarta Faces. This instance can be acquired, in a portable manner, by calling: 

     ApplicationFactory factory = (ApplicationFactory) FactoryFinder.getFactory(FactoryFinder.APPLICATION_FACTORY);

    Usage: extend this class and push the implementation being wrapped to the constructor and use getWrapped() to access the instance being wrapped.

    • Constructor Detail

      • ApplicationFactory

        @Deprecated
public ApplicationFactory()
        Deprecated.
        Use the other constructor taking the implementation being wrapped.

      • ApplicationFactory

        public ApplicationFactory​(ApplicationFactory wrapped)

        If this factory has been decorated, the implementation doing the decorating should push the implementation being wrapped to this constructor. The getWrapped() will then return the implementation being wrapped.

        Parameters:
        wrapped - The implementation being wrapped.

    • Method Detail

      • getWrapped

        public ApplicationFactory getWrapped()

        If this factory has been decorated, the implementation doing the decorating may override this method to provide access to the implementation being wrapped.

        Specified by:
        getWrapped in interface FacesWrapper<ApplicationFactory>
        Returns:
        the wrapped instance.
        Since:
        2.0

      • getApplication

        public abstract Application getApplication()

        Create (if needed) and return an Application instance for this web application.

        Returns:
        the application.

      • setApplication

        public abstract void setApplication​(Application application)

        Replace the Application instance that will be returned for this web application.

        Parameters:
        application - The replacement Application instance
        Throws:
        NullPointerException - if application is null.