Document Lifecycle#stop concurrency semantics

Issue: SPR-8570

git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@4822 50f2f4bb-b051-0410-bef5-90022cba6387
This commit is contained in:
Chris Beams 2011-07-29 21:39:42 +00:00
parent 50db20034b
commit 21a501f8bc
1 changed files with 6 additions and 2 deletions

View File

@ -55,10 +55,14 @@ public interface Lifecycle {
void start(); void start();
/** /**
* Stop this component. * Stop this component, typically in a synchronous fashion, such that
* Should not throw an exception if the component isn't started yet. * the component is fully stopped upon return of this method. Consider
* implementing {@link SmartLifecycle} and its {@code stop(Runnable)}
* variant in cases where asynchronous stop behavior is necessary.
* <p>Should not throw an exception if the component isn't started yet.
* <p>In the case of a container, this will propagate the stop signal * <p>In the case of a container, this will propagate the stop signal
* to all components that apply. * to all components that apply.
* @see SmartLifecycle#stop(Runnable)
*/ */
void stop(); void stop();