org.ops4j.pax.web.service.spi

Interface ServerControllerFactory

public interface ServerControllerFactory

Main SPI interface used by pax-web-runtime to create ServerController which will be the only way to configure and control targe server runtime.

Method Summary

Modifier and Type	Method and Description
ServerController	createServerController(Configuration configuration) Creates an instance of ServerController that will control actual server runtime (Jetty, Tomcat, Undertow).
default void	releaseServerController(ServerController controller, Configuration configuration) Cleanup method, because we don't want controllers to live forever.

Method Detail

createServerController

ServerController createServerController(Configuration configuration)

Creates an instance of ServerController that will control actual server runtime (Jetty, Tomcat, Undertow). Can be invoked multiple times for different configurations, but actual implementation has to decide if the controller is always created or possibly cached.

Returned ServerController should always be associated with given configuration, but ServerController.configure() method still has to be called to give the controller a chance for some explicit initialization before it actually starts.

Parameters:

configuration - Pax Web configuration that specifies global aspects of target runtime

Returns:

releaseServerController

default void releaseServerController(ServerController controller,
                                     Configuration configuration)

Cleanup method, because we don't want controllers to live forever.

Parameters:

controller -

configuration -