public interface Lifecycle
SmartLifecycle
for that purpose.
Can be implemented by both components (typically a Spring bean defined in a
Spring context) and containers (typically a Spring 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.
Can be used for direct invocations or for management operations via JMX.
In the latter case, the MBeanExporter
will typically be defined with an
InterfaceBasedMBeanInfoAssembler
,
restricting the visibility of activity-controlled components to the Lifecycle
interface.
Note that the 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 integration with the application context's startup and shutdown phases.
SmartLifecycle
,
ConfigurableApplicationContext
,
AbstractMessageListenerContainer
,
SchedulerFactoryBean
Modifier and Type | Method and Description |
---|---|
boolean |
isRunning()
Check whether this component is currently running.
|
void |
start()
Start this component.
|
void |
stop()
Stop this component, typically in a synchronous fashion, such that the component is
fully stopped upon return of this method.
|
void start()
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.
SmartLifecycle.isAutoStartup()
void stop()
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, only destroy methods will be called.
Should not throw an exception if the component isn't started yet.
In the case of a container, this will propagate the stop signal to all components that apply.
boolean isRunning()
In the case of a container, this will return true
only if all
components that apply are currently running.