ch.inftec.ju.ee.client

Interface CdiServiceLocator

All Known Subinterfaces:

ServiceLocator

public interface CdiServiceLocator

ServiceLocator that looks up CDI beans programmatically using the BeanManager interface of a Container.

Author:

Martin

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	CdiServiceLocator.CdiComplexLookupBuilder<T> Helper to construct complex CDI queries

Method Summary

Methods

Modifier and Type	Method and Description
<T> T	cdi(Class<T> clazz) Default CDI lookup of the specified type.
<T> List<T>	cdiAll(Class<T> clazz) Gets a list of all CDI beans for the specified type.
<T> List<T>	cdiAllAnno(Class<T> clazz, Annotation... annotations) Gets a list of all CDI beans for the specified type.
<T> T	cdiAnno(Class<T> clazz, Annotation... annotations) Looks up a resource in the CDI BeanManager.
<T> CdiServiceLocator.CdiComplexLookupBuilder<T>	cdiComplex(Class<T> clazz) Returns a builder to issue complex CDI queries.
<T> T	cdiNamed(Class<T> clazz, String name) Get a @Named annotated object with the specified name.

Method Detail

cdi

<T> T cdi(Class<T> clazz)

Default CDI lookup of the specified type. Aims to return the same instance as @Inject would inject into a field.

Parameters:

clazz - Desired type to get from CDI

Returns:

Instance of T

Throws:

ch.inftec.ju.util.JuRuntimeException - if we don't find exactly one matching instance

cdiAnno

<T> T cdiAnno(Class<T> clazz,
            Annotation... annotations)

Looks up a resource in the CDI BeanManager. Aims to return the same intance as @Inject with qualifiers would inject into a field.

Parameters:

clazz - Type of the resource

annotations - Annotation qualifiers for the Beans to be looked up

Returns:

CDI bean or null if none was found. If multiple beans are found without a Default bean, an exception is rised.

cdiAll

<T> List<T> cdiAll(Class<T> clazz)

Gets a list of all CDI beans for the specified type. This will also include @Alternative beans.

Parameters:

clazz - Type of the bean

Returns:

List containing all retrieved beans. If none was found, the list will be empty.

cdiAllAnno

<T> List<T> cdiAllAnno(Class<T> clazz,
                     Annotation... annotations)

Gets a list of all CDI beans for the specified type.

Parameters:

clazz - Type of the bean

annotations - List of annotation qualifiers the bean should have. For @Any, the public field ServiceLocator.ANY can be used.

Returns:

List containing all retrieved beans. If none was found, the list will be empty.

cdiNamed

<T> T cdiNamed(Class<T> clazz,
             String name)

Get a @Named annotated object with the specified name.

Parameters:

clazz - Desired type to get from CDI

name - Value of the @Named annotation

Returns:

Instance of T

Throws:

ch.inftec.ju.util.JuRuntimeException - if we don't find exactly one matching instance

cdiComplex

<T> CdiServiceLocator.CdiComplexLookupBuilder<T> cdiComplex(Class<T> clazz)

Returns a builder to issue complex CDI queries.

Parameters:

clazz - Desired type to get from CDI

Returns:

Builder to construct complex CDI queries