org.jboss.weld.context

Class CreationalContextImpl<T>

java.lang.Object

org.jboss.weld.context.CreationalContextImpl<T>

All Implemented Interfaces:

Serializable, CreationalContext<T>, WeldCreationalContext<T>

public class CreationalContextImpl<T>
extends Object
implements CreationalContext<T>, WeldCreationalContext<T>, Serializable

Author:

Pete Muir, Ales Justin, Jozef Hartinger

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
CreationalContextImpl(Contextual<T> contextual)

Method Summary

Methods

Modifier and Type	Method and Description
void	addDependentInstance(ContextualInstance<?> contextualInstance)
void	addDependentResourceReference(ResourceReference<?> resourceReference) Register a ResourceReference as a dependency.
boolean	containsIncompleteInstance(Contextual<?> bean)
boolean	destroyDependentInstance(T instance) Destroys dependent instance
List<AroundConstructCallback<T>>	getAroundConstructCallbacks()
Contextual<T>	getContextual()
<S> CreationalContextImpl<S>	getCreationalContext(Contextual<S> contextual)
List<ContextualInstance<?>>	getDependentInstances() Returns an unmodifiable list of dependent instances.
<S> S	getIncompleteInstance(Contextual<S> bean)
CreationalContextImpl<?>	getParentCreationalContext()
<S> CreationalContextImpl<S>	getProducerReceiverCreationalContext(Contextual<S> contextual) The returned CreationalContext shares nothing but incomplete instances.
boolean	isConstructorInterceptionSuppressed() Indicates whether Weld-managed AroundConstruct interceptors are suppressed.
void	push(T incompleteInstance) Registers an incompletely initialized contextual instance the with the container.
void	registerAroundConstructCallback(AroundConstructCallback<T> callback) Register a callback which is notified of component construction.
void	release() Destroys all dependent objects of the instance which is being destroyed, by passing each dependent object to Contextual.destroy(Object, CreationalContext) .
void	release(Contextual<T> contextual, T instance)
void	setConstructorInterceptionSuppressed(boolean value) By default Weld takes care of AroundConstruct interceptors of a component instance which are bound to the component using interceptor bindings or the Interceptors annotation.
protected Object	writeReplace()

Methods inherited from class java.lang.Object

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

Constructor Detail

CreationalContextImpl

public CreationalContextImpl(Contextual<T> contextual)

Method Detail

push

public void push(T incompleteInstance)

Description copied from interface: CreationalContext

Registers an incompletely initialized contextual instance the with the container. A contextual instance is considered incompletely initialized until it is returned by Contextual.create(CreationalContext) .

Specified by:

push in interface CreationalContext<T>

Parameters:

incompleteInstance - the incompletely initialized instance

getCreationalContext

public <S> CreationalContextImpl<S> getCreationalContext(Contextual<S> contextual)

getProducerReceiverCreationalContext

public <S> CreationalContextImpl<S> getProducerReceiverCreationalContext(Contextual<S> contextual)

Description copied from interface: WeldCreationalContext

The returned CreationalContext shares nothing but incomplete instances.

Returns:

the CreationalContext for a producer reciever

See Also:

WELD-1513

getIncompleteInstance

public <S> S getIncompleteInstance(Contextual<S> bean)

containsIncompleteInstance

public boolean containsIncompleteInstance(Contextual<?> bean)

addDependentInstance

public void addDependentInstance(ContextualInstance<?> contextualInstance)

release

public void release()

Description copied from interface: CreationalContext

Destroys all dependent objects of the instance which is being destroyed, by passing each dependent object to Contextual.destroy(Object, CreationalContext) .

Specified by:

release in interface CreationalContext<T>

release

public void release(Contextual<T> contextual,
           T instance)

getParentCreationalContext

public CreationalContextImpl<?> getParentCreationalContext()

Returns:

the parent CreationalContext or null if there isn't any parent.

getDependentInstances

public List<ContextualInstance<?>> getDependentInstances()

Returns an unmodifiable list of dependent instances.

writeReplace

protected Object writeReplace()
                       throws ObjectStreamException

Throws:

ObjectStreamException

addDependentResourceReference

public void addDependentResourceReference(ResourceReference<?> resourceReference)

Register a ResourceReference as a dependency. ResourceReference.release() will be called on every ResourceReference once this CreationalContext instance is released.

destroyDependentInstance

public boolean destroyDependentInstance(T instance)

Destroys dependent instance

Parameters:

instance -

Returns:

true if the instance was destroyed, false otherwise

getContextual

public Contextual<T> getContextual()

Returns:

the Contextual for which this CreationalContext is created.

getAroundConstructCallbacks

public List<AroundConstructCallback<T>> getAroundConstructCallbacks()

setConstructorInterceptionSuppressed

public void setConstructorInterceptionSuppressed(boolean value)

Description copied from interface: WeldCreationalContext

By default Weld takes care of AroundConstruct interceptors of a component instance which are bound to the component using interceptor bindings or the Interceptors annotation. This may not be desired should an integrator want to manage these interceptors themselves. In that case this switch may be used to suppress Weld management of AroundConstruct interceptors. In that case an integrator is responsible for performing AroundConstruct interception.

Specified by:

setConstructorInterceptionSuppressed in interface WeldCreationalContext<T>

Parameters:

value - the value

See Also:

WeldCreationalContext.registerAroundConstructCallback(AroundConstructCallback)

isConstructorInterceptionSuppressed

public boolean isConstructorInterceptionSuppressed()

Description copied from interface: WeldCreationalContext

Indicates whether Weld-managed AroundConstruct interceptors are suppressed.

Specified by:

isConstructorInterceptionSuppressed in interface WeldCreationalContext<T>

Returns:

true if Weld-managed AroundConstruct interceptors are suppressed

See Also:

WeldCreationalContext.setConstructorInterceptionSuppressed(boolean)

registerAroundConstructCallback

public void registerAroundConstructCallback(AroundConstructCallback<T> callback)

Description copied from interface: WeldCreationalContext

Register a callback which is notified of component construction. This callback allows an integrator to perform additional tasks (e.g. invoking interceptors bound using the deployment descriptor) around constructor invocation. AroundConstructCallbacks are invoked in the order in which they were registered.

Specified by:

registerAroundConstructCallback in interface WeldCreationalContext<T>

Parameters:

callback - the callback