Class LocalParameterMap
java.lang.Object
org.springframework.webflow.core.collection.LocalParameterMap
- All Implemented Interfaces:
Serializable
,MapAdaptable<String,
,Object> ParameterMap
- Direct Known Subclasses:
MockParameterMap
An immutable parameter map storing String-keyed, String-valued parameters in a backing
Map
implementation.
This base provides convenient operations for accessing parameters in a typed-manner.- Author:
- Keith Donald
- See Also:
-
Constructor Summary
ConstructorDescriptionLocalParameterMap
(Map<String, Object> parameters) Creates a new parameter map from the provided map.LocalParameterMap
(Map<String, Object> parameters, ConversionService conversionService) Creates a new parameter map from the provided map. -
Method Summary
Modifier and TypeMethodDescriptionAdapts this parameter map to anAttributeMap
.asMap()
Returns this object's contents as aMap
.boolean
Does the parameter with the provided name exist in this map?boolean
Get a parameter value, returningnull
if no value is found.<T> T
Get a parameter value, converting it fromString
to the target type.<T> T
Get a parameter value, converting it fromString
to the target type or returning the defaultValue if not found.Get a parameter value, returning the defaultValue if no value is found.String[]
Get a multi-valued parameter value, returningnull
if no value is found.<T> T[]
Get a multi-valued parameter value, converting each value to the target type or returningnull
if no value is found.getBoolean
(String parameterName) Returns a boolean parameter value in the map, returningnull
if no value was found.getBoolean
(String parameterName, Boolean defaultValue) Returns a boolean parameter value in the map, returning the defaultValue if no value was found.getInteger
(String parameterName) Returns an integer parameter value in the map, returningnull
if no value was found.getInteger
(String parameterName, Integer defaultValue) Returns an integer parameter value in the map, returning the defaultValue if no value was found.Returns a long parameter value in the map, returningnull
if no value was found.Returns a long parameter value in the map, returning the defaultValue if no value was found.Returns the wrapped, modifiable map implementation.org.springframework.web.multipart.MultipartFile
getMultipartFile
(String parameterName) Get a multi-part file parameter value, returningnull
if no value is found.<T extends Number>
TReturns a number parameter value in the map that is of the specified type, returningnull
if no value was found.<T extends Number>
TReturns a number parameter value in the map of the specified type, returning the defaultValue if no value was found.getRequired
(String parameterName) Get the value of a required parameter.<T> T
getRequired
(String parameterName, Class<T> targetType) Get the value of a required parameter and convert it to the target type.String[]
getRequiredArray
(String parameterName) Get a required multi-valued parameter value.<T> T[]
getRequiredArray
(String parameterName, Class<T> targetElementType) Get a required multi-valued parameter value, converting each value to the target type.getRequiredBoolean
(String parameterName) Returns a boolean parameter value in the map, throwing an exception if the parameter is not present or could not be converted.getRequiredInteger
(String parameterName) Returns an integer parameter value in the map, throwing an exception if the parameter is not present or could not be converted.getRequiredLong
(String parameterName) Returns a long parameter value in the map, throwing an exception if the parameter is not present or could not be converted.org.springframework.web.multipart.MultipartFile
getRequiredMultipartFile
(String parameterName) Get the value of a required multipart file parameter.<T extends Number>
TgetRequiredNumber
(String parameterName, Class<T> targetType) Returns a number parameter value in the map, throwing an exception if the parameter is not present or could not be converted.int
hashCode()
protected void
initParameters
(Map<String, Object> parameters) Initializes this parameter map.boolean
isEmpty()
Is this parameter map empty, with a size of 0?int
size()
Returns the number of parameters in this map.toString()
-
Constructor Details
-
LocalParameterMap
Creates a new parameter map from the provided map.It is expected that the contents of the backing map adhere to the parameter map contract; that is, map entries have string keys, string values, and remain unmodifiable.
- Parameters:
parameters
- the contents of this parameter map
-
LocalParameterMap
Creates a new parameter map from the provided map.It is expected that the contents of the backing map adhere to the parameter map contract; that is, map entries have string keys, string values, and remain unmodifiable.
- Parameters:
parameters
- the contents of this parameter mapconversionService
- a helper for performing type conversion of map entry values
-
-
Method Details
-
equals
-
hashCode
public int hashCode() -
asMap
Description copied from interface:MapAdaptable
Returns this object's contents as aMap
. The returned map may or may not be modifiable depending on this implementation.Warning: this operation may be called frequently; if so care should be taken so that the map contents (if calculated) be cached as appropriate.
- Specified by:
asMap
in interfaceMapAdaptable<String,
Object> - Returns:
- the object's contents as a map
-
isEmpty
public boolean isEmpty()Description copied from interface:ParameterMap
Is this parameter map empty, with a size of 0?- Specified by:
isEmpty
in interfaceParameterMap
- Returns:
- true if empty, false if not
-
size
public int size()Description copied from interface:ParameterMap
Returns the number of parameters in this map.- Specified by:
size
in interfaceParameterMap
- Returns:
- the parameter count
-
contains
Description copied from interface:ParameterMap
Does the parameter with the provided name exist in this map?- Specified by:
contains
in interfaceParameterMap
- Parameters:
parameterName
- the parameter name- Returns:
- true if so, false otherwise
-
get
Description copied from interface:ParameterMap
Get a parameter value, returningnull
if no value is found.- Specified by:
get
in interfaceParameterMap
- Parameters:
parameterName
- the parameter name- Returns:
- the parameter value
-
get
Description copied from interface:ParameterMap
Get a parameter value, returning the defaultValue if no value is found.- Specified by:
get
in interfaceParameterMap
- Parameters:
parameterName
- the parameter namedefaultValue
- the default- Returns:
- the parameter value
-
getArray
Description copied from interface:ParameterMap
Get a multi-valued parameter value, returningnull
if no value is found. If the parameter is single valued an array with a single element is returned.- Specified by:
getArray
in interfaceParameterMap
- Parameters:
parameterName
- the parameter name- Returns:
- the parameter value array
-
getArray
public <T> T[] getArray(String parameterName, Class<T> targetElementType) throws ConversionExecutionException Description copied from interface:ParameterMap
Get a multi-valued parameter value, converting each value to the target type or returningnull
if no value is found.- Specified by:
getArray
in interfaceParameterMap
- Parameters:
parameterName
- the parameter nametargetElementType
- the target type of the array's elements- Returns:
- the converterd parameter value array
- Throws:
ConversionExecutionException
- when the value could not be converted
-
get
Description copied from interface:ParameterMap
Get a parameter value, converting it fromString
to the target type.- Specified by:
get
in interfaceParameterMap
- Parameters:
parameterName
- the name of the parametertargetType
- the target type of the parameter value- Returns:
- the converted parameter value, or null if not found
- Throws:
ConversionExecutionException
- when the value could not be converted
-
get
public <T> T get(String parameterName, Class<T> targetType, T defaultValue) throws ConversionExecutionException Description copied from interface:ParameterMap
Get a parameter value, converting it fromString
to the target type or returning the defaultValue if not found.- Specified by:
get
in interfaceParameterMap
- Parameters:
parameterName
- name of the parameter to gettargetType
- the target type of the parameter valuedefaultValue
- the default value- Returns:
- the converted parameter value, or the default if not found
- Throws:
ConversionExecutionException
- when a value could not be converted
-
getRequired
Description copied from interface:ParameterMap
Get the value of a required parameter.- Specified by:
getRequired
in interfaceParameterMap
- Parameters:
parameterName
- the name of the parameter- Returns:
- the parameter value
- Throws:
IllegalArgumentException
- when the parameter is not found
-
getRequiredArray
Description copied from interface:ParameterMap
Get a required multi-valued parameter value.- Specified by:
getRequiredArray
in interfaceParameterMap
- Parameters:
parameterName
- the name of the parameter- Returns:
- the parameter value
- Throws:
IllegalArgumentException
- when the parameter is not found
-
getRequiredArray
public <T> T[] getRequiredArray(String parameterName, Class<T> targetElementType) throws IllegalArgumentException, ConversionExecutionException Description copied from interface:ParameterMap
Get a required multi-valued parameter value, converting each value to the target type.- Specified by:
getRequiredArray
in interfaceParameterMap
- Parameters:
parameterName
- the name of the parameter- Returns:
- the parameter value
- Throws:
IllegalArgumentException
- when the parameter is not foundConversionExecutionException
- when a value could not be converted
-
getRequired
public <T> T getRequired(String parameterName, Class<T> targetType) throws IllegalArgumentException, ConversionExecutionException Description copied from interface:ParameterMap
Get the value of a required parameter and convert it to the target type.- Specified by:
getRequired
in interfaceParameterMap
- Parameters:
parameterName
- the name of the parametertargetType
- the target type of the parameter value- Returns:
- the converted parameter value
- Throws:
IllegalArgumentException
- when the parameter is not foundConversionExecutionException
- when the value could not be converted
-
getNumber
public <T extends Number> T getNumber(String parameterName, Class<T> targetType) throws ConversionExecutionException Description copied from interface:ParameterMap
Returns a number parameter value in the map that is of the specified type, returningnull
if no value was found.- Specified by:
getNumber
in interfaceParameterMap
- Parameters:
parameterName
- the parameter nametargetType
- the target number type- Returns:
- the number parameter value
- Throws:
ConversionExecutionException
- when the value could not be converted
-
getNumber
public <T extends Number> T getNumber(String parameterName, Class<T> targetType, T defaultValue) throws ConversionExecutionException Description copied from interface:ParameterMap
Returns a number parameter value in the map of the specified type, returning the defaultValue if no value was found.- Specified by:
getNumber
in interfaceParameterMap
- Parameters:
parameterName
- the parameter namedefaultValue
- the default- Returns:
- the number parameter value
- Throws:
ConversionExecutionException
- when the value could not be converted
-
getRequiredNumber
public <T extends Number> T getRequiredNumber(String parameterName, Class<T> targetType) throws IllegalArgumentException, ConversionExecutionException Description copied from interface:ParameterMap
Returns a number parameter value in the map, throwing an exception if the parameter is not present or could not be converted.- Specified by:
getRequiredNumber
in interfaceParameterMap
- Parameters:
parameterName
- the parameter name- Returns:
- the number parameter value
- Throws:
IllegalArgumentException
- if the parameter is not presentConversionExecutionException
- when the value could not be converted
-
getInteger
Description copied from interface:ParameterMap
Returns an integer parameter value in the map, returningnull
if no value was found.- Specified by:
getInteger
in interfaceParameterMap
- Parameters:
parameterName
- the parameter name- Returns:
- the integer parameter value
- Throws:
ConversionExecutionException
- when the value could not be converted
-
getInteger
public Integer getInteger(String parameterName, Integer defaultValue) throws ConversionExecutionException Description copied from interface:ParameterMap
Returns an integer parameter value in the map, returning the defaultValue if no value was found.- Specified by:
getInteger
in interfaceParameterMap
- Parameters:
parameterName
- the parameter namedefaultValue
- the default- Returns:
- the integer parameter value
- Throws:
ConversionExecutionException
- when the value could not be converted
-
getRequiredInteger
public Integer getRequiredInteger(String parameterName) throws IllegalArgumentException, ConversionExecutionException Description copied from interface:ParameterMap
Returns an integer parameter value in the map, throwing an exception if the parameter is not present or could not be converted.- Specified by:
getRequiredInteger
in interfaceParameterMap
- Parameters:
parameterName
- the parameter name- Returns:
- the integer parameter value
- Throws:
IllegalArgumentException
- if the parameter is not presentConversionExecutionException
- when the value could not be converted
-
getLong
Description copied from interface:ParameterMap
Returns a long parameter value in the map, returningnull
if no value was found.- Specified by:
getLong
in interfaceParameterMap
- Parameters:
parameterName
- the parameter name- Returns:
- the long parameter value
- Throws:
ConversionExecutionException
- when the value could not be converted
-
getLong
Description copied from interface:ParameterMap
Returns a long parameter value in the map, returning the defaultValue if no value was found.- Specified by:
getLong
in interfaceParameterMap
- Parameters:
parameterName
- the parameter namedefaultValue
- the default- Returns:
- the long parameter value
- Throws:
ConversionExecutionException
- when the value could not be converted
-
getRequiredLong
public Long getRequiredLong(String parameterName) throws IllegalArgumentException, ConversionExecutionException Description copied from interface:ParameterMap
Returns a long parameter value in the map, throwing an exception if the parameter is not present or could not be converted.- Specified by:
getRequiredLong
in interfaceParameterMap
- Parameters:
parameterName
- the parameter name- Returns:
- the long parameter value
- Throws:
IllegalArgumentException
- if the parameter is not presentConversionExecutionException
- when the value could not be converted
-
getBoolean
Description copied from interface:ParameterMap
Returns a boolean parameter value in the map, returningnull
if no value was found.- Specified by:
getBoolean
in interfaceParameterMap
- Parameters:
parameterName
- the parameter name- Returns:
- the long parameter value
- Throws:
ConversionExecutionException
- when the value could not be converted
-
getBoolean
public Boolean getBoolean(String parameterName, Boolean defaultValue) throws ConversionExecutionException Description copied from interface:ParameterMap
Returns a boolean parameter value in the map, returning the defaultValue if no value was found.- Specified by:
getBoolean
in interfaceParameterMap
- Parameters:
parameterName
- the parameter namedefaultValue
- the default- Returns:
- the boolean parameter value
- Throws:
ConversionExecutionException
- when the value could not be converted
-
getRequiredBoolean
public Boolean getRequiredBoolean(String parameterName) throws IllegalArgumentException, ConversionExecutionException Description copied from interface:ParameterMap
Returns a boolean parameter value in the map, throwing an exception if the parameter is not present or could not be converted.- Specified by:
getRequiredBoolean
in interfaceParameterMap
- Parameters:
parameterName
- the parameter name- Returns:
- the boolean parameter value
- Throws:
IllegalArgumentException
- if the parameter is not presentConversionExecutionException
- when the value could not be converted
-
getMultipartFile
Description copied from interface:ParameterMap
Get a multi-part file parameter value, returningnull
if no value is found.- Specified by:
getMultipartFile
in interfaceParameterMap
- Parameters:
parameterName
- the parameter name- Returns:
- the multipart file
-
getRequiredMultipartFile
public org.springframework.web.multipart.MultipartFile getRequiredMultipartFile(String parameterName) throws IllegalArgumentException Description copied from interface:ParameterMap
Get the value of a required multipart file parameter.- Specified by:
getRequiredMultipartFile
in interfaceParameterMap
- Parameters:
parameterName
- the name of the parameter- Returns:
- the parameter value
- Throws:
IllegalArgumentException
- when the parameter is not found
-
asAttributeMap
Description copied from interface:ParameterMap
Adapts this parameter map to anAttributeMap
.- Specified by:
asAttributeMap
in interfaceParameterMap
- Returns:
- the underlying map as a unmodifiable attribute map
-
initParameters
Initializes this parameter map.- Parameters:
parameters
- the parameters
-
getMapInternal
Returns the wrapped, modifiable map implementation. -
toString
-