Compare commits
7 Commits
0181c58a4f
...
8ffb6cb873
Author | SHA1 | Date |
---|---|---|
|
8ffb6cb873 | |
|
7e6874ad80 | |
|
097463e3b7 | |
|
ad0ddb71d4 | |
|
7df2e55b56 | |
|
8c06f4a9d6 | |
|
03cd38f1b1 |
|
@ -37,18 +37,18 @@ Kotlin::
|
||||||
----
|
----
|
||||||
======
|
======
|
||||||
|
|
||||||
[NOTE]
|
[TIP]
|
||||||
====
|
====
|
||||||
As of Spring Framework 4.3, an `@Autowired` annotation on such a constructor is no longer
|
An `@Autowired` annotation on such a constructor is not necessary if the target bean
|
||||||
necessary if the target bean defines only one constructor to begin with. However, if
|
defines only one constructor. However, if several constructors are available and there is
|
||||||
several constructors are available and there is no primary/default constructor, at least
|
no primary or default constructor, at least one of the constructors must be annotated
|
||||||
one of the constructors must be annotated with `@Autowired` in order to instruct the
|
with `@Autowired` in order to instruct the container which one to use. See the discussion
|
||||||
container which one to use. See the discussion on
|
on xref:core/beans/annotation-config/autowired.adoc#beans-autowired-annotation-constructor-resolution[constructor resolution]
|
||||||
xref:core/beans/annotation-config/autowired.adoc#beans-autowired-annotation-constructor-resolution[constructor resolution] for details.
|
for details.
|
||||||
====
|
====
|
||||||
|
|
||||||
You can also apply the `@Autowired` annotation to _traditional_ setter methods,
|
You can apply the `@Autowired` annotation to _traditional_ setter methods, as the
|
||||||
as the following example shows:
|
following example shows:
|
||||||
|
|
||||||
[tabs]
|
[tabs]
|
||||||
======
|
======
|
||||||
|
@ -84,8 +84,8 @@ Kotlin::
|
||||||
----
|
----
|
||||||
======
|
======
|
||||||
|
|
||||||
You can also apply the annotation to methods with arbitrary names and multiple
|
You can apply `@Autowired` to methods with arbitrary names and multiple arguments, as the
|
||||||
arguments, as the following example shows:
|
following example shows:
|
||||||
|
|
||||||
[tabs]
|
[tabs]
|
||||||
======
|
======
|
||||||
|
@ -176,14 +176,15 @@ Kotlin::
|
||||||
====
|
====
|
||||||
Make sure that your target components (for example, `MovieCatalog` or `CustomerPreferenceDao`)
|
Make sure that your target components (for example, `MovieCatalog` or `CustomerPreferenceDao`)
|
||||||
are consistently declared by the type that you use for your `@Autowired`-annotated
|
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
|
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
|
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
|
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
|
that implement several interfaces or for components potentially referred to by their
|
||||||
implementation type, consider declaring the most specific return type on your factory
|
implementation type, declare the most specific return type on your factory method (at
|
||||||
method (at least as specific as required by the injection points referring to your bean).
|
least as specific as required by the injection points referring to your bean).
|
||||||
====
|
====
|
||||||
|
|
||||||
.[[beans-autowired-annotation-self-injection]]Self Injection
|
.[[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`.
|
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
|
The map values are all beans of the expected type, and the keys are the corresponding
|
||||||
corresponding bean names, as the following example shows:
|
bean names, as the following example shows:
|
||||||
|
|
||||||
[tabs]
|
[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
|
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"]
|
[source,java,indent=0,subs="verbatim,quotes"]
|
||||||
----
|
----
|
||||||
|
@ -445,8 +446,8 @@ through Java 8's `java.util.Optional`, as the following example shows:
|
||||||
----
|
----
|
||||||
|
|
||||||
You can also use a parameter-level `@Nullable` annotation (of any kind in any package --
|
You can also use a parameter-level `@Nullable` annotation (of any kind in any package --
|
||||||
for example, `javax.annotation.Nullable` from JSR-305) or just leverage Kotlin built-in
|
for example, `org.jspecify.annotations.Nullable` from JSpecify) or just leverage Kotlin's
|
||||||
null-safety support:
|
built-in null-safety support:
|
||||||
|
|
||||||
[tabs]
|
[tabs]
|
||||||
======
|
======
|
||||||
|
@ -477,13 +478,6 @@ Kotlin::
|
||||||
----
|
----
|
||||||
======
|
======
|
||||||
|
|
||||||
[NOTE]
|
|
||||||
====
|
|
||||||
A type-level `@Nullable` annotation such as from JSpecify is not supported in Spring
|
|
||||||
Framework 6.2 yet. You need to upgrade to Spring Framework 7.0 where the framework
|
|
||||||
detects type-level annotations and consistently declares JSpecify in its own codebase.
|
|
||||||
====
|
|
||||||
|
|
||||||
You can also use `@Autowired` for interfaces that are well-known resolvable
|
You can also use `@Autowired` for interfaces that are well-known resolvable
|
||||||
dependencies: `BeanFactory`, `ApplicationContext`, `Environment`, `ResourceLoader`,
|
dependencies: `BeanFactory`, `ApplicationContext`, `Environment`, `ResourceLoader`,
|
||||||
`ApplicationEventPublisher`, and `MessageSource`. These interfaces and their extended
|
`ApplicationEventPublisher`, and `MessageSource`. These interfaces and their extended
|
||||||
|
@ -528,5 +522,6 @@ class MovieRecommender {
|
||||||
The `@Autowired`, `@Inject`, `@Value`, and `@Resource` annotations are handled by Spring
|
The `@Autowired`, `@Inject`, `@Value`, and `@Resource` annotations are handled by Spring
|
||||||
`BeanPostProcessor` implementations. This means that you cannot apply these annotations
|
`BeanPostProcessor` implementations. This means that you cannot apply these annotations
|
||||||
within your own `BeanPostProcessor` or `BeanFactoryPostProcessor` types (if any).
|
within your own `BeanPostProcessor` or `BeanFactoryPostProcessor` types (if any).
|
||||||
|
|
||||||
These types must be 'wired up' explicitly by using XML or a Spring `@Bean` method.
|
These types must be 'wired up' explicitly by using XML or a Spring `@Bean` method.
|
||||||
====
|
====
|
||||||
|
|
|
@ -29,6 +29,7 @@ import java.util.Set;
|
||||||
import java.util.concurrent.ConcurrentHashMap;
|
import java.util.concurrent.ConcurrentHashMap;
|
||||||
import java.util.concurrent.CopyOnWriteArrayList;
|
import java.util.concurrent.CopyOnWriteArrayList;
|
||||||
import java.util.function.Predicate;
|
import java.util.function.Predicate;
|
||||||
|
import java.util.function.Supplier;
|
||||||
import java.util.function.UnaryOperator;
|
import java.util.function.UnaryOperator;
|
||||||
|
|
||||||
import org.jspecify.annotations.Nullable;
|
import org.jspecify.annotations.Nullable;
|
||||||
|
@ -583,6 +584,27 @@ public abstract class AbstractBeanFactory extends FactoryBeanRegistrySupport imp
|
||||||
// Generics potentially only match on the target class, not on the proxy...
|
// Generics potentially only match on the target class, not on the proxy...
|
||||||
RootBeanDefinition mbd = getMergedLocalBeanDefinition(beanName);
|
RootBeanDefinition mbd = getMergedLocalBeanDefinition(beanName);
|
||||||
Class<?> targetType = mbd.getTargetType();
|
Class<?> targetType = mbd.getTargetType();
|
||||||
|
|
||||||
|
String scope = mbd.getScope();
|
||||||
|
if (targetType == null && scope != null && !scope.isEmpty()) {
|
||||||
|
String targetBeanName = "scopedTarget." + beanName;
|
||||||
|
if (containsBeanDefinition(targetBeanName)) {
|
||||||
|
RootBeanDefinition targetMbd = getMergedLocalBeanDefinition(targetBeanName);
|
||||||
|
|
||||||
|
ResolvableType targetResolvableType = targetMbd.targetType;
|
||||||
|
if (targetResolvableType == null) {
|
||||||
|
targetResolvableType = targetMbd.factoryMethodReturnType;
|
||||||
|
if (targetResolvableType == null) {
|
||||||
|
targetResolvableType = ResolvableType.forClass(targetMbd.getBeanClass());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (typeToMatch.isAssignableFrom(targetResolvableType)) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
if (targetType != null && targetType != ClassUtils.getUserClass(beanInstance)) {
|
if (targetType != null && targetType != ClassUtils.getUserClass(beanInstance)) {
|
||||||
// Check raw class match as well, making sure it's exposed on the proxy.
|
// Check raw class match as well, making sure it's exposed on the proxy.
|
||||||
Class<?> classToMatch = typeToMatch.resolve();
|
Class<?> classToMatch = typeToMatch.resolve();
|
||||||
|
|
|
@ -0,0 +1,46 @@
|
||||||
|
package org.springframework.beans.factory.support;
|
||||||
|
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
import org.springframework.core.ResolvableType;
|
||||||
|
|
||||||
|
import java.util.UUID;
|
||||||
|
import java.util.function.Supplier;
|
||||||
|
|
||||||
|
import static org.assertj.core.api.Assertions.assertThat;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Tests for {@link AbstractBeanFactory#isTypeMatch} with scoped proxy beans that use generic types.
|
||||||
|
*/
|
||||||
|
class ScopedProxyGenericTypeMatchTests {
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void scopedProxyBeanTypeMatching() {
|
||||||
|
DefaultListableBeanFactory factory = new DefaultListableBeanFactory();
|
||||||
|
|
||||||
|
String proxyBeanName = "wordBean-" + UUID.randomUUID();
|
||||||
|
String targetBeanName = "scopedTarget." + proxyBeanName;
|
||||||
|
|
||||||
|
RootBeanDefinition targetDef = new RootBeanDefinition(SomeGenericSupplier.class);
|
||||||
|
targetDef.setScope("request");
|
||||||
|
factory.registerBeanDefinition(targetBeanName, targetDef);
|
||||||
|
|
||||||
|
RootBeanDefinition proxyDef = new RootBeanDefinition();
|
||||||
|
proxyDef.setScope("singleton");
|
||||||
|
proxyDef.setTargetType(ResolvableType.forClassWithGenerics(Supplier.class, String.class));
|
||||||
|
proxyDef.setAttribute("targetBeanName", targetBeanName);
|
||||||
|
factory.registerBeanDefinition(proxyBeanName, proxyDef);
|
||||||
|
|
||||||
|
ResolvableType supplierType = ResolvableType.forClassWithGenerics(Supplier.class, String.class);
|
||||||
|
|
||||||
|
assertThat(factory.isTypeMatch(proxyBeanName, supplierType)).isTrue();
|
||||||
|
|
||||||
|
assertThat(factory.getBeanNamesForType(supplierType)).contains(proxyBeanName);
|
||||||
|
}
|
||||||
|
|
||||||
|
static class SomeGenericSupplier implements Supplier<String> {
|
||||||
|
@Override
|
||||||
|
public String get() {
|
||||||
|
return "value";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
Loading…
Reference in New Issue