org.springframework.beans.factory.config

Class ConstructorArgumentValues

java.lang.Object

org.springframework.beans.factory.config.ConstructorArgumentValues

public class ConstructorArgumentValues
extends java.lang.Object

Holder for constructor argument values, typically as part of a bean definition.

Supports values for a specific index in the constructor argument list as well as for generic argument matches by type.

Since:

09.11.2003

Author:

Juergen Hoeller

See Also:

BeanDefinition.getConstructorArgumentValues()

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ConstructorArgumentValues.ValueHolder Holder for a constructor argument value, with an optional type attribute indicating the target type of the actual constructor argument.

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.List<ConstructorArgumentValues.ValueHolder>	genericArgumentValues
private java.util.Map<java.lang.Integer,ConstructorArgumentValues.ValueHolder>	indexedArgumentValues

Constructor Summary

Constructors

Constructor and Description
ConstructorArgumentValues() Create a new empty ConstructorArgumentValues object.
ConstructorArgumentValues(ConstructorArgumentValues original) Deep copy constructor.

Method Summary

Modifier and Type	Method and Description
void	addArgumentValues(ConstructorArgumentValues other) Copy all given argument values into this object, using separate holder instances to keep the values independent from the original object.
void	addGenericArgumentValue(ConstructorArgumentValues.ValueHolder newValue) Add a generic argument value to be matched by type or name (if available).
void	addGenericArgumentValue(java.lang.Object value) Add a generic argument value to be matched by type.
void	addGenericArgumentValue(java.lang.Object value, java.lang.String type) Add a generic argument value to be matched by type.
void	addIndexedArgumentValue(int index, ConstructorArgumentValues.ValueHolder newValue) Add an argument value for the given index in the constructor argument list.
void	addIndexedArgumentValue(int index, java.lang.Object value) Add an argument value for the given index in the constructor argument list.
void	addIndexedArgumentValue(int index, java.lang.Object value, java.lang.String type) Add an argument value for the given index in the constructor argument list.
private void	addOrMergeGenericArgumentValue(ConstructorArgumentValues.ValueHolder newValue) Add a generic argument value, merging the new value (typically a collection) with the current value if demanded: see Mergeable.
private void	addOrMergeIndexedArgumentValue(java.lang.Integer key, ConstructorArgumentValues.ValueHolder newValue) Add an argument value for the given index in the constructor argument list, merging the new value (typically a collection) with the current value if demanded: see Mergeable.
void	clear() Clear this holder, removing all argument values.
boolean	equals(java.lang.Object other)
int	getArgumentCount() Return the number of argument values held in this instance, counting both indexed and generic argument values.
ConstructorArgumentValues.ValueHolder	getArgumentValue(int index, java.lang.Class<?> requiredType) Look for an argument value that either corresponds to the given index in the constructor argument list or generically matches by type.
ConstructorArgumentValues.ValueHolder	getArgumentValue(int index, java.lang.Class<?> requiredType, java.lang.String requiredName) Look for an argument value that either corresponds to the given index in the constructor argument list or generically matches by type.
ConstructorArgumentValues.ValueHolder	getArgumentValue(int index, java.lang.Class<?> requiredType, java.lang.String requiredName, java.util.Set<ConstructorArgumentValues.ValueHolder> usedValueHolders) Look for an argument value that either corresponds to the given index in the constructor argument list or generically matches by type.
ConstructorArgumentValues.ValueHolder	getGenericArgumentValue(java.lang.Class<?> requiredType) Look for a generic argument value that matches the given type.
ConstructorArgumentValues.ValueHolder	getGenericArgumentValue(java.lang.Class<?> requiredType, java.lang.String requiredName) Look for a generic argument value that matches the given type.
ConstructorArgumentValues.ValueHolder	getGenericArgumentValue(java.lang.Class<?> requiredType, java.lang.String requiredName, java.util.Set<ConstructorArgumentValues.ValueHolder> usedValueHolders) Look for the next generic argument value that matches the given type, ignoring argument values that have already been used in the current resolution process.
java.util.List<ConstructorArgumentValues.ValueHolder>	getGenericArgumentValues() Return the list of generic argument values.
ConstructorArgumentValues.ValueHolder	getIndexedArgumentValue(int index, java.lang.Class<?> requiredType) Get argument value for the given index in the constructor argument list.
ConstructorArgumentValues.ValueHolder	getIndexedArgumentValue(int index, java.lang.Class<?> requiredType, java.lang.String requiredName) Get argument value for the given index in the constructor argument list.
java.util.Map<java.lang.Integer,ConstructorArgumentValues.ValueHolder>	getIndexedArgumentValues() Return the map of indexed argument values.
int	hashCode()
boolean	hasIndexedArgumentValue(int index) Check whether an argument value has been registered for the given index.
boolean	isEmpty() Return if this holder does not contain any argument values, neither indexed ones nor generic ones.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

indexedArgumentValues

private final java.util.Map<java.lang.Integer,ConstructorArgumentValues.ValueHolder> indexedArgumentValues

genericArgumentValues

private final java.util.List<ConstructorArgumentValues.ValueHolder> genericArgumentValues

Constructor Detail

ConstructorArgumentValues

public ConstructorArgumentValues()

Create a new empty ConstructorArgumentValues object.

ConstructorArgumentValues

public ConstructorArgumentValues(ConstructorArgumentValues original)

Deep copy constructor.

Parameters:

original - the ConstructorArgumentValues to copy

Method Detail

addArgumentValues

public void addArgumentValues(ConstructorArgumentValues other)

Copy all given argument values into this object, using separate holder instances to keep the values independent from the original object.

Note: Identical ValueHolder instances will only be registered once, to allow for merging and re-merging of argument value definitions. Distinct ValueHolder instances carrying the same content are of course allowed.

addIndexedArgumentValue

public void addIndexedArgumentValue(int index,
                                    java.lang.Object value)

Add an argument value for the given index in the constructor argument list.

Parameters:

index - the index in the constructor argument list

value - the argument value

addIndexedArgumentValue

public void addIndexedArgumentValue(int index,
                                    java.lang.Object value,
                                    java.lang.String type)

Add an argument value for the given index in the constructor argument list.

Parameters:

index - the index in the constructor argument list

value - the argument value

type - the type of the constructor argument

addIndexedArgumentValue

public void addIndexedArgumentValue(int index,
                                    ConstructorArgumentValues.ValueHolder newValue)

Add an argument value for the given index in the constructor argument list.

Parameters:

index - the index in the constructor argument list

newValue - the argument value in the form of a ValueHolder

addOrMergeIndexedArgumentValue

private void addOrMergeIndexedArgumentValue(java.lang.Integer key,
                                            ConstructorArgumentValues.ValueHolder newValue)

Add an argument value for the given index in the constructor argument list, merging the new value (typically a collection) with the current value if demanded: see Mergeable.

Parameters:

key - the index in the constructor argument list

newValue - the argument value in the form of a ValueHolder

hasIndexedArgumentValue

public boolean hasIndexedArgumentValue(int index)

Check whether an argument value has been registered for the given index.

Parameters:

index - the index in the constructor argument list

getIndexedArgumentValue

public ConstructorArgumentValues.ValueHolder getIndexedArgumentValue(int index,
                                                                     java.lang.Class<?> requiredType)

Get argument value for the given index in the constructor argument list.

Parameters:

index - the index in the constructor argument list

requiredType - the type to match (can be null to match untyped values only)

Returns:

the ValueHolder for the argument, or null if none set

getIndexedArgumentValue

public ConstructorArgumentValues.ValueHolder getIndexedArgumentValue(int index,
                                                                     java.lang.Class<?> requiredType,
                                                                     java.lang.String requiredName)

Get argument value for the given index in the constructor argument list.

Parameters:

index - the index in the constructor argument list

requiredType - the type to match (can be null to match untyped values only)

requiredName - the type to match (can be null to match unnamed values only)

Returns:

the ValueHolder for the argument, or null if none set

getIndexedArgumentValues

public java.util.Map<java.lang.Integer,ConstructorArgumentValues.ValueHolder> getIndexedArgumentValues()

Return the map of indexed argument values.

Returns:

unmodifiable Map with Integer index as key and ValueHolder as value

See Also:

ConstructorArgumentValues.ValueHolder

addGenericArgumentValue

public void addGenericArgumentValue(java.lang.Object value)

Add a generic argument value to be matched by type.

Note: A single generic argument value will just be used once, rather than matched multiple times.

Parameters:

value - the argument value

addGenericArgumentValue

public void addGenericArgumentValue(java.lang.Object value,
                                    java.lang.String type)

Add a generic argument value to be matched by type.

Note: A single generic argument value will just be used once, rather than matched multiple times.

Parameters:

value - the argument value

type - the type of the constructor argument

addGenericArgumentValue

public void addGenericArgumentValue(ConstructorArgumentValues.ValueHolder newValue)

Add a generic argument value to be matched by type or name (if available).

Note: A single generic argument value will just be used once, rather than matched multiple times.

Parameters:

newValue - the argument value in the form of a ValueHolder

Note: Identical ValueHolder instances will only be registered once, to allow for merging and re-merging of argument value definitions. Distinct ValueHolder instances carrying the same content are of course allowed.

addOrMergeGenericArgumentValue

private void addOrMergeGenericArgumentValue(ConstructorArgumentValues.ValueHolder newValue)

Add a generic argument value, merging the new value (typically a collection) with the current value if demanded: see Mergeable.

Parameters:

newValue - the argument value in the form of a ValueHolder

getGenericArgumentValue

public ConstructorArgumentValues.ValueHolder getGenericArgumentValue(java.lang.Class<?> requiredType)

Look for a generic argument value that matches the given type.

Parameters:

requiredType - the type to match

Returns:

the ValueHolder for the argument, or null if none set

getGenericArgumentValue

public ConstructorArgumentValues.ValueHolder getGenericArgumentValue(java.lang.Class<?> requiredType,
                                                                     java.lang.String requiredName)

Look for a generic argument value that matches the given type.

Parameters:

requiredType - the type to match

requiredName - the name to match

Returns:

the ValueHolder for the argument, or null if none set

getGenericArgumentValue

public ConstructorArgumentValues.ValueHolder getGenericArgumentValue(java.lang.Class<?> requiredType,
                                                                     java.lang.String requiredName,
                                                                     java.util.Set<ConstructorArgumentValues.ValueHolder> usedValueHolders)

Look for the next generic argument value that matches the given type, ignoring argument values that have already been used in the current resolution process.

Parameters:

requiredType - the type to match (can be null to find an arbitrary next generic argument value)

requiredName - the name to match (can be null to not match argument values by name)

usedValueHolders - a Set of ValueHolder objects that have already been used in the current resolution process and should therefore not be returned again

Returns:

the ValueHolder for the argument, or null if none found

getGenericArgumentValues

public java.util.List<ConstructorArgumentValues.ValueHolder> getGenericArgumentValues()

Return the list of generic argument values.

Returns:

unmodifiable List of ValueHolders

See Also:

ConstructorArgumentValues.ValueHolder

getArgumentValue

public ConstructorArgumentValues.ValueHolder getArgumentValue(int index,
                                                              java.lang.Class<?> requiredType)

Look for an argument value that either corresponds to the given index in the constructor argument list or generically matches by type.

Parameters:

index - the index in the constructor argument list

requiredType - the parameter type to match

Returns:

the ValueHolder for the argument, or null if none set

getArgumentValue

public ConstructorArgumentValues.ValueHolder getArgumentValue(int index,
                                                              java.lang.Class<?> requiredType,
                                                              java.lang.String requiredName)

Look for an argument value that either corresponds to the given index in the constructor argument list or generically matches by type.

Parameters:

index - the index in the constructor argument list

requiredType - the parameter type to match

requiredName - the parameter name to match

Returns:

the ValueHolder for the argument, or null if none set

getArgumentValue

public ConstructorArgumentValues.ValueHolder getArgumentValue(int index,
                                                              java.lang.Class<?> requiredType,
                                                              java.lang.String requiredName,
                                                              java.util.Set<ConstructorArgumentValues.ValueHolder> usedValueHolders)

Look for an argument value that either corresponds to the given index in the constructor argument list or generically matches by type.

Parameters:

index - the index in the constructor argument list

requiredType - the parameter type to match (can be null to find an untyped argument value)

requiredName - the parameter name to match (can be null to find an unnamed argument value)

usedValueHolders - a Set of ValueHolder objects that have already been used in the current resolution process and should therefore not be returned again (allowing to return the next generic argument match in case of multiple generic argument values of the same type)

Returns:

the ValueHolder for the argument, or null if none set

getArgumentCount

public int getArgumentCount()

Return the number of argument values held in this instance, counting both indexed and generic argument values.

isEmpty

public boolean isEmpty()

Return if this holder does not contain any argument values, neither indexed ones nor generic ones.

clear

public void clear()

Clear this holder, removing all argument values.

equals

public boolean equals(java.lang.Object other)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object