org.gatein.common.util

Class ParameterMap

java.lang.Object

org.gatein.common.util.AbstractTypedMap<String,String[],String,String[]>

org.gatein.common.util.ParameterMap

All Implemented Interfaces:

Serializable, Map<String,String[]>

public final class ParameterMap
extends AbstractTypedMap<String,String[],String,String[]>
implements Serializable

A decorator that enforce the map content to be . It also provides capabilities for making a copy of the value either on a read or on a write.

Version:

$Revision: 6671 $

Author:

Julien Viet

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ParameterMap.AccessMode Defines how the state of the values of a parameter map are managed.

Nested classes/interfaces inherited from class org.gatein.common.util.AbstractTypedMap

AbstractTypedMap.Converter<E,I>

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Constructor Summary

Constructors

Constructor and Description
ParameterMap()
ParameterMap(Map<String,String[]> delegate)
ParameterMap(Map<String,String[]> delegate, ParameterMap.AccessMode accessMode)
ParameterMap(ParameterMap.AccessMode accessMode)

Method Summary

Methods

Modifier and Type	Method and Description
void	append(Map<String,String[]> params) Append the content of the argument map to that map.
ParameterMap	as(ParameterMap.AccessMode accessMode)
static ParameterMap	clone(Map<String,String[]> map) Copy the parameter map.
static ParameterMap	clone(Map<String,String[]> map, ParameterMap.AccessMode accessMode) Copy the parameter map.
ParameterMap.AccessMode	getAccessMode()
protected Map<String,String[]>	getDelegate()
AbstractTypedMap.Converter<String,String>	getKeyConverter()
String	getValue(String name) Return the parameter value or null if it does not exist.
AbstractTypedMap.Converter<String[],String[]>	getValueConverter()
String[]	getValues(String name) Return the parameter values or null if it does not exist.
void	setValue(String name, String value) Set the a parameter value.
void	setValues(String name, String[] values) Set the parameter values.
String	toString()
static ParameterMap	wrap(Map<String,String[]> map) Safely wrap the map as a portlet parameters object.
static ParameterMap	wrap(Map<String,String[]> map, ParameterMap.AccessMode accessMode) Safely wrap the map as a portlet parameters object.

Methods inherited from class org.gatein.common.util.AbstractTypedMap

clear, containsKey, containsValue, convert, entrySet, equals, get, isEmpty, keySet, put, putAll, remove, replace, size, validate, values

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map

hashCode

Constructor Detail

ParameterMap

public ParameterMap()

ParameterMap

public ParameterMap(ParameterMap.AccessMode accessMode)

ParameterMap

public ParameterMap(Map<String,String[]> delegate)

ParameterMap

public ParameterMap(Map<String,String[]> delegate,
            ParameterMap.AccessMode accessMode)

Method Detail

clone

public static ParameterMap clone(Map<String,String[]> map)
                          throws NullPointerException,
                                 ClassCastException,
                                 IllegalArgumentException

Copy the parameter map.

Parameters:

map - the parameter map to copy

Returns:

a parameter map initialized from the argument map

Throws:

NullPointerException - if the map contains a null key or a null value

IllegalArgumentException - if the map is null or it contains a value with a zero length array or a null element in the array

ClassCastException - if the map contains a key that is not a string or a value that is not a string array

clone

public static ParameterMap clone(Map<String,String[]> map,
                 ParameterMap.AccessMode accessMode)
                          throws NullPointerException,
                                 ClassCastException,
                                 IllegalArgumentException

Copy the parameter map.

Parameters:

map - the parameter map to copy

accessMode - the access mode

Returns:

a parameter map initialized from the argument map

Throws:

NullPointerException - if the map contains a null key or a null value

IllegalArgumentException - if the map is null or it contains a value with a zero length array or a null element in the array

ClassCastException - if the map contains a key that is not a string or a value that is not a string array

wrap

public static ParameterMap wrap(Map<String,String[]> map)

Safely wrap the map as a portlet parameters object. If the map is already a parameter map object, just return that object otherwise return a wrapper around the map.

Parameters:

map - the map

Returns:

the portlet parameters

wrap

public static ParameterMap wrap(Map<String,String[]> map,
                ParameterMap.AccessMode accessMode)

Safely wrap the map as a portlet parameters object. If the map is already a parameter map object, just return that object with the new access mode otherwise return a wrapper around the map.

Parameters:

map - the map

accessMode - the access mode

Returns:

the portlet parameters

getAccessMode

public ParameterMap.AccessMode getAccessMode()

as

public ParameterMap as(ParameterMap.AccessMode accessMode)

getKeyConverter

public AbstractTypedMap.Converter<String,String> getKeyConverter()

Specified by:

getKeyConverter in class AbstractTypedMap<String,String[],String,String[]>

getValueConverter

public AbstractTypedMap.Converter<String[],String[]> getValueConverter()

Specified by:

getValueConverter in class AbstractTypedMap<String,String[],String,String[]>

getDelegate

protected Map<String,String[]> getDelegate()

Specified by:

getDelegate in class AbstractTypedMap<String,String[],String,String[]>

getValue

public String getValue(String name)
                throws IllegalArgumentException

Return the parameter value or null if it does not exist.

Parameters:

name - the parameter name

Returns:

the parameter value or null if it does not exist

Throws:

IllegalArgumentException - if the name is null

getValues

public String[] getValues(String name)
                   throws IllegalArgumentException

Return the parameter values or null if it does not exist.

Parameters:

name - the value to get

Returns:

the parameter values

Throws:

IllegalArgumentException - if the name is null

setValue

public void setValue(String name,
            String value)
              throws IllegalArgumentException

Set the a parameter value.

Parameters:

name - the parameter name

value - the parameter value

Throws:

IllegalArgumentException - if the name or the value is null

setValues

public void setValues(String name,
             String[] values)
               throws IllegalArgumentException

Set the parameter values. This method does not make a defensive copy of the values.

Parameters:

name - the parameter name

values - the parameter values

Throws:

NullPointerException - if the name or the value is null

IllegalArgumentException - if the name is null or the values is null or the values length is zero or contains a null element

append

public void append(Map<String,String[]> params)
            throws ClassCastException,
                   NullPointerException,
                   IllegalArgumentException

Append the content of the argument map to that map. If both maps contains an entry sharing the same key, then the string arrays or the two entries will be concatenated into a single array. Each entry present on the argument map and not in the current map will be kept as is. The argument validation is performed before the state is updated.

Parameters:

params - the parameters to appends

Throws:

NullPointerException - if the map contains a null key or a null value

IllegalArgumentException - if the map is null or it contains a value with a zero length array or a null element in the array

ClassCastException - if the map contains a key that is not a string or a value that is not a string array

toString

public String toString()

Overrides:

toString in class AbstractTypedMap<String,String[],String,String[]>