org.apache.webbeans.cditest

Interface CdiTestContainer

All Known Implementing Classes:

CdiTestOpenWebBeansContainer

public interface CdiTestContainer

A CdiTestContainer provides access to an underlying JSR-299 (CDI) Container. It allows starting and stopping the container as to start and stop single contexts.

Method Summary

Modifier and Type	Method and Description
void	bootContainer() Booting the CdiTestContainer will scan the whole classpath for Beans and extensions available.
javax.enterprise.inject.spi.BeanManager	getBeanManager()
<T> T	getInstance(Class<T> type, Annotation... qualifiers) Provide a contextual reference via it's type and optional qualifier annotations.
Object	getInstance(String elNname) Provide a contextual reference via it's type and ExpressionLanguage name.
void	shutdownContainer() This will shutdown the underlying CDI container.
void	startApplicationScope()
void	startContexts() This will start all Contexts
void	startConversationScope()
void	startCustomScope(Class<? extends Annotation> scopeClass)
void	startRequestScope()
void	startSessionScope()
void	stopApplicationScope()
void	stopContexts() Stop all Contexts and destroy all beans properly
void	stopConversationScope()
void	stopCustomScope(Class<? extends Annotation> scopeClass)
void	stopRequestScope()
void	stopSessionScope()

Method Detail

bootContainer

void bootContainer()
            throws Exception

Booting the CdiTestContainer will scan the whole classpath for Beans and extensions available.

Throws:

Exception

shutdownContainer

void shutdownContainer()
                throws Exception

This will shutdown the underlying CDI container.

Throws:

Exception

startContexts

void startContexts()
            throws Exception

This will start all Contexts

Throws:

Exception

stopContexts

void stopContexts()
           throws Exception

Stop all Contexts and destroy all beans properly

Throws:

Exception

startApplicationScope

void startApplicationScope()
                    throws Exception

Throws:

Exception

stopApplicationScope

void stopApplicationScope()
                   throws Exception

Throws:

Exception

startSessionScope

void startSessionScope()
                throws Exception

Throws:

Exception

stopSessionScope

void stopSessionScope()
               throws Exception

Throws:

Exception

startRequestScope

void startRequestScope()
                throws Exception

Throws:

Exception

stopRequestScope

void stopRequestScope()
               throws Exception

Throws:

Exception

startConversationScope

void startConversationScope()
                     throws Exception

Throws:

Exception

stopConversationScope

void stopConversationScope()
                    throws Exception

Throws:

Exception

startCustomScope

void startCustomScope(Class<? extends Annotation> scopeClass)
               throws Exception

Throws:

Exception

stopCustomScope

void stopCustomScope(Class<? extends Annotation> scopeClass)
              throws Exception

Throws:

Exception

getBeanManager

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

Returns:

the BeanManager or null it not available

getInstance

<T> T getInstance(Class<T> type,
                  Annotation... qualifiers)
           throws javax.enterprise.inject.ResolutionException

Provide a contextual reference via it's type and optional qualifier annotations. If no qualifier is given, @Default is assumed.

Type Parameters:

T - the Type of the contextual reference

Parameters:

type - the Type of the contextual reference

qualifiers - optional qualifiers to restrict the search

Returns:

a contextual reference of the given bean if it is not ambiguous.

Throws:

javax.enterprise.inject.ResolutionException - if not exactly 1 Bean<T> got found

getInstance

Object getInstance(String elNname)
            throws javax.enterprise.inject.ResolutionException

Provide a contextual reference via it's type and ExpressionLanguage name.

Type Parameters:

T - the Type of the contextual reference

Parameters:

elName - the EL name to search for.

Returns:

a contextual reference of the given bean via it's name.

Throws:

javax.enterprise.inject.ResolutionException - if not exactly 1 Bean<T> got found