Package org.glassfish.hk2.api
Interface InstanceLifecycleListener
-
- All Known Implementing Classes:
DefaultTopicDistributionService
@Contract public interface InstanceLifecycleListener
This processor is called for certain events in the lifecycle of instances of services.This listener is concerned with instances of services, whereas the
ValidationService
is concerned with the descriptors for services.An implementation of InstanceLifecycleListener must be in the Singleton scope. Implementations of InstanceLifecycleListener will be instantiated as soon as they are added to HK2 in order to avoid deadlocks and circular references. Therefore it is recommended that implementations of InstanceLifecycleListener make liberal use of
Provider
orIterableProvider
when injecting dependent services so that these services are not instantiated when the InstanceLifecycleListener is created
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description Filter
getFilter()
This returns a filter that tells the system whether a particular descriptor should be handled by this lifecycle listener.void
lifecycleEvent(InstanceLifecycleEvent lifecycleEvent)
This method will be called when any lifecycle event occurs.
-
-
-
Method Detail
-
getFilter
Filter getFilter()
This returns a filter that tells the system whether a particular descriptor should be handled by this lifecycle listener. The filter can be called at any time- Returns:
- The filter that tells the system if this listener applies to this descriptor. If this returns null then this Listener will apply to ALL descriptors.
-
lifecycleEvent
void lifecycleEvent(InstanceLifecycleEvent lifecycleEvent)
This method will be called when any lifecycle event occurs. The currently supported lifecycle events are PRE_PRODUCTION, POST_PRODUCTION and PRE_DESTRUCTION. Code should be written to allow for future events to be generated. This method should not throw exceptions- Parameters:
lifecycleEvent
- The event that has occurred, will not be null
-
-