Interface ExtensionFactory

  • All Known Implementing Classes:
    ExtHandshakeVHostExtensionFactory

    public interface ExtensionFactory
    Extension factories are registered with the Webcontainer/WebcontainerService as providers of handlers (ExtensionProcessors) for generic URL patterns. Any request for resources that match the supplied URL pattern (except in the case where there already exists a more specific pattern and matching target (possibly supplied by the application assembler), will be routed to the ExtensionProcessor supplied by the Factory.
    • Method Detail

      • createExtensionProcessor

        ExtensionProcessor createExtensionProcessor​(IServletContext webapp)
                                             throws java.lang.Exception
        Parameters:
        webapp - - The WebApp that the created ExtensionProcessor should be associated with
        Returns:
        An instance of WebExtensionProcessor which will be associated with the URL patterns that this factory is associated with, and has the capability of handling requests.
        Throws:
        java.lang.Exception - The creation process can throw any kind of exception, and it will be caught and logged by the webcontainer This method will be called by the container during initialization. A WebExtensionFactory typically furnishes a single type of WebExtensionProcessor, a singleton in most cases.
      • getPatternList

        java.util.List getPatternList()
        Returns:
        The list of all the URI patterns that the WebExtensionProcessors created by this factory will handle. This method will be called by the webcontainer while setting up its internal URL routing datastructures. Patters supplied in this list should be in accord with the allowable patterns specified in the Java Servlet Specification (under URL patterns).