Spring/spring-framework
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Clarify destruction order effect in @DependsOn annotation javadoc

Browse Source 
Issue: SPR-17384

(cherry picked from commit 00b7782b5f)
This commit is contained in:
Juergen Hoeller
2018-10-18 18:03:44 +02:00
parent cf25efc7d3
commit c73b98cf33
2 changed files with 12 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
spring-context/src/main/java/org/springframework/context/annotation/DependsOn.java
View File

@@ -1,5 +1,5 @@
/* /*
* Copyright 2002-2012 the original author or authors. * Copyright 2002-2018 the original author or authors.
* *
* Licensed under the Apache License, Version 2.0 (the "License"); * Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License. * you may not use this file except in compliance with the License.
@@ -28,6 +28,12 @@ import java.lang.annotation.Target;
* does not explicitly depend on another through properties or constructor arguments, * does not explicitly depend on another through properties or constructor arguments,
* but rather depends on the side effects of another bean's initialization. * but rather depends on the side effects of another bean's initialization.
* *
* <p>A depends-on declaration can specify both an initialization-time dependency and,
* in the case of singleton beans only, a corresponding destruction-time dependency.
* Dependent beans that define a depends-on relationship with a given bean are destroyed
* first, prior to the given bean itself being destroyed. Thus, a depends-on declaration
* can also control shutdown order.
*
* <p>May be used on any class directly or indirectly annotated with * <p>May be used on any class directly or indirectly annotated with
* {@link org.springframework.stereotype.Component} or on methods annotated * {@link org.springframework.stereotype.Component} or on methods annotated
* with {@link Bean}. * with {@link Bean}.

10
src/docs/asciidoc/core/core-beans.adoc
View File

@@ -1914,11 +1914,11 @@ delimiters:
[NOTE] [NOTE]
==== ====
The `depends-on` attribute in the bean definition can specify both an initialization The `depends-on` attribute in the bean definition can specify both an initialization-time
time dependency and, in the case of <<beans-factory-scopes-singleton,singleton>> beans dependency and, in the case of <<beans-factory-scopes-singleton,singleton>> beans only,
only, a corresponding destroy time dependency. Dependent beans that define a a corresponding destruction-time dependency. Dependent beans that define a `depends-on`
`depends-on` relationship with a given bean are destroyed first, prior to the given bean relationship with a given bean are destroyed first, prior to the given bean itself being
itself being destroyed. Thus `depends-on` can also control shutdown order. destroyed. Thus `depends-on` can also control shutdown order.
==== ====