javax.enterprise.inject.se

Class SeContainerInitializer

java.lang.Object

javax.enterprise.inject.se.SeContainerInitializer

public abstract class SeContainerInitializer
extends Object

This is a builder class for a synthetic bean archive that will be used in an SE Deployment of CDI. Invoking newInstance() creates a new one from a ServiceLoader, and by default will load all JARs from the classpath unless you invoke disableDiscovery() and manually load classes in to the archive.

Constructor Summary

Constructors

Constructor and Description
SeContainerInitializer()

Method Summary

Modifier and Type	Method and Description
abstract SeContainerInitializer	addBeanClasses(Class<?>... classes) Adds the listed classes to the resulting synthetic bean archive
abstract SeContainerInitializer	addExtensions(Class<? extends Extension>... extensions) Adds the given Extension classes to the synthetic bean archive
abstract SeContainerInitializer	addExtensions(Extension... extensions) Adds the given Extension instances to the synthetic bean archive
abstract SeContainerInitializer	addPackages(boolean scanRecursively, Class<?>... packageClasses) Add packages for the given classes to the synthetic bean archive.
abstract SeContainerInitializer	addPackages(boolean scanRecursively, Package... packages) Adds the given packages to the synthetic bean archive.
abstract SeContainerInitializer	addPackages(Class<?>... packageClasses) Adds packages of the given classes to the synthetic bean archive, the result of packageClass.getPackage()
abstract SeContainerInitializer	addPackages(Package... packages) Adds the given packages to the synthetic bean archive.
abstract SeContainerInitializer	addProperty(String key, Object value) Adds a configuration property to the container
abstract SeContainerInitializer	disableDiscovery() Disables bean discovery of the classpath and instead relies solely on the classes defined in the archive
abstract SeContainerInitializer	enableDecorators(Class<?>... decoratorClasses) Enables the given decorators in the synthetic bean archive
abstract SeContainerInitializer	enableInterceptors(Class<?>... interceptorClasses) Enables the given interceptors in the synthetic bean archive
abstract SeContainer	initialize() Bootstraps the container that has been built from this SeContainerInitializer
static SeContainerInitializer	newInstance() Instantiates a new SeContainerInitializer via ServiceLoader
abstract SeContainerInitializer	selectAlternatives(Class<?>... alternativeClasses) Adds the given alternatives to the list of available alternatives in the bean archive
abstract SeContainerInitializer	selectAlternativeStereotypes(Class<? extends Annotation>... alternativeStereotypeClasses) Adds the given alternative stereotypes to the list of available alternative stereotypes in the bean archive
abstract SeContainerInitializer	setClassLoader(ClassLoader classLoader) Sets the default ClassLoader for this synthetic bean archive
abstract SeContainerInitializer	setProperties(Map<String,Object> properties) Overwrites all existing properties with the contents of the new given map

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SeContainerInitializer

public SeContainerInitializer()

Method Detail

newInstance

public static SeContainerInitializer newInstance()

Instantiates a new SeContainerInitializer via ServiceLoader

Returns:

the SeContainerInitializer implementation found via ServiceLoader

Throws:

IllegalStateException - if 0 or more than 1 SeContainerInitializer found.

addBeanClasses

public abstract SeContainerInitializer addBeanClasses(Class<?>... classes)

Adds the listed classes to the resulting synthetic bean archive

Parameters:

classes -

Returns:

this

addPackages

public abstract SeContainerInitializer addPackages(Class<?>... packageClasses)

Adds packages of the given classes to the synthetic bean archive, the result of packageClass.getPackage()

Parameters:

packageClasses -

Returns:

this

addPackages

public abstract SeContainerInitializer addPackages(boolean scanRecursively,
                                                   Class<?>... packageClasses)

Add packages for the given classes to the synthetic bean archive.

Parameters:

scanRecursively - if true, will recursively check the child packages of each of these classes' packages

packageClasses -

Returns:

this

addPackages

public abstract SeContainerInitializer addPackages(Package... packages)

Adds the given packages to the synthetic bean archive.

Parameters:

packages -

Returns:

this

addPackages

public abstract SeContainerInitializer addPackages(boolean scanRecursively,
                                                   Package... packages)

Adds the given packages to the synthetic bean archive.

Parameters:

scanRecursively - if true, will recursively check the child packages of each of these classes' packages

packages -

Returns:

this

addExtensions

public abstract SeContainerInitializer addExtensions(Extension... extensions)

Adds the given Extension instances to the synthetic bean archive

Parameters:

extensions -

Returns:

this

addExtensions

public abstract SeContainerInitializer addExtensions(Class<? extends Extension>... extensions)

Adds the given Extension classes to the synthetic bean archive

Parameters:

extensions -

Returns:

this

enableInterceptors

public abstract SeContainerInitializer enableInterceptors(Class<?>... interceptorClasses)

Enables the given interceptors in the synthetic bean archive

Parameters:

interceptorClasses -

Returns:

this

enableDecorators

public abstract SeContainerInitializer enableDecorators(Class<?>... decoratorClasses)

Enables the given decorators in the synthetic bean archive

Parameters:

decoratorClasses -

Returns:

this

selectAlternatives

public abstract SeContainerInitializer selectAlternatives(Class<?>... alternativeClasses)

Adds the given alternatives to the list of available alternatives in the bean archive

Parameters:

alternativeClasses -

Returns:

this

selectAlternativeStereotypes

public abstract SeContainerInitializer selectAlternativeStereotypes(Class<? extends Annotation>... alternativeStereotypeClasses)

Adds the given alternative stereotypes to the list of available alternative stereotypes in the bean archive

Parameters:

alternativeStereotypeClasses -

Returns:

this

addProperty

public abstract SeContainerInitializer addProperty(String key,
                                                   Object value)

Adds a configuration property to the container

Parameters:

key -

value -

Returns:

this

setProperties

public abstract SeContainerInitializer setProperties(Map<String,Object> properties)

Overwrites all existing properties with the contents of the new given map

Parameters:

properties -

Returns:

this

disableDiscovery

public abstract SeContainerInitializer disableDiscovery()

Disables bean discovery of the classpath and instead relies solely on the classes defined in the archive

Returns:

this

setClassLoader

public abstract SeContainerInitializer setClassLoader(ClassLoader classLoader)

Sets the default ClassLoader for this synthetic bean archive

Parameters:

classLoader -

Returns:

this

initialize

public abstract SeContainer initialize()

Bootstraps the container that has been built from this SeContainerInitializer

Returns:

a new SeContainer representing this synthetic bean archive