org.springframework.webflow.core.collection
Interface ParameterMap

All Superinterfaces:

org.springframework.binding.collection.MapAdaptable

All Known Implementing Classes:

LocalParameterMap, MockParameterMap

public interface ParameterMap
extends org.springframework.binding.collection.MapAdaptable

An interface for accessing parameters in a backing map. Parameters are immutable and have string keys and string values.

Author:

Keith Donald

Method Summary

AttributeMap	asAttributeMap() Adapts this parameter map to an AttributeMap.
boolean	contains(java.lang.String parameterName) Does the parameter with the provided name exist in this map?
java.lang.String	get(java.lang.String parameterName) Get a parameter value, returning null if no value is found.
java.lang.Object	get(java.lang.String parameterName, java.lang.Class targetType) Get a parameter value, converting it from String to the target type.
java.lang.Object	get(java.lang.String parameterName, java.lang.Class targetType, java.lang.Object defaultValue) Get a parameter value, converting it from String to the target type or returning the defaultValue if not found.
java.lang.String	get(java.lang.String parameterName, java.lang.String defaultValue) Get a parameter value, returning the defaultValue if no value is found.
java.lang.String[]	getArray(java.lang.String parameterName) Get a multi-valued parameter value, returning null if no value is found.
java.lang.Object[]	getArray(java.lang.String parameterName, java.lang.Class targetElementType) Get a multi-valued parameter value, converting each value to the target type or returning null if no value is found.
java.lang.Boolean	getBoolean(java.lang.String parameterName) Returns a boolean parameter value in the map, returning null if no value was found.
java.lang.Boolean	getBoolean(java.lang.String parameterName, java.lang.Boolean defaultValue) Returns a boolean parameter value in the map, returning the defaultValue if no value was found.
java.lang.Integer	getInteger(java.lang.String parameterName) Returns an integer parameter value in the map, returning null if no value was found.
java.lang.Integer	getInteger(java.lang.String parameterName, java.lang.Integer defaultValue) Returns an integer parameter value in the map, returning the defaultValue if no value was found.
java.lang.Long	getLong(java.lang.String parameterName) Returns a long parameter value in the map, returning null if no value was found.
java.lang.Long	getLong(java.lang.String parameterName, java.lang.Long defaultValue) Returns a long parameter value in the map, returning the defaultValue if no value was found.
org.springframework.web.multipart.MultipartFile	getMultipartFile(java.lang.String parameterName) Get a multi-part file parameter value, returning null if no value is found.
java.lang.Number	getNumber(java.lang.String parameterName, java.lang.Class targetType) Returns a number parameter value in the map that is of the specified type, returning null if no value was found.
java.lang.Number	getNumber(java.lang.String parameterName, java.lang.Class targetType, java.lang.Number defaultValue) Returns a number parameter value in the map of the specified type, returning the defaultValue if no value was found.
java.lang.String	getRequired(java.lang.String parameterName) Get the value of a required parameter.
java.lang.Object	getRequired(java.lang.String parameterName, java.lang.Class targetType) Get the value of a required parameter and convert it to the target type.
java.lang.String[]	getRequiredArray(java.lang.String parameterName) Get a required multi-valued parameter value.
java.lang.Object[]	getRequiredArray(java.lang.String parameterName, java.lang.Class targetElementType) Get a required multi-valued parameter value, converting each value to the target type.
java.lang.Boolean	getRequiredBoolean(java.lang.String parameterName) Returns a boolean parameter value in the map, throwing an exception if the parameter is not present or could not be converted.
java.lang.Integer	getRequiredInteger(java.lang.String parameterName) Returns an integer parameter value in the map, throwing an exception if the parameter is not present or could not be converted.
java.lang.Long	getRequiredLong(java.lang.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(java.lang.String parameterName) Get the value of a required multipart file parameter.
java.lang.Number	getRequiredNumber(java.lang.String parameterName, java.lang.Class targetType) Returns a number parameter value in the map, throwing an exception if the parameter is not present or could not be converted.
boolean	isEmpty() Is this parameter map empty, with a size of 0?
int	size() Returns the number of parameters in this map.

Methods inherited from interface org.springframework.binding.collection.MapAdaptable

asMap

Method Detail

isEmpty

boolean isEmpty()

Is this parameter map empty, with a size of 0?

Returns:

true if empty, false if not

size

int size()

Returns the number of parameters in this map.

Returns:

the parameter count

contains

boolean contains(java.lang.String parameterName)

Does the parameter with the provided name exist in this map?

Parameters:

parameterName - the parameter name

Returns:

true if so, false otherwise

get

java.lang.String get(java.lang.String parameterName)

Get a parameter value, returning null if no value is found.

Parameters:

parameterName - the parameter name

Returns:

the parameter value

get

java.lang.String get(java.lang.String parameterName,
                     java.lang.String defaultValue)

Get a parameter value, returning the defaultValue if no value is found.

Parameters:

parameterName - the parameter name

defaultValue - the default

Returns:

the parameter value

getArray

java.lang.String[] getArray(java.lang.String parameterName)

Get a multi-valued parameter value, returning null if no value is found. If the parameter is single valued an array with a single element is returned.

Parameters:

parameterName - the parameter name

Returns:

the parameter value array

getArray

java.lang.Object[] getArray(java.lang.String parameterName,
                            java.lang.Class targetElementType)
                            throws org.springframework.binding.convert.ConversionException

Get a multi-valued parameter value, converting each value to the target type or returning null if no value is found.

Parameters:

parameterName - the parameter name

targetElementType - the target type of the array's elements

Returns:

the converterd parameter value array

Throws:

org.springframework.binding.convert.ConversionException - when the value could not be converted

get

java.lang.Object get(java.lang.String parameterName,
                     java.lang.Class targetType)
                     throws org.springframework.binding.convert.ConversionException

Get a parameter value, converting it from String to the target type.

Parameters:

parameterName - the name of the parameter

targetType - the target type of the parameter value

Returns:

the converted parameter value, or null if not found

Throws:

org.springframework.binding.convert.ConversionException - when the value could not be converted

get

java.lang.Object get(java.lang.String parameterName,
                     java.lang.Class targetType,
                     java.lang.Object defaultValue)
                     throws org.springframework.binding.convert.ConversionException

Get a parameter value, converting it from String to the target type or returning the defaultValue if not found.

Parameters:

parameterName - name of the parameter to get

targetType - the target type of the parameter value

defaultValue - the default value

Returns:

the converted parameter value, or the default if not found

Throws:

org.springframework.binding.convert.ConversionException - when a value could not be converted

getRequired

java.lang.String getRequired(java.lang.String parameterName)
                             throws java.lang.IllegalArgumentException

Get the value of a required parameter.

Parameters:

parameterName - the name of the parameter

Returns:

the parameter value

Throws:

java.lang.IllegalArgumentException - when the parameter is not found

getRequiredArray

java.lang.String[] getRequiredArray(java.lang.String parameterName)
                                    throws java.lang.IllegalArgumentException

Get a required multi-valued parameter value.

Parameters:

parameterName - the name of the parameter

Returns:

the parameter value

Throws:

java.lang.IllegalArgumentException - when the parameter is not found

getRequiredArray

java.lang.Object[] getRequiredArray(java.lang.String parameterName,
                                    java.lang.Class targetElementType)
                                    throws java.lang.IllegalArgumentException,
                                           org.springframework.binding.convert.ConversionException

Get a required multi-valued parameter value, converting each value to the target type.

Parameters:

parameterName - the name of the parameter

Returns:

the parameter value

Throws:

java.lang.IllegalArgumentException - when the parameter is not found

org.springframework.binding.convert.ConversionException - when a value could not be converted

getRequired

java.lang.Object getRequired(java.lang.String parameterName,
                             java.lang.Class targetType)
                             throws java.lang.IllegalArgumentException,
                                    org.springframework.binding.convert.ConversionException

Get the value of a required parameter and convert it to the target type.

Parameters:

parameterName - the name of the parameter

targetType - the target type of the parameter value

Returns:

the converted parameter value

Throws:

java.lang.IllegalArgumentException - when the parameter is not found

org.springframework.binding.convert.ConversionException - when the value could not be converted

getNumber

java.lang.Number getNumber(java.lang.String parameterName,
                           java.lang.Class targetType)
                           throws org.springframework.binding.convert.ConversionException

Returns a number parameter value in the map that is of the specified type, returning null if no value was found.

Parameters:

parameterName - the parameter name

targetType - the target number type

Returns:

the number parameter value

Throws:

org.springframework.binding.convert.ConversionException - when the value could not be converted

getNumber

java.lang.Number getNumber(java.lang.String parameterName,
                           java.lang.Class targetType,
                           java.lang.Number defaultValue)
                           throws org.springframework.binding.convert.ConversionException

Returns a number parameter value in the map of the specified type, returning the defaultValue if no value was found.

Parameters:

parameterName - the parameter name

defaultValue - the default

Returns:

the number parameter value

Throws:

org.springframework.binding.convert.ConversionException - when the value could not be converted

getRequiredNumber

java.lang.Number getRequiredNumber(java.lang.String parameterName,
                                   java.lang.Class targetType)
                                   throws java.lang.IllegalArgumentException,
                                          org.springframework.binding.convert.ConversionException

Returns a number parameter value in the map, throwing an exception if the parameter is not present or could not be converted.

Parameters:

parameterName - the parameter name

Returns:

the number parameter value

Throws:

java.lang.IllegalArgumentException - if the parameter is not present

org.springframework.binding.convert.ConversionException - when the value could not be converted

getInteger

java.lang.Integer getInteger(java.lang.String parameterName)
                             throws org.springframework.binding.convert.ConversionException

Returns an integer parameter value in the map, returning null if no value was found.

Parameters:

parameterName - the parameter name

Returns:

the integer parameter value

Throws:

org.springframework.binding.convert.ConversionException - when the value could not be converted

getInteger

java.lang.Integer getInteger(java.lang.String parameterName,
                             java.lang.Integer defaultValue)
                             throws org.springframework.binding.convert.ConversionException

Returns an integer parameter value in the map, returning the defaultValue if no value was found.

Parameters:

parameterName - the parameter name

defaultValue - the default

Returns:

the integer parameter value

Throws:

org.springframework.binding.convert.ConversionException - when the value could not be converted

getRequiredInteger

java.lang.Integer getRequiredInteger(java.lang.String parameterName)
                                     throws java.lang.IllegalArgumentException,
                                            org.springframework.binding.convert.ConversionException

Returns an integer parameter value in the map, throwing an exception if the parameter is not present or could not be converted.

Parameters:

parameterName - the parameter name

Returns:

the integer parameter value

Throws:

java.lang.IllegalArgumentException - if the parameter is not present

org.springframework.binding.convert.ConversionException - when the value could not be converted

getLong

java.lang.Long getLong(java.lang.String parameterName)
                       throws org.springframework.binding.convert.ConversionException

Returns a long parameter value in the map, returning null if no value was found.

Parameters:

parameterName - the parameter name

Returns:

the long parameter value

Throws:

org.springframework.binding.convert.ConversionException - when the value could not be converted

getLong

java.lang.Long getLong(java.lang.String parameterName,
                       java.lang.Long defaultValue)
                       throws org.springframework.binding.convert.ConversionException

Returns a long parameter value in the map, returning the defaultValue if no value was found.

Parameters:

parameterName - the parameter name

defaultValue - the default

Returns:

the long parameter value

Throws:

org.springframework.binding.convert.ConversionException - when the value could not be converted

getRequiredLong

java.lang.Long getRequiredLong(java.lang.String parameterName)
                               throws java.lang.IllegalArgumentException,
                                      org.springframework.binding.convert.ConversionException

Returns a long parameter value in the map, throwing an exception if the parameter is not present or could not be converted.

Parameters:

parameterName - the parameter name

Returns:

the long parameter value

Throws:

java.lang.IllegalArgumentException - if the parameter is not present

org.springframework.binding.convert.ConversionException - when the value could not be converted

getBoolean

java.lang.Boolean getBoolean(java.lang.String parameterName)
                             throws org.springframework.binding.convert.ConversionException

Returns a boolean parameter value in the map, returning null if no value was found.

Parameters:

parameterName - the parameter name

Returns:

the long parameter value

Throws:

org.springframework.binding.convert.ConversionException - when the value could not be converted

getBoolean

java.lang.Boolean getBoolean(java.lang.String parameterName,
                             java.lang.Boolean defaultValue)
                             throws org.springframework.binding.convert.ConversionException

Returns a boolean parameter value in the map, returning the defaultValue if no value was found.

Parameters:

parameterName - the parameter name

defaultValue - the default

Returns:

the boolean parameter value

Throws:

org.springframework.binding.convert.ConversionException - when the value could not be converted

getRequiredBoolean

java.lang.Boolean getRequiredBoolean(java.lang.String parameterName)
                                     throws java.lang.IllegalArgumentException,
                                            org.springframework.binding.convert.ConversionException

Returns a boolean parameter value in the map, throwing an exception if the parameter is not present or could not be converted.

Parameters:

parameterName - the parameter name

Returns:

the boolean parameter value

Throws:

java.lang.IllegalArgumentException - if the parameter is not present

org.springframework.binding.convert.ConversionException - when the value could not be converted

getMultipartFile

org.springframework.web.multipart.MultipartFile getMultipartFile(java.lang.String parameterName)

Get a multi-part file parameter value, returning null if no value is found.

Parameters:

parameterName - the parameter name

Returns:

the multipart file

getRequiredMultipartFile

org.springframework.web.multipart.MultipartFile getRequiredMultipartFile(java.lang.String parameterName)

Get the value of a required multipart file parameter.

Parameters:

parameterName - the name of the parameter

Returns:

the parameter value

Throws:

java.lang.IllegalArgumentException - when the parameter is not found

asAttributeMap

AttributeMap asAttributeMap()

Adapts this parameter map to an AttributeMap.

Returns:

the underlying map as a unmodifiable attribute map