From 2086886b2431f2d749d45d7fba6cf689cc365f60 Mon Sep 17 00:00:00 2001
From: Yanming Zhou <zhouyanming@gmail.com>
Date: Wed, 11 Dec 2024 15:57:01 +0800
Subject: [PATCH] Clarify the behaviour of `@Bean(autowireCandidate=false)`

---
 .../org/springframework/context/annotation/Bean.java   | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/spring-context/src/main/java/org/springframework/context/annotation/Bean.java b/spring-context/src/main/java/org/springframework/context/annotation/Bean.java
index 7f068fef659e..b796b97d1355 100644
--- a/spring-context/src/main/java/org/springframework/context/annotation/Bean.java
+++ b/spring-context/src/main/java/org/springframework/context/annotation/Bean.java
@@ -22,6 +22,7 @@
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
 
+import org.springframework.beans.factory.config.ConfigurableListableBeanFactory;
 import org.springframework.beans.factory.support.AbstractBeanDefinition;
 import org.springframework.core.annotation.AliasFor;
 
@@ -202,6 +203,7 @@
  * @author Chris Beams
  * @author Juergen Hoeller
  * @author Sam Brannen
+ * @author Yanming Zhou
  * @since 3.0
  * @see Configuration
  * @see Scope
@@ -242,6 +244,10 @@
 	 * Is this bean a candidate for getting autowired into some other bean at all?
 	 * <p>Default is {@code true}; set this to {@code false} for internal delegates
 	 * that are not meant to get in the way of beans of the same type in other places.
+	 * <p>NOTE: if this is set to {@code false}, bean is excluded when autowiring
+	 * arrays, collections, maps, or ObjectProvider streams, use
+	 * {@link ConfigurableListableBeanFactory#getBeansOfType(Class)}
+	 * if you want to get all beans of the same type.
 	 * @since 5.1
 	 * @see #defaultCandidate()
 	 */
@@ -253,6 +259,10 @@
 	 * <p>Default is {@code true}; set this to {@code false} for restricted delegates
 	 * that are supposed to be injectable in certain areas but are not meant to get
 	 * in the way of beans of the same type in other places.
+	 * <p>NOTE: if this is set to {@code false}, bean is excluded when autowiring
+	 * arrays, collections, maps, or ObjectProvider streams, use
+	 * {@link ConfigurableListableBeanFactory#getBeansOfType(Class)}
+	 * if you want to get all beans of the same type.
 	 * <p>This is a variation of {@link #autowireCandidate()} which does not disable
 	 * injection in general, just enforces an additional indication such as a qualifier.
 	 * @since 6.2