org.apache.webbeans.spi
Interface ContainerLifecycle

public interface ContainerLifecycle

JSR-299 Container lifecycle.

Implement this interface to provide own container initialization logic.

From the application point of view this interface can be used to start and stop OpenWebBeans.

Method Summary

javax.enterprise.inject.spi.BeanManager	getBeanManager() Get the underlying BeanManager instance for the current application.
ContextsService	getContextService() Gets container's context service implementation.
void	initApplication(Properties properties) Initialize lifecycle.
void	startApplication(Object startupObject) Starts container.
void	stopApplication(Object endObject) Stopping the Application means that the container destroys all bean instances it stores, cleans and removes all contexts and does other necessary cleanup actions.

Method Detail

initApplication

void initApplication(Properties properties)

Initialize lifecycle.

Implementors can configure their initialization specific actions here.

Parameters:

properties - any properties

startApplication

void startApplication(Object startupObject)

Starts container. It discovers all beans in the deployed application classpath.

For Java EE artifact deployment, it scans all classes and libraries in all deployment archives in the classpath. There are several types of deployment archives;

• EAR archive
• EJB archive
• WAR archive
• RAR archive
• Application client archive. OPTIONAL

Container uses ScannerService SPI for scanning archives and act accordingly. If there is an exception while starting, it must abort the deployment and provides information to the developer.

Parameters:

startupObject - any startup object.

stopApplication

void stopApplication(Object endObject)

Stopping the Application means that the container destroys all bean instances it stores, cleans and removes all contexts and does other necessary cleanup actions.

Attention: Accessing the BeanManager or any bean proxy after the shutdown will result in non-portable behaviour!

Parameters:

endObject - any object provided by application implementor. This can be a ServletContext, etc

getBeanManager

javax.enterprise.inject.spi.BeanManager getBeanManager()

Get the underlying BeanManager instance for the current application. There is 1-1 correspondence between a bean manager and a deployed (web-) application.

Returns:

deployment BeanManager instance

getContextService

ContextsService getContextService()

Gets container's context service implementation. This allows to manually start and end specific contexts.

Returns:

container contexts service