root
/
spring-framework
mirror of https://github.com/spring-projects/spring-framework.git
1
0
Fork 0
Code Issues Actions Packages Projects Releases Wiki Activity

Notes about autowiring in configuration classes and late registration scenarios 

Issue: SPR-12970
Issue: SPR-13285
This commit is contained in:
Juergen Hoeller 2015-07-29 13:18:15 +02:00
parent ff46cec58f
commit 90493f49e6
1 changed files with 20 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
src/asciidoc/core-beans.adoc
View File

@ -384,6 +384,16 @@ supports this registration through the methods `registerSingleton(..)` and
`registerBeanDefinition(..)`. However, typical applications work solely with beans `registerBeanDefinition(..)`. However, typical applications work solely with beans
defined through metadata bean definitions. defined through metadata bean definitions.
[NOTE]
====
Bean metadata and manually supplied singleton instances need to be registered as early
as possible, in order for the container to properly reason about them during autowiring
and other introspection steps. While overriding of existing metadata and existing
singleton instances is supported to some degree, the registration of new beans at
runtime (concurrently with live access to factory) is not officially supported and may
lead to concurrent access exceptions and/or inconsistent state in the bean container.
====
[[beans-beanname]] [[beans-beanname]]
@ -6557,15 +6567,20 @@ classes, each depending on beans declared in the others:
---- ----
There is another way to achieve the same result. Remember that `@Configuration` classes are There is another way to achieve the same result. Remember that `@Configuration` classes are
ultimately just another bean in the container - this means that they can take advantage ultimately just another bean in the container: This means that they can take advantage of
of `@Autowired` injection metadata just like any other bean! `@Autowired` and `@Value` injection etc just like any other bean!
[WARNING] [WARNING]
==== ====
Make sure that the dependencies you inject that way are of the simplest kind only. `@Configuration` Make sure that the dependencies you inject that way are of the simplest kind only. `@Configuration`
classes are processed quite early during the initialization of the context and forcing a classes are processed quite early during the initialization of the context and forcing a dependency
dependency to be injected this way may lead to unexpected early initialization. Whenever possible, to be injected this way may lead to unexpected early initialization. Whenever possible, resort to
resort to parameter-based injection as in the example above. parameter-based injection as in the example above.
Also, be particularly careful with `BeanPostProcessor` and `BeanFactoryPostProcessor` definitions
via `@Bean`. Those should usually be declared as `static @Bean` methods, not triggering the
instantiation of their containing configuration class. Otherwise, `@Autowired` and `@Value` won't
work on the configuration class itself since it is being created as a bean instance too early.
==== ====
[source,java,indent=0] [source,java,indent=0]