org.apache.deltaspike.core.util.bean

Class ImmutableBeanWrapper<T>

java.lang.Object

org.apache.deltaspike.core.util.bean.BaseImmutableBean<T>

org.apache.deltaspike.core.util.bean.ImmutableBeanWrapper<T>

All Implemented Interfaces:

javax.enterprise.context.spi.Contextual<T>, javax.enterprise.inject.spi.Bean<T>

Direct Known Subclasses:

ImmutablePassivationCapableBeanWrapper

public class ImmutableBeanWrapper<T>
extends BaseImmutableBean<T>

This bean-wrapper allows you to build a general purpose bean (likely a producer method), and register it for a narrowed type (or qualifiers). You can easily create instances of this class with the WrappingBeanBuilder.

For example, you could create a producer method which uses an a String ID tolocated an object (the object can have any class):

 @Produces
 // Use some synthetic scope to prevent this from interfering with other
 // resolutions
 @MyProducer
 Object produce(InjectionPoint ip)
 {
     String id = ip.getAnnotated().getAnnotation(Id.class).value();
     // Lookup and return the object for the id
 }
 

The wrapped bean must return an object which can be cast to the type T, otherwise a ClassCastException will be thrown at runtime when the bean is created.

You can then register a narrowing bean for each type you need:

 event.addBean(new NarrowingBeanBuilder<T>(delegateBean).readFromType(type)
         .create());
 

ImmutableBeanWrapper will use the annotations on definingType to discover the qualifiers, types, scope, stereotypes of the bean, as well as determine it's name (if any) and whether it is an alternative.

The attributes are immutable, and collections are defensively copied on instantiation. It uses the defaults from the specification for properties if not specified.

See Also:

WrappingBeanBuilder

Constructor Summary

Constructors

Constructor and Description
ImmutableBeanWrapper(javax.enterprise.inject.spi.Bean<T> bean, String name, Set<java.lang.annotation.Annotation> qualifiers, Class<? extends java.lang.annotation.Annotation> scope, Set<Class<? extends java.lang.annotation.Annotation>> stereotypes, Set<Type> types, boolean alternative, boolean nullable, String toString) Instantiate a new ImmutableBeanWrapper.

Method Summary

Modifier and Type	Method and Description
T	create(javax.enterprise.context.spi.CreationalContext<T> creationalContext)
void	destroy(T instance, javax.enterprise.context.spi.CreationalContext<T> creationalContext)

Methods inherited from class org.apache.deltaspike.core.util.bean.BaseImmutableBean

getBeanClass, getInjectionPoints, getName, getQualifiers, getScope, getStereotypes, getTypes, isAlternative, isNullable, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

ImmutableBeanWrapper

public ImmutableBeanWrapper(javax.enterprise.inject.spi.Bean<T> bean,
                            String name,
                            Set<java.lang.annotation.Annotation> qualifiers,
                            Class<? extends java.lang.annotation.Annotation> scope,
                            Set<Class<? extends java.lang.annotation.Annotation>> stereotypes,
                            Set<Type> types,
                            boolean alternative,
                            boolean nullable,
                            String toString)

Instantiate a new ImmutableBeanWrapper.

Parameters:

bean - the bean to wrapped the lifecycle to

name - the name of the bean

qualifiers - the qualifiers of the bean

scope - the scope of the bean

stereotypes - the bean's stereotypes

types - the types of the bean

alternative - whether the bean is an alternative

nullable - true if the bean is nullable

toString - the string which should be returned by #BaseImmutableBean.toString()

Method Detail

create

public T create(javax.enterprise.context.spi.CreationalContext<T> creationalContext)

destroy

public void destroy(T instance,
                    javax.enterprise.context.spi.CreationalContext<T> creationalContext)