org.springframework.webflow.core.collection
Interface ParameterMap

All Superinterfaces:

MapAdaptable<java.lang.String,java.lang.Object>

All Known Implementing Classes:

LocalParameterMap, MockParameterMap

public interface ParameterMap
extends MapAdaptable<java.lang.String,java.lang.Object>

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

The accessor methods offered by this class taking a target type argument only need to support conversions to well know types like String, Number subclasses, Boolean and so on.

Author:

Keith Donald

Method Summary

AttributeMap<java.lang.Object>	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.
<T> T	get(java.lang.String parameterName, java.lang.Class<T> targetType) Get a parameter value, converting it from String to the target type.
<T> T	get(java.lang.String parameterName, java.lang.Class<T> targetType, T 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.
<T> T[]	getArray(java.lang.String parameterName, java.lang.Class<T> 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.
<T extends java.lang.Number> T	getNumber(java.lang.String parameterName, java.lang.Class<T> targetType) Returns a number parameter value in the map that is of the specified type, returning null if no value was found.
<T extends java.lang.Number> T	getNumber(java.lang.String parameterName, java.lang.Class<T> targetType, T 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.
<T> T	getRequired(java.lang.String parameterName, java.lang.Class<T> 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.
<T> T[]	getRequiredArray(java.lang.String parameterName, java.lang.Class<T> 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.
<T extends java.lang.Number> T	getRequiredNumber(java.lang.String parameterName, java.lang.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.
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

<T> T[] getArray(java.lang.String parameterName,
                 java.lang.Class<T> targetElementType)
             throws ConversionExecutionException

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:

ConversionExecutionException - when the value could not be converted

get

<T> T get(java.lang.String parameterName,
          java.lang.Class<T> targetType)
      throws ConversionExecutionException

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:

ConversionExecutionException - when the value could not be converted

get

<T> T get(java.lang.String parameterName,
          java.lang.Class<T> targetType,
          T defaultValue)
      throws ConversionExecutionException

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:

ConversionExecutionException - 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

<T> T[] getRequiredArray(java.lang.String parameterName,
                         java.lang.Class<T> targetElementType)
                     throws java.lang.IllegalArgumentException,
                            ConversionExecutionException

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

ConversionExecutionException - when a value could not be converted

getRequired

<T> T getRequired(java.lang.String parameterName,
                  java.lang.Class<T> targetType)
              throws java.lang.IllegalArgumentException,
                     ConversionExecutionException

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

ConversionExecutionException - when the value could not be converted

getNumber

<T extends java.lang.Number> T getNumber(java.lang.String parameterName,
                                         java.lang.Class<T> targetType)
                                     throws ConversionExecutionException

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:

ConversionExecutionException - when the value could not be converted

getNumber

<T extends java.lang.Number> T getNumber(java.lang.String parameterName,
                                         java.lang.Class<T> targetType,
                                         T defaultValue)
                                     throws ConversionExecutionException

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:

ConversionExecutionException - when the value could not be converted

getRequiredNumber

<T extends java.lang.Number> T getRequiredNumber(java.lang.String parameterName,
                                                 java.lang.Class<T> targetType)
                                             throws java.lang.IllegalArgumentException,
                                                    ConversionExecutionException

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

ConversionExecutionException - when the value could not be converted

getInteger

java.lang.Integer getInteger(java.lang.String parameterName)
                             throws ConversionExecutionException

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:

ConversionExecutionException - when the value could not be converted

getInteger

java.lang.Integer getInteger(java.lang.String parameterName,
                             java.lang.Integer defaultValue)
                             throws ConversionExecutionException

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:

ConversionExecutionException - when the value could not be converted

getRequiredInteger

java.lang.Integer getRequiredInteger(java.lang.String parameterName)
                                     throws java.lang.IllegalArgumentException,
                                            ConversionExecutionException

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

ConversionExecutionException - when the value could not be converted

getLong

java.lang.Long getLong(java.lang.String parameterName)
                       throws ConversionExecutionException

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:

ConversionExecutionException - when the value could not be converted

getLong

java.lang.Long getLong(java.lang.String parameterName,
                       java.lang.Long defaultValue)
                       throws ConversionExecutionException

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:

ConversionExecutionException - when the value could not be converted

getRequiredLong

java.lang.Long getRequiredLong(java.lang.String parameterName)
                               throws java.lang.IllegalArgumentException,
                                      ConversionExecutionException

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

ConversionExecutionException - when the value could not be converted

getBoolean

java.lang.Boolean getBoolean(java.lang.String parameterName)
                             throws ConversionExecutionException

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:

ConversionExecutionException - when the value could not be converted

getBoolean

java.lang.Boolean getBoolean(java.lang.String parameterName,
                             java.lang.Boolean defaultValue)
                             throws ConversionExecutionException

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:

ConversionExecutionException - when the value could not be converted

getRequiredBoolean

java.lang.Boolean getRequiredBoolean(java.lang.String parameterName)
                                     throws java.lang.IllegalArgumentException,
                                            ConversionExecutionException

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

ConversionExecutionException - 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<java.lang.Object> asAttributeMap()

Adapts this parameter map to an AttributeMap.

Returns:

the underlying map as a unmodifiable attribute map