Class DefaultLifecycleProcessor

java.lang.Object
org.springframework.context.support.DefaultLifecycleProcessor
All Implemented Interfaces:
Aware, BeanFactoryAware, Lifecycle, LifecycleProcessor

public class DefaultLifecycleProcessor extends Object implements LifecycleProcessor, BeanFactoryAware
Spring's default implementation of the LifecycleProcessor strategy.

Provides interaction with Lifecycle and SmartLifecycle beans in groups for specific phases, on startup/shutdown as well as for explicit start/stop interactions on a ConfigurableApplicationContext.

As of 6.1, this also includes support for JVM checkpoint/restore (Project CRaC) when the org.crac:crac dependency on the classpath.

Since:
3.0
Author:
Mark Fisher, Juergen Hoeller, Sebastien Deleuze
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final String
    Property name for a common context checkpoint: "spring.context.checkpoint".
    static final String
    Property name for terminating the JVM when the context reaches a specific phase: "spring.context.exit".
    static final String
    Recognized value for the context checkpoint and exit properties: "onRefresh".
  • Constructor Summary

    Constructors
    Constructor
    Description
     
  • Method Summary

    Modifier and Type
    Method
    Description
    protected Map<String,Lifecycle>
    Retrieve all applicable Lifecycle beans: all singletons that have already been created, as well as all SmartLifecycle beans (even if they are marked as lazy-init).
    protected int
    Determine the lifecycle phase of the given bean.
    boolean
    Check whether this component is currently running.
    void
    Notification of context close phase, for example, for auto-stopping components.
    void
    Notification of context refresh, for example, for auto-starting components.
    void
    Callback that supplies the owning factory to a bean instance.
    void
    setTimeoutForShutdownPhase(int phase, long timeout)
    Specify the maximum time allotted for the shutdown of a specific phase (group of SmartLifecycle beans with the same 'phase' value).
    void
    setTimeoutPerShutdownPhase(long timeoutPerShutdownPhase)
    Specify the maximum time allotted in milliseconds for the shutdown of any phase (group of SmartLifecycle beans with the same 'phase' value).
    void
    setTimeoutsForShutdownPhases(Map<Integer,Long> timeoutsForShutdownPhases)
    Specify the maximum time allotted for the shutdown of each given phase (group of SmartLifecycle beans with the same 'phase' value).
    void
    Start all registered beans that implement Lifecycle and are not already running.
    void
    Stop all registered beans that implement Lifecycle and are currently running.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Field Details

  • Constructor Details

    • DefaultLifecycleProcessor

      public DefaultLifecycleProcessor()
  • Method Details

    • setTimeoutsForShutdownPhases

      public void setTimeoutsForShutdownPhases(Map<Integer,Long> timeoutsForShutdownPhases)
      Specify the maximum time allotted for the shutdown of each given phase (group of SmartLifecycle beans with the same 'phase' value).

      In case of no specific timeout configured, the default timeout per shutdown phase will apply: 10000 milliseconds (10 seconds) as of 6.2.

      Parameters:
      timeoutsForShutdownPhases - a map of phase values (matching SmartLifecycle.getPhase()) and corresponding timeout values (in milliseconds)
      Since:
      6.2
      See Also:
    • setTimeoutForShutdownPhase

      public void setTimeoutForShutdownPhase(int phase, long timeout)
      Specify the maximum time allotted for the shutdown of a specific phase (group of SmartLifecycle beans with the same 'phase' value).

      In case of no specific timeout configured, the default timeout per shutdown phase will apply: 10000 milliseconds (10 seconds) as of 6.2.

      Parameters:
      phase - the phase value (matching SmartLifecycle.getPhase())
      timeout - the corresponding timeout value (in milliseconds)
      Since:
      6.2
      See Also:
    • setTimeoutPerShutdownPhase

      public void setTimeoutPerShutdownPhase(long timeoutPerShutdownPhase)
      Specify the maximum time allotted in milliseconds for the shutdown of any phase (group of SmartLifecycle beans with the same 'phase' value).

      The default value is 10000 milliseconds (10 seconds) as of 6.2.

      See Also:
    • setBeanFactory

      public void setBeanFactory(BeanFactory beanFactory)
      Description copied from interface: BeanFactoryAware
      Callback that supplies the owning factory to a bean instance.

      Invoked after the population of normal bean properties but before an initialization callback such as InitializingBean.afterPropertiesSet() or a custom init-method.

      Specified by:
      setBeanFactory in interface BeanFactoryAware
      Parameters:
      beanFactory - owning BeanFactory (never null). The bean can immediately call methods on the factory.
      See Also:
    • start

      public void start()
      Start all registered beans that implement Lifecycle and are not already running. Any bean that implements SmartLifecycle will be started within its 'phase', and all phases will be ordered from lowest to highest value. All beans that do not implement SmartLifecycle will be started in the default phase 0. A bean declared as a dependency of another bean will be started before the dependent bean regardless of the declared phase.
      Specified by:
      start in interface Lifecycle
      See Also:
    • stop

      public void stop()
      Stop all registered beans that implement Lifecycle and are currently running. Any bean that implements SmartLifecycle will be stopped within its 'phase', and all phases will be ordered from highest to lowest value. All beans that do not implement SmartLifecycle will be stopped in the default phase 0. A bean declared as dependent on another bean will be stopped before the dependency bean regardless of the declared phase.
      Specified by:
      stop in interface Lifecycle
      See Also:
    • onRefresh

      public void onRefresh()
      Description copied from interface: LifecycleProcessor
      Notification of context refresh, for example, for auto-starting components.
      Specified by:
      onRefresh in interface LifecycleProcessor
    • onClose

      public void onClose()
      Description copied from interface: LifecycleProcessor
      Notification of context close phase, for example, for auto-stopping components.
      Specified by:
      onClose in interface LifecycleProcessor
    • isRunning

      public boolean isRunning()
      Description copied from interface: Lifecycle
      Check whether this component is currently running.

      In the case of a container, this will return true only if all components that apply are currently running.

      Specified by:
      isRunning in interface Lifecycle
      Returns:
      whether the component is currently running
    • getLifecycleBeans

      protected Map<String,Lifecycle> getLifecycleBeans()
      Retrieve all applicable Lifecycle beans: all singletons that have already been created, as well as all SmartLifecycle beans (even if they are marked as lazy-init).
      Returns:
      the Map of applicable beans, with bean names as keys and bean instances as values
    • getPhase

      protected int getPhase(Lifecycle bean)
      Determine the lifecycle phase of the given bean.

      The default implementation checks for the Phased interface, using a default of 0 otherwise. Can be overridden to apply other/further policies.

      Parameters:
      bean - the bean to introspect
      Returns:
      the phase (an integer value)
      See Also: