org.jboss.weld.environment.se

Class Weld

java.lang.Object

org.jboss.weld.environment.se.Weld

@Vetoed
public class Weld
extends java.lang.Object

The preferred method of booting Weld SE.

Typical usage of this API looks like this:

 Weld weld = new Weld();
 WeldContainer container = weld.initialize();
 container.instance().select(Foo.class).get();
 container.event().select(Bar.class).fire(new Bar());
 weld.shutdown();
 

Author:

Peter Royle, Pete Muir, Ales Justin

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ARCHIVE_ISOLATION_SYSTEM_PROPERTY

Constructor Summary

Constructors

Constructor and Description
Weld()
Weld(java.lang.String containerId) Assign a unique ID to this Weld instance.

Method Summary

Modifier and Type	Method and Description
void	addExtension(Extension extension) Add extension explicitly.
protected Deployment	createDeployment(ResourceLoader resourceLoader, CDI11Bootstrap bootstrap) Extensions to Weld SE can subclass and override this method to customize the deployment before weld boots up.
protected <T> T	getInstanceByType(BeanManager manager, java.lang.Class<T> type, java.lang.annotation.Annotation... bindings) Utility method allowing managed instances of beans to provide entry points for non-managed beans (such as WeldContainer).
WeldContainer	initialize() Boots Weld and creates and returns a WeldContainer instance, through which beans and events can be accessed.
void	shutdown() Shuts down Weld.

Methods inherited from class java.lang.Object

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

Field Detail

ARCHIVE_ISOLATION_SYSTEM_PROPERTY

public static final java.lang.String ARCHIVE_ISOLATION_SYSTEM_PROPERTY

See Also:

Constant Field Values

Constructor Detail

Weld

public Weld()

Weld

public Weld(java.lang.String containerId)

Assign a unique ID to this Weld instance. This is required when running multiple Weld containers at once.

Parameters:

containerId - the unique ID for this container

Method Detail

addExtension

public void addExtension(Extension extension)

Add extension explicitly.

Parameters:

extension - an extension

initialize

public WeldContainer initialize()

Boots Weld and creates and returns a WeldContainer instance, through which beans and events can be accessed.

Returns:

weld container

createDeployment

protected Deployment createDeployment(ResourceLoader resourceLoader,
                                      CDI11Bootstrap bootstrap)

Extensions to Weld SE can subclass and override this method to customize the deployment before weld boots up. For example, to add a custom ResourceLoader, you would subclass Weld like so:

 public class MyWeld extends Weld {
     protected Deployment createDeployment(ResourceLoader resourceLoader, CDI11Bootstrap bootstrap) {
         return super.createDeployment(new MyResourceLoader(), bootstrap);
     }
 }
 

This could then be used as normal:

 WeldContainer container = new MyWeld().initialize();
 

Parameters:

resourceLoader -

bootstrap -

getInstanceByType

protected <T> T getInstanceByType(BeanManager manager,
                                  java.lang.Class<T> type,
                                  java.lang.annotation.Annotation... bindings)

Utility method allowing managed instances of beans to provide entry points for non-managed beans (such as WeldContainer). Should only called once Weld has finished booting.

Parameters:

manager - the BeanManager to use to access the managed instance

type - the type of the Bean

bindings - the bean's qualifiers

Returns:

a managed instance of the bean

Throws:

java.lang.IllegalArgumentException - if the given type represents a type variable

java.lang.IllegalArgumentException - if two instances of the same qualifier type are given

java.lang.IllegalArgumentException - if an instance of an annotation that is not a qualifier type is given

UnsatisfiedResolutionException - if no beans can be resolved * @throws AmbiguousResolutionException if the ambiguous dependency resolution rules fail

java.lang.IllegalArgumentException - if the given type is not a bean type of the given bean

shutdown

public void shutdown()

Shuts down Weld.