org.jboss.weld.junit4

Class WeldInitiator

java.lang.Object

org.jboss.weld.junit4.WeldInitiator

All Implemented Interfaces:

Iterable<Object>, javax.enterprise.inject.Instance<Object>, javax.inject.Provider<Object>, org.jboss.weld.environment.ContainerInstance, org.jboss.weld.inject.WeldInstance<Object>, org.junit.rules.TestRule

public class WeldInitiator
extends Object
implements org.junit.rules.TestRule, org.jboss.weld.inject.WeldInstance<Object>, org.jboss.weld.environment.ContainerInstance

Test rule which starts a Weld container per each test method execution:

 public class SimpleTest {

     @Rule
     public WeldInitiator weld = WeldInitiator.of(Foo.class);

     @Test
     public void testFoo() {
         // Weld container is started automatically
         // WeldInitiator can be used to perform programmatic lookup of beans
         assertEquals("baz", weld.select(Foo.class).get().getBaz());
     }
 }
 

WeldInitiator implements Instance and therefore might be used to perform programmatic lookup of bean instances.

Author:

Martin Kouba

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	WeldInitiator.Builder This builder can be used to customize the final WeldInitiator instance, e.g. to activate a context for a given normal scope.

Nested classes/interfaces inherited from interface org.jboss.weld.inject.WeldInstance

org.jboss.weld.inject.WeldInstance.Handler<T>

Method Summary

Modifier and Type	Method and Description
org.junit.runners.model.Statement	apply(org.junit.runners.model.Statement base, org.junit.runner.Description description)
static org.jboss.weld.environment.se.Weld	createWeld() The returned Weld instance has: automatic discovery disabled concurrent deployment disabled
void	destroy(Object instance)
javax.enterprise.event.Event<Object>	event() Allows to fire events.
static WeldInitiator.Builder	from(Class<?>... beanClasses) Create a builder instance.
static WeldInitiator.Builder	from(org.jboss.weld.environment.se.Weld weld) Create a builder instance.
static WeldInitiator.Builder	fromTestPackage() Create a builder instance.
Object	get()
javax.enterprise.inject.spi.BeanManager	getBeanManager()
org.jboss.weld.inject.WeldInstance.Handler<Object>	getHandler()
String	getId()
Iterable<org.jboss.weld.inject.WeldInstance.Handler<Object>>	handlers()
boolean	isAmbiguous()
boolean	isResolvable()
boolean	isRunning()
boolean	isUnsatisfied()
Iterator<Object>	iterator()
static WeldInitiator	of(Class<?>... beanClasses) The container is configured with the result of createWeld() method and the given bean classes are added.
static WeldInitiator	of(org.jboss.weld.environment.se.Weld weld) The container is configured through a provided Weld instance.
static WeldInitiator	ofTestPackage() The container is configured with the result of createWeld() method and all the classes from the test class package are added.
org.jboss.weld.inject.WeldInstance<Object>	select(Annotation... qualifiers)
<U> org.jboss.weld.inject.WeldInstance<U>	select(Class<U> subtype, Annotation... qualifiers)
<U> org.jboss.weld.inject.WeldInstance<U>	select(javax.enterprise.util.TypeLiteral<U> subtype, Annotation... qualifiers)
void	shutdown() Note that any container-based operation will result in IllegalStateException after shutdown.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Method Detail

of

public static WeldInitiator of(Class<?>... beanClasses)

The container is configured with the result of createWeld() method and the given bean classes are added.

Parameters:

beanClasses -

Returns:

a new test rule

See Also:

Weld.beanClasses(Class...)

of

public static WeldInitiator of(org.jboss.weld.environment.se.Weld weld)

The container is configured through a provided Weld instance.

Parameters:

weld -

Returns:

a new test rule

ofTestPackage

public static WeldInitiator ofTestPackage()

The container is configured with the result of createWeld() method and all the classes from the test class package are added.

Returns:

a new test rule

createWeld

public static org.jboss.weld.environment.se.Weld createWeld()

The returned Weld instance has:

• automatic discovery disabled
• concurrent deployment disabled

Returns:

a new Weld instance suitable for testing

from

public static WeldInitiator.Builder from(Class<?>... beanClasses)

Create a builder instance.

Parameters:

weld -

Returns:

a builder instance

See Also:

of(Class...)

from

public static WeldInitiator.Builder from(org.jboss.weld.environment.se.Weld weld)

Create a builder instance.

Parameters:

weld -

Returns:

a builder instance

See Also:

of(Weld)

fromTestPackage

public static WeldInitiator.Builder fromTestPackage()

Create a builder instance.

Returns:

a builder instance

See Also:

ofTestPackage()

apply

public org.junit.runners.model.Statement apply(org.junit.runners.model.Statement base,
                                               org.junit.runner.Description description)

Specified by:

apply in interface org.junit.rules.TestRule

iterator

public Iterator<Object> iterator()

Specified by:

iterator in interface Iterable<Object>

get

public Object get()

Specified by:

get in interface javax.inject.Provider<Object>

select

public org.jboss.weld.inject.WeldInstance<Object> select(Annotation... qualifiers)

Specified by:

select in interface javax.enterprise.inject.Instance<Object>

Specified by:

select in interface org.jboss.weld.inject.WeldInstance<Object>

select

public <U> org.jboss.weld.inject.WeldInstance<U> select(Class<U> subtype,
                                                        Annotation... qualifiers)

Specified by:

select in interface javax.enterprise.inject.Instance<Object>

Specified by:

select in interface org.jboss.weld.inject.WeldInstance<Object>

select

public <U> org.jboss.weld.inject.WeldInstance<U> select(javax.enterprise.util.TypeLiteral<U> subtype,
                                                        Annotation... qualifiers)

Specified by:

select in interface javax.enterprise.inject.Instance<Object>

Specified by:

select in interface org.jboss.weld.inject.WeldInstance<Object>

isUnsatisfied

public boolean isUnsatisfied()

Specified by:

isUnsatisfied in interface javax.enterprise.inject.Instance<Object>

isAmbiguous

public boolean isAmbiguous()

Specified by:

isAmbiguous in interface javax.enterprise.inject.Instance<Object>

getHandler

public org.jboss.weld.inject.WeldInstance.Handler<Object> getHandler()

Specified by:

getHandler in interface org.jboss.weld.inject.WeldInstance<Object>

isResolvable

public boolean isResolvable()

Specified by:

isResolvable in interface org.jboss.weld.inject.WeldInstance<Object>

handlers

public Iterable<org.jboss.weld.inject.WeldInstance.Handler<Object>> handlers()

Specified by:

handlers in interface org.jboss.weld.inject.WeldInstance<Object>

destroy

public void destroy(Object instance)

Specified by:

destroy in interface javax.enterprise.inject.Instance<Object>

event

public javax.enterprise.event.Event<Object> event()

Allows to fire events.

Returns:

an event object

getBeanManager

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

Specified by:

getBeanManager in interface org.jboss.weld.environment.ContainerInstance

getId

public String getId()

Specified by:

getId in interface org.jboss.weld.environment.ContainerInstance

shutdown

public void shutdown()

Note that any container-based operation will result in IllegalStateException after shutdown.

Specified by:

shutdown in interface org.jboss.weld.environment.ContainerInstance

isRunning

public boolean isRunning()

Returns:

true if the container was initialized completely and is not shut down yet, false otherwise