Modifier and Type	Class and Description
private static class	ConstructorResolver.ArgumentsHolder Private inner class for holding argument combinations.
private static class	ConstructorResolver.ConstructorDependencyDescriptor DependencyDescriptor marker for constructor arguments, for differentiating between a provided DependencyDescriptor instance and an internally built DependencyDescriptor for autowiring purposes.
private static class	ConstructorResolver.ConstructorPropertiesChecker Delegate for checking Java's `ConstructorProperties` annotation.
private static enum	ConstructorResolver.FallbackMode

Modifier and Type	Field and Description
private final AbstractAutowireCapableBeanFactory	beanFactory
private static final NamedThreadLocal<InjectionPoint>	currentInjectionPoint
private static final Object[]	EMPTY_ARGS
private final Log	logger

Access	Constructor and Description
public	ConstructorResolver(AbstractAutowireCapableBeanFactory the BeanFactory to work with beanFactory) Create a new ConstructorResolver for the given factory and instantiation strategy.

Method Summary

Modifier and Type	Method and Description
public BeanWrapper	Returns: a BeanWrapper for the new instance autowireConstructor(String the name of the bean beanName, RootBeanDefinition the merged bean definition for the bean mbd, Constructor<?>[] chosen candidate constructors (or `null` if none) chosenCtors, Object[] argument values passed in programmatically via the getBean method, or `null` if none (-> use constructor argument values from bean definition) explicitArgs) "autowire constructor" (with constructor arguments by type) behavior.
private ConstructorResolver.ArgumentsHolder	createArgumentArray(String beanName, RootBeanDefinition mbd, ConstructorArgumentValues resolvedValues, BeanWrapper bw, Class<?>[] paramTypes, String[] paramNames, Executable executable, boolean autowiring, boolean fallback) Create an array of arguments to invoke a constructor or factory method, given the resolved constructor argument values.
private ResolvableType	determineParameterValueType(RootBeanDefinition mbd, ConstructorArgumentValues.ValueHolder valueHolder)
private List<ResolvableType>	determineParameterValueTypes(RootBeanDefinition mbd)
pack-priv static Constructor<?>[]	determinePreferredConstructors(Class<?> clazz) See `BeanUtils#getResolvableConstructor(Class)` for alignment.
private ResolvableType	extractElementType(ResolvableType parameterType)
private ResolvableType	getBeanType(String beanName, RootBeanDefinition mbd)
private Method[]	getCandidateMethods(Class<?> factoryClass, RootBeanDefinition mbd) Retrieve all candidate methods for the given class, considering the `RootBeanDefinition#isNonPublicAccessAllowed()` flag.
private Class<?>	getFactoryBeanClass(String beanName, RootBeanDefinition mbd)
private Constructor<?>	getUserDeclaredConstructor(Constructor<?> constructor)
private Object	instantiate(String beanName, RootBeanDefinition mbd, Constructor<?> constructorToUse, Object[] argsToUse)
private Object	instantiate(String beanName, RootBeanDefinition mbd, Object factoryBean, Method factoryMethod, Object[] args)
public BeanWrapper	Returns: a BeanWrapper for the new instance instantiateUsingFactoryMethod(String the name of the bean beanName, RootBeanDefinition the merged bean definition for the bean mbd, Object[] argument values passed in programmatically via the getBean method, or `null` if none (-> use constructor argument values from bean definition) explicitArgs) Instantiate the bean using a named factory method.
private Predicate<ResolvableType>	isAssignable(ResolvableType valueType)
private boolean	isMatch(ResolvableType parameterType, ResolvableType valueType, ConstructorResolver.FallbackMode fallbackMode)
private boolean	isParamMismatch(Method uniqueCandidate, Method candidate)
private Predicate<ResolvableType>	isSimpleValueType(ResolvableType valueType)
private boolean	isStaticCandidate(Method method, Class<?> factoryClass)
private Predicate<ResolvableType>	Returns: a predicate to indicate a fallback match for a String to Class parameter isStringForClassFallback(ResolvableType the type of the value valueType) Return a `Predicate` for a parameter type that checks if its target value is a `Class` and the value type is a `String`.
private boolean	match(List<ResolvableType> parameterTypes, List<ResolvableType> valueTypes, ConstructorResolver.FallbackMode fallbackMode)
private void	registerDependentBeans(Executable executable, String beanName, Set<String> autowiredBeanNames)
pack-priv Object	resolveAutowiredArgument(DependencyDescriptor descriptor, Class<?> paramType, String beanName, Set<String> autowiredBeanNames, TypeConverter typeConverter, boolean fallback) Resolve the specified argument which is supposed to be autowired.
private Constructor<?>	resolveConstructor(String beanName, RootBeanDefinition mbd, Supplier<ResolvableType> beanType, List<ResolvableType> valueTypes)
private int	resolveConstructorArguments(String beanName, RootBeanDefinition mbd, BeanWrapper bw, ConstructorArgumentValues cargs, ConstructorArgumentValues resolvedValues) Resolve the constructor arguments for this bean into the resolvedValues object.
public Executable	resolveConstructorOrFactoryMethod(String beanName, RootBeanDefinition mbd)
private Method	resolveFactoryMethod(String beanName, RootBeanDefinition mbd, List<ResolvableType> valueTypes)
private Method	resolveFactoryMethod(List<Method> executables, Function<Method, List<ResolvableType>> parameterTypesFactory, List<ResolvableType> valueTypes)
public void	resolveFactoryMethodIfPossible(RootBeanDefinition the bean definition to check mbd) Resolve the factory method in the specified bean definition, if possible.
private Object[]	resolvePreparedArguments(String beanName, RootBeanDefinition mbd, BeanWrapper bw, Executable executable, Object[] argsToResolve) Resolve the prepared arguments stored in the given bean definition.
pack-priv static InjectionPoint	setCurrentInjectionPoint(InjectionPoint injectionPoint)
private void	setShortcutIfPossible(ConstructorResolver.ConstructorDependencyDescriptor descriptor, Class<?> paramType, Set<String> autowiredBeanNames)
private Predicate<ResolvableType>	typeConversionFallback(ResolvableType valueType)
private Predicate<ResolvableType>	valueOrCollection(ResolvableType valueType, Function<ResolvableType, Predicate<ResolvableType>> predicateProvider)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

beanFactory	back to summary
private final AbstractAutowireCapableBeanFactory beanFactory

currentInjectionPoint	back to summary
private static final NamedThreadLocal<InjectionPoint> currentInjectionPoint

EMPTY_ARGS	back to summary
private static final Object[] EMPTY_ARGS

logger	back to summary
private final Log logger

Constructor Detail

ConstructorResolver	back to summary
public ConstructorResolver(AbstractAutowireCapableBeanFactory beanFactory) Create a new ConstructorResolver for the given factory and instantiation strategy. Parameters beanFactory:AbstractAutowireCapableBeanFactory the BeanFactory to work with

ConstructorResolver

back to summary

public ConstructorResolver(AbstractAutowireCapableBeanFactory beanFactory)

Create a new ConstructorResolver for the given factory and instantiation strategy.

Parameters

beanFactory:AbstractAutowireCapableBeanFactory: the BeanFactory to work with

Method Detail

autowireConstructor back to summary

autowireConstructor	back to summary
public BeanWrapper autowireConstructor(String beanName, RootBeanDefinition mbd, Constructor<?>[] chosenCtors, Object[] explicitArgs) "autowire constructor" (with constructor arguments by type) behavior. Also applied if explicit constructor argument values are specified. Parameters beanName:String the name of the bean mbd:RootBeanDefinition the merged bean definition for the bean chosenCtors:Constructor<?>[] chosen candidate constructors (or `null` if none) explicitArgs:Object[] argument values passed in programmatically via the getBean method, or `null` if none (-> use constructor argument values from bean definition) Returns:BeanWrapper a BeanWrapper for the new instance

public BeanWrapper autowireConstructor(String beanName, RootBeanDefinition mbd, Constructor<?>[] chosenCtors, Object[] explicitArgs)

"autowire constructor" (with constructor arguments by type) behavior. Also applied if explicit constructor argument values are specified.

Parameters

beanName:String: the name of the bean
mbd:RootBeanDefinition: the merged bean definition for the bean
chosenCtors:Constructor<?>[]: chosen candidate constructors (or null if none)
explicitArgs:Object[]: argument values passed in programmatically via the getBean method, or null if none (-> use constructor argument values from bean definition)

Returns:BeanWrapper

a BeanWrapper for the new instance

createArgumentArray	back to summary
private ConstructorResolver.ArgumentsHolder createArgumentArray(String beanName, RootBeanDefinition mbd, ConstructorArgumentValues resolvedValues, BeanWrapper bw, Class<?>[] paramTypes, String[] paramNames, Executable executable, boolean autowiring, boolean fallback) throws UnsatisfiedDependencyException Create an array of arguments to invoke a constructor or factory method, given the resolved constructor argument values.

createArgumentArray

back to summary

private ConstructorResolver.ArgumentsHolder createArgumentArray(String beanName, RootBeanDefinition mbd, ConstructorArgumentValues resolvedValues, BeanWrapper bw, Class<?>[] paramTypes, String[] paramNames, Executable executable, boolean autowiring, boolean fallback) throws UnsatisfiedDependencyException

Create an array of arguments to invoke a constructor or factory method, given the resolved constructor argument values.

determineParameterValueType	back to summary
private ResolvableType determineParameterValueType(RootBeanDefinition mbd, ConstructorArgumentValues.ValueHolder valueHolder)

determineParameterValueTypes	back to summary
private List<ResolvableType> determineParameterValueTypes(RootBeanDefinition mbd)

determinePreferredConstructors back to summary

determinePreferredConstructors	back to summary
pack-priv static Constructor<?>[] determinePreferredConstructors(Class<?> clazz) See `BeanUtils#getResolvableConstructor(Class)` for alignment. This variant adds a lenient fallback to the default constructor if available, similar to `org.springframework.beans.factory.annotation.AutowiredAnnotationBeanPostProcessor#determineCandidateConstructors`. Annotations @Nullable

pack-priv static Constructor<?>[] determinePreferredConstructors(Class<?> clazz)

See BeanUtils#getResolvableConstructor(Class) for alignment. This variant adds a lenient fallback to the default constructor if available, similar to org.springframework.beans.factory.annotation.AutowiredAnnotationBeanPostProcessor#determineCandidateConstructors.

Annotations

@Nullable

extractElementType	back to summary
private ResolvableType extractElementType(ResolvableType parameterType)

getBeanType	back to summary
private ResolvableType getBeanType(String beanName, RootBeanDefinition mbd)

getCandidateMethods	back to summary
private Method[] getCandidateMethods(Class<?> factoryClass, RootBeanDefinition mbd) Retrieve all candidate methods for the given class, considering the `RootBeanDefinition#isNonPublicAccessAllowed()` flag. Called as the starting point for factory method determination.

getFactoryBeanClass	back to summary
private Class<?> getFactoryBeanClass(String beanName, RootBeanDefinition mbd) Annotations @Nullable

getUserDeclaredConstructor	back to summary
private Constructor<?> getUserDeclaredConstructor(Constructor<?> constructor)

instantiate	back to summary
private Object instantiate(String beanName, RootBeanDefinition mbd, Constructor<?> constructorToUse, Object[] argsToUse)

instantiate	back to summary
private Object instantiate(String beanName, RootBeanDefinition mbd, Object factoryBean, Method factoryMethod, Object[] args)

instantiateUsingFactoryMethod back to summary

instantiateUsingFactoryMethod	back to summary
public BeanWrapper instantiateUsingFactoryMethod(String beanName, RootBeanDefinition mbd, Object[] explicitArgs) Instantiate the bean using a named factory method. The method may be static, if the bean definition parameter specifies a class, rather than a "factory-bean", or an instance variable on a factory object itself configured using Dependency Injection. Implementation requires iterating over the static or instance methods with the name specified in the RootBeanDefinition (the method may be overloaded) and trying to match with the parameters. We don't have the types attached to constructor args, so trial and error is the only way to go here. The explicitArgs array may contain argument values passed in programmatically via the corresponding getBean method. Parameters beanName:String the name of the bean mbd:RootBeanDefinition the merged bean definition for the bean explicitArgs:Object[] argument values passed in programmatically via the getBean method, or `null` if none (-> use constructor argument values from bean definition) Returns:BeanWrapper a BeanWrapper for the new instance

public BeanWrapper instantiateUsingFactoryMethod(String beanName, RootBeanDefinition mbd, Object[] explicitArgs)

Instantiate the bean using a named factory method. The method may be static, if the bean definition parameter specifies a class, rather than a "factory-bean", or an instance variable on a factory object itself configured using Dependency Injection.

Implementation requires iterating over the static or instance methods with the name specified in the RootBeanDefinition (the method may be overloaded) and trying to match with the parameters. We don't have the types attached to constructor args, so trial and error is the only way to go here. The explicitArgs array may contain argument values passed in programmatically via the corresponding getBean method.

Parameters

beanName:String: the name of the bean
mbd:RootBeanDefinition: the merged bean definition for the bean
explicitArgs:Object[]: argument values passed in programmatically via the getBean method, or null if none (-> use constructor argument values from bean definition)

Returns:BeanWrapper

a BeanWrapper for the new instance

isAssignable	back to summary
private Predicate<ResolvableType> isAssignable(ResolvableType valueType)

isMatch	back to summary
private boolean isMatch(ResolvableType parameterType, ResolvableType valueType, ConstructorResolver.FallbackMode fallbackMode)

isParamMismatch	back to summary
private boolean isParamMismatch(Method uniqueCandidate, Method candidate)

isSimpleValueType	back to summary
private Predicate<ResolvableType> isSimpleValueType(ResolvableType valueType)

isStaticCandidate	back to summary
private boolean isStaticCandidate(Method method, Class<?> factoryClass)

isStringForClassFallback back to summary

isStringForClassFallback	back to summary
private Predicate<ResolvableType> isStringForClassFallback(ResolvableType valueType) Return a `Predicate` for a parameter type that checks if its target value is a `Class` and the value type is a `String`. This is a regular use cases where a `Class` is defined in the bean definition as an FQN. Parameters valueType:ResolvableType the type of the value Returns:Predicate<ResolvableType> a predicate to indicate a fallback match for a String to Class parameter

private Predicate<ResolvableType> isStringForClassFallback(ResolvableType valueType)

Return a Predicate for a parameter type that checks if its target value is a Class and the value type is a String. This is a regular use cases where a Class is defined in the bean definition as an FQN.

Parameters

valueType:ResolvableType: the type of the value

Returns:Predicate<ResolvableType>

a predicate to indicate a fallback match for a String to Class parameter

match	back to summary
private boolean match(List<ResolvableType> parameterTypes, List<ResolvableType> valueTypes, ConstructorResolver.FallbackMode fallbackMode)

registerDependentBeans	back to summary
private void registerDependentBeans(Executable executable, String beanName, Set<String> autowiredBeanNames)

resolveAutowiredArgument	back to summary
pack-priv Object resolveAutowiredArgument(DependencyDescriptor descriptor, Class<?> paramType, String beanName, Set<String> autowiredBeanNames, TypeConverter typeConverter, boolean fallback) Resolve the specified argument which is supposed to be autowired. Annotations @Nullable

resolveAutowiredArgument

back to summary

pack-priv Object resolveAutowiredArgument(DependencyDescriptor descriptor, Class<?> paramType, String beanName, Set<String> autowiredBeanNames, TypeConverter typeConverter, boolean fallback)

Resolve the specified argument which is supposed to be autowired.

Annotations

@Nullable

resolveConstructor	back to summary
private Constructor<?> resolveConstructor(String beanName, RootBeanDefinition mbd, Supplier<ResolvableType> beanType, List<ResolvableType> valueTypes) Annotations @Nullable

resolveConstructorArguments	back to summary
private int resolveConstructorArguments(String beanName, RootBeanDefinition mbd, BeanWrapper bw, ConstructorArgumentValues cargs, ConstructorArgumentValues resolvedValues) Resolve the constructor arguments for this bean into the resolvedValues object. This may involve looking up other beans. This method is also used for handling invocations of static factory methods.

resolveConstructorArguments

back to summary

private int resolveConstructorArguments(String beanName, RootBeanDefinition mbd, BeanWrapper bw, ConstructorArgumentValues cargs, ConstructorArgumentValues resolvedValues)

Resolve the constructor arguments for this bean into the resolvedValues object. This may involve looking up other beans.

This method is also used for handling invocations of static factory methods.

resolveConstructorOrFactoryMethod	back to summary
public Executable resolveConstructorOrFactoryMethod(String beanName, RootBeanDefinition mbd)

resolveFactoryMethod	back to summary
private Method resolveFactoryMethod(String beanName, RootBeanDefinition mbd, List<ResolvableType> valueTypes) Annotations @Nullable

resolveFactoryMethod	back to summary
private Method resolveFactoryMethod(List<Method> executables, Function<Method, List<ResolvableType>> parameterTypesFactory, List<ResolvableType> valueTypes) Annotations @Nullable

resolveFactoryMethodIfPossible back to summary

resolveFactoryMethodIfPossible	back to summary
public void resolveFactoryMethodIfPossible(RootBeanDefinition mbd) Resolve the factory method in the specified bean definition, if possible. `RootBeanDefinition#getResolvedFactoryMethod()` can be checked for the result. Parameters mbd:RootBeanDefinition the bean definition to check

public void resolveFactoryMethodIfPossible(RootBeanDefinition mbd)

Resolve the factory method in the specified bean definition, if possible. RootBeanDefinition#getResolvedFactoryMethod() can be checked for the result.

Parameters

mbd:RootBeanDefinition: the bean definition to check

resolvePreparedArguments	back to summary
private Object[] resolvePreparedArguments(String beanName, RootBeanDefinition mbd, BeanWrapper bw, Executable executable, Object[] argsToResolve) Resolve the prepared arguments stored in the given bean definition.

setCurrentInjectionPoint	back to summary
pack-priv static InjectionPoint setCurrentInjectionPoint(InjectionPoint injectionPoint)

setShortcutIfPossible	back to summary
private void setShortcutIfPossible(ConstructorResolver.ConstructorDependencyDescriptor descriptor, Class<?> paramType, Set<String> autowiredBeanNames)

typeConversionFallback	back to summary
private Predicate<ResolvableType> typeConversionFallback(ResolvableType valueType)

valueOrCollection	back to summary
private Predicate<ResolvableType> valueOrCollection(ResolvableType valueType, Function<ResolvableType, Predicate<ResolvableType>> predicateProvider)

org.springframework.beans.factory.support back to summary

private Class ConstructorResolver.ArgumentsHolder

Class Inheritance

extends Object

java.lang.Object
org.springframework.beans.factory.support.ConstructorResolver.ArgumentsHolder

Private inner class for holding argument combinations.

Field Summary

Modifier and Type	Field and Description
public final Object[]	arguments
public final Object[]	preparedArguments
public final Object[]	rawArguments
public boolean	resolveNecessary

Constructor Summary

Access	Constructor and Description
public	ArgumentsHolder(int size)
public	ArgumentsHolder(Object[] args)

Method Summary

Modifier and Type	Method and Description
public int	getAssignabilityWeight(Class<?>[] paramTypes)
public int	getTypeDifferenceWeight(Class<?>[] paramTypes)
public void	storeCache(RootBeanDefinition mbd, Executable constructorOrFactoryMethod)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

arguments	back to summary
public final Object[] arguments

preparedArguments	back to summary
public final Object[] preparedArguments

rawArguments	back to summary
public final Object[] rawArguments

resolveNecessary	back to summary
public boolean resolveNecessary

Constructor Detail

ArgumentsHolder	back to summary
public ArgumentsHolder(int size)

ArgumentsHolder	back to summary
public ArgumentsHolder(Object[] args)

Method Detail

getAssignabilityWeight	back to summary
public int getAssignabilityWeight(Class<?>[] paramTypes)

getTypeDifferenceWeight	back to summary
public int getTypeDifferenceWeight(Class<?>[] paramTypes)

storeCache	back to summary
public void storeCache(RootBeanDefinition mbd, Executable constructorOrFactoryMethod)

org.springframework.beans.factory.support back to summary

private Class ConstructorResolver.ConstructorDependencyDescriptor

Class Inheritance

extends DependencyDescriptor

java.lang.Object
org.springframework.beans.factory.InjectionPoint
org.springframework.beans.factory.config.DependencyDescriptor
org.springframework.beans.factory.support.ConstructorResolver.ConstructorDependencyDescriptor

Annotations

@SuppressWarnings:serial

DependencyDescriptor marker for constructor arguments, for differentiating between a provided DependencyDescriptor instance and an internally built DependencyDescriptor for autowiring purposes.

Field Summary

Modifier and Type	Field and Description
private volatile String	shortcut

Constructor Summary

Access	Constructor and Description
public	ConstructorDependencyDescriptor(MethodParameter methodParameter, boolean required)

Method Summary

Modifier and Type	Method and Description
public boolean	hasShortcut()
public Object	resolveShortcut(BeanFactory the associated factory beanFactory) Overrides org.springframework.beans.factory.config.DependencyDescriptor.resolveShortcut. Resolve a shortcut for this dependency against the given factory, for example taking some pre-resolved information into account.
public void	setShortcut(String shortcut)

Inherited from org.springframework.beans.factory.config.DependencyDescriptor:: equals fallbackMatchAllowed forFallbackMatch getDependencyName getDependencyType getResolvableType getTypeDescriptor hashCode increaseNestingLevel initParameterNameDiscovery isEager isRequired resolveCandidate resolveNotUnique setContainingClass supportsLazyResolution

Field Detail

shortcut	back to summary
private volatile String shortcut Annotations @Nullable

Constructor Detail

ConstructorDependencyDescriptor	back to summary
public ConstructorDependencyDescriptor(MethodParameter methodParameter, boolean required)

Method Detail

hasShortcut	back to summary
public boolean hasShortcut()

resolveShortcut back to summary

public Object resolveShortcut(BeanFactory beanFactory)

Overrides org.springframework.beans.factory.config.DependencyDescriptor.resolveShortcut.

Doc from org.springframework.beans.factory.config.DependencyDescriptor.resolveShortcut.

Resolve a shortcut for this dependency against the given factory, for example taking some pre-resolved information into account.

The resolution algorithm will first attempt to resolve a shortcut through this method before going into the regular type matching algorithm across all beans. Subclasses may override this method to improve resolution performance based on pre-cached information while still receiving InjectionPoint exposure etc.

Parameters

beanFactory:BeanFactory: the associated factory

Returns:Object

the shortcut result if any, or null if none

Annotations

@Override

setShortcut	back to summary
public void setShortcut(String shortcut)

Modifier and Type	Field and Description
public static final ConstructorResolver.FallbackMode	ASSIGNABLE_ELEMENT
public static final ConstructorResolver.FallbackMode	NONE
public static final ConstructorResolver.FallbackMode	TYPE_CONVERSION

Modifier and Type	Method and Description
public static ConstructorResolver.FallbackMode	valueOf(String name)
public static ConstructorResolver.FallbackMode[]	values()

pack-priv Class ConstructorResolver

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class ConstructorResolver.ArgumentsHolder

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class ConstructorResolver.ConstructorDependencyDescriptor

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class ConstructorResolver.ConstructorPropertiesChecker

Constructor Summary

Method Summary

Constructor Detail

Method Detail

private final Enum ConstructorResolver.FallbackMode

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail