接口 Lifecycle

所有已知子接口:
ConfigurableApplicationContext, LifecycleProcessor, SmartLifecycle
所有已知实现类:
AbstractApplicationContext, AbstractRefreshableApplicationContext, AbstractRefreshableConfigApplicationContext, AbstractXmlApplicationContext, AnnotationConfigApplicationContext, ClassPathXmlApplicationContext, DefaultLifecycleProcessor, FileSystemXmlApplicationContext, GenericApplicationContext, GenericXmlApplicationContext, StandardApplicationContext, StaticApplicationContext

public interface Lifecycle
A common interface defining methods for start/stop lifecycle control. The typical use case for this is to control asynchronous processing. NOTE: This interface does not imply specific auto-startup semantics. Consider implementing SmartLifecycle for that purpose.

Can be implemented by both components (typically a bean defined in a IoC context) and containers (typically a ApplicationContext itself). Containers will propagate start/stop signals to all components that apply within each container, e.g. for a stop/restart scenario at runtime.

Note that the present Lifecycle interface is only supported on top-level singleton beans. On any other component, the Lifecycle interface will remain undetected and hence ignored. Also, note that the extended SmartLifecycle interface provides sophisticated integration with the application context's startup and shutdown phases.

从以下版本开始:
4.0
作者:
Juergen Hoeller, TODAY 2021/11/12 16:26
另请参阅:
  • 方法概要

    修饰符和类型
    方法
    说明
    boolean
    Check whether this component is currently running.
    void
    Start this component.
    void
    Stop this component, typically in a synchronous fashion, such that the component is fully stopped upon return of this method.
  • 方法详细资料

    • start

      void start()
      Start this component.

      Should not throw an exception if the component is already running.

      In the case of a container, this will propagate the start signal to all components that apply.

      另请参阅:
    • stop

      void stop()
      Stop this component, typically in a synchronous fashion, such that the component is fully stopped upon return of this method. Consider implementing SmartLifecycle and its stop(Runnable) variant when asynchronous stop behavior is necessary.

      Note that this stop notification is not guaranteed to come before destruction: On regular shutdown, Lifecycle beans will first receive a stop notification before the general destruction callbacks are being propagated; however, on hot refresh during a context's lifetime or on aborted refresh attempts, a given bean's destroy method will be called without any consideration of stop signals upfront.

      Should not throw an exception if the component is not running (not started yet).

      In the case of a container, this will propagate the stop signal to all components that apply.

      另请参阅:
    • isRunning

      boolean isRunning()
      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.

      返回:
      whether the component is currently running