org.glassfish.hk2.api
Interface InstanceLifecycleEvent

public interface InstanceLifecycleEvent

This object contains information about a lifecycle event. Not all fields are valid for all lifecycle event types

Author:

jwells

Method Summary

ActiveDescriptor<?>	getActiveDescriptor() The active descriptor that is being used for the operation.
InstanceLifecycleEventType	getEventType() Gets the type of even this describes.
java.util.Map<Injectee,java.lang.Object>	getKnownInjectees() A map from the Injectee to the object actually used in the production, if known.
java.lang.Object	getLifecycleObject() The object that is being described by this event.

Method Detail

getEventType

InstanceLifecycleEventType getEventType()

Gets the type of even this describes. The values may be:

• POST_PRODUCTION
• PRE_DESTRUCTION

Returns:

The type of event being described

getActiveDescriptor

ActiveDescriptor<?> getActiveDescriptor()

The active descriptor that is being used for the operation. For POST_PRODUCTION this is the descriptor that created the object. For PRE_DESTRUCTION this is the descriptor that will be used to destroy the object

Returns:

The descriptor associated with this event

getLifecycleObject

java.lang.Object getLifecycleObject()

The object that is being described by this event. In the POST_PRODUCTION case this is the object that was just produced. In the PRE_DESTRUCTION case this is the object that will be destroyed

Returns:

The object that was produced or will be destroyed

getKnownInjectees

java.util.Map<Injectee,java.lang.Object> getKnownInjectees()

A map from the Injectee to the object actually used in the production, if known. This will return null in the PRE_DESTRUCTION case. In the POST_PRODUCTION case this will return non-null if the system knows the objects that were injected into the produced object. If this method returns null in the POST_PRODUCTION case then the system does not know what objects were injected into the produced object, which happens in the case of objects created by a Factory or objects created by third-parth (pre-reified) ActiveDescriptors. If this method returns an empty map then the system knows that nothing was injected into to produced object.

Returns:

The known map of injection point to injected object, if that information is known. Will be null in the PRE_DESTRUCTION case and in the case where the system does not know the values.