org.jboss.weld.bootstrap.api

Interface Bootstrap

All Known Subinterfaces:

CDI11Bootstrap

All Known Implementing Classes:

ForwardingBootstrap, WeldBootstrap

public interface Bootstrap

Application container initialization API for Weld. To initialize the container you must call, in this order:

1. #startContainer()
2. startInitialization()
3. deployBeans()
4. validateBeans()
5. endInitialization()

To stop the container and clean up, you must call shutdown()

Author:

Pete Muir

Method Summary

Methods

Modifier and Type	Method and Description
Bootstrap	deployBeans() Creates and deploys the application's beans: Creates and deploys the discovered beans Creates and deploys the built-in beans defined by the CDI specification Finally the AfterBeanDiscovery is event is fired
Bootstrap	endInitialization() Cleans up after the initialization
WeldManager	getManager(BeanDeploymentArchive beanDeploymentArchive) Get the manager used for this beanDeploymentArchive.
Iterable<Metadata<Extension>>	loadExtensions(ClassLoader classLoader) Load CDI extensions using the provided ClassLoader
BeansXml	parse(Iterable<URL> urls) Parse the specified URLs as a series of beans.xml file and merge the result.
BeansXml	parse(Iterable<URL> urls, boolean removeDuplicates) Parse the specified URLs as a series of beans.xml file and merge the result.
BeansXml	parse(URL url) Parse the specified URL as a beans.xml file.
void	shutdown() Causes the container to clean up and shutdown Before the contain is shutdown the BeforeShutdown event is fired
Bootstrap	startContainer(Environment environment, Deployment deployment) Creates the application container: Checks that the services required by the environment have been provided Adds container provided services Creates and initializes the built in contexts Creates the manager context
Bootstrap	startInitialization() Starts the application container initialization process: Reads metadata from beans.xml and the Deployment service Starts the application context Starts the request context which lasts until endInitialization() is called Discovers and creates Extension service providers Finally, the BeforeBeanDiscovery event is fired.
Bootstrap	validateBeans() Validates the deployment.

Method Detail

startContainer

Bootstrap startContainer(Environment environment,
                       Deployment deployment)

Creates the application container:

• Checks that the services required by the environment have been provided
• Adds container provided services
• Creates and initializes the built in contexts
• Creates the manager

context

Parameters:

environment - the environment in use, by default Environments.EE

deployment - the Deployment to be booted

Throws:

IllegalStateException - if not all the services required for the given environment are available

startInitialization

Bootstrap startInitialization()

Starts the application container initialization process:

• Reads metadata from beans.xml and the Deployment service
• Starts the application context
• Starts the request context which lasts until endInitialization() is called
• Discovers and creates Extension service providers

Finally, the BeforeBeanDiscovery event is fired.

deployBeans

Bootstrap deployBeans()

Creates and deploys the application's beans:

• Creates and deploys the discovered beans
• Creates and deploys the built-in beans defined by the CDI specification

Finally the AfterBeanDiscovery is event is fired

validateBeans

Bootstrap validateBeans()

Validates the deployment. After validation, the AfterDeploymentValidation event is fired

endInitialization

Bootstrap endInitialization()

Cleans up after the initialization

shutdown

void shutdown()

Causes the container to clean up and shutdown Before the contain is shutdown the BeforeShutdown event is fired

getManager

WeldManager getManager(BeanDeploymentArchive beanDeploymentArchive)

Get the manager used for this beanDeploymentArchive. If #startContainer() has not been called, this method will return null. If the beanDeploymentArchive is not known to Weld (for example, it was not passed to the Weld as part of the Deployment, or has not yet been requested by Deployment.loadBeanDeploymentArchive(Class)), null will be returned.

Returns:

the manager or null if not yet available or not found.

parse

BeansXml parse(URL url)

Parse the specified URL as a beans.xml file.

Parameters:

url - the url to parse

Returns:

the BeansXml data structure which represents the URL

Throws:

IllegalArgumentException - if the URL cannot be opened

parse

BeansXml parse(Iterable<URL> urls)

Parse the specified URLs as a series of beans.xml file and merge the result. Duplicate entries are not removed.

Parameters:

url - the url to parse

Returns:

the BeansXml data structure which represents the URL

Throws:

IllegalArgumentException - if the URL cannot be opened

parse

BeansXml parse(Iterable<URL> urls,
             boolean removeDuplicates)

Parse the specified URLs as a series of beans.xml file and merge the result.

Parameters:

urls - the urls to parse

removeDuplicates - whether duplicate entries (alternatives, interceptors, etc) are removed

Returns:

the BeansXml data structure which represents the URL

Throws:

IllegalArgumentException - if the URL cannot be opened

loadExtensions

Iterable<Metadata<Extension>> loadExtensions(ClassLoader classLoader)

Load CDI extensions using the provided ClassLoader

Parameters:

classLoader - the ClassLoader to use to load the extensions

Throws:

IllegalArgumentException - if classLoader is null