Package org.glassfish.hk2.api

Interface InstanceLifecycleEvent

  • All Known Implementing Classes:
    InstanceLifecycleEventImpl
    public interface InstanceLifecycleEvent
    This object contains information about a lifecycle event. Not all fields are valid for all lifecycle event types

    • Method Detail

      • getEventType

        InstanceLifecycleEventType getEventType()
        Gets the type of event this describes. The values may be:
        • PRE_PRODUCTION
        • 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 PRE_PRODUCTION and POST_PRODUCTION this is the descriptor that will create or 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. Will be null in the PRE_PRODUCTION case
        Returns:
        The object that was produced or will be destroyed. Will be null in the PRE_PRODUCTION case

      • 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 PRE_PRODUCTION and POST_PRODUCTION cases this will return non-null if the system knows the objects that will be or were injected into the produced object. If this method returns null in the PRE_PRODUCTION or 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-party (pre-reified) ActiveDescriptors. If this method returns an empty map then the system knows that nothing will be or 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.