diff --git a/framework-docs/modules/ROOT/pages/core/beans/annotation-config/autowired.adoc b/framework-docs/modules/ROOT/pages/core/beans/annotation-config/autowired.adoc index edcefabd84..a821a5b8a6 100644 --- a/framework-docs/modules/ROOT/pages/core/beans/annotation-config/autowired.adoc +++ b/framework-docs/modules/ROOT/pages/core/beans/annotation-config/autowired.adoc @@ -37,18 +37,18 @@ Kotlin:: ---- ====== -[NOTE] +[TIP] ==== -As of Spring Framework 4.3, an `@Autowired` annotation on such a constructor is no longer -necessary if the target bean defines only one constructor to begin with. However, if -several constructors are available and there is no primary/default constructor, at least -one of the constructors must be annotated with `@Autowired` in order to instruct the -container which one to use. See the discussion on -xref:core/beans/annotation-config/autowired.adoc#beans-autowired-annotation-constructor-resolution[constructor resolution] for details. +An `@Autowired` annotation on such a constructor is not necessary if the target bean +defines only one constructor. However, if several constructors are available and there is +no primary or default constructor, at least one of the constructors must be annotated +with `@Autowired` in order to instruct the container which one to use. See the discussion +on xref:core/beans/annotation-config/autowired.adoc#beans-autowired-annotation-constructor-resolution[constructor resolution] +for details. ==== -You can also apply the `@Autowired` annotation to _traditional_ setter methods, -as the following example shows: +You can apply the `@Autowired` annotation to _traditional_ setter methods, as the +following example shows: [tabs] ====== @@ -84,8 +84,8 @@ Kotlin:: ---- ====== -You can also apply the annotation to methods with arbitrary names and multiple -arguments, as the following example shows: +You can apply `@Autowired` to methods with arbitrary names and multiple arguments, as the +following example shows: [tabs] ====== @@ -176,14 +176,15 @@ Kotlin:: ==== Make sure that your target components (for example, `MovieCatalog` or `CustomerPreferenceDao`) are consistently declared by the type that you use for your `@Autowired`-annotated -injection points. Otherwise, injection may fail due to a "no type match found" error at runtime. +injection points. Otherwise, injection may fail due to a "no type match found" error at +runtime. For XML-defined beans or component classes found via classpath scanning, the container usually knows the concrete type up front. However, for `@Bean` factory methods, you need to make sure that the declared return type is sufficiently expressive. For components that implement several interfaces or for components potentially referred to by their -implementation type, consider declaring the most specific return type on your factory -method (at least as specific as required by the injection points referring to your bean). +implementation type, declare the most specific return type on your factory method (at +least as specific as required by the injection points referring to your bean). ==== .[[beans-autowired-annotation-self-injection]]Self Injection @@ -312,8 +313,8 @@ through `@Order` values in combination with `@Primary` on a single bean for each ==== Even typed `Map` instances can be autowired as long as the expected key type is `String`. -The map values contain all beans of the expected type, and the keys contain the -corresponding bean names, as the following example shows: +The map values are all beans of the expected type, and the keys are the corresponding +bean names, as the following example shows: [tabs] ====== @@ -431,7 +432,7 @@ annotated constructor does not have to be public. ==== Alternatively, you can express the non-required nature of a particular dependency -through Java 8's `java.util.Optional`, as the following example shows: +through Java's `java.util.Optional`, as the following example shows: [source,java,indent=0,subs="verbatim,quotes"] ---- @@ -521,5 +522,6 @@ class MovieRecommender { The `@Autowired`, `@Inject`, `@Value`, and `@Resource` annotations are handled by Spring `BeanPostProcessor` implementations. This means that you cannot apply these annotations within your own `BeanPostProcessor` or `BeanFactoryPostProcessor` types (if any). + These types must be 'wired up' explicitly by using XML or a Spring `@Bean` method. ====