org.jasig.services.persondir.support

Class MultivaluedPersonAttributeUtils

java.lang.Object

org.jasig.services.persondir.support.MultivaluedPersonAttributeUtils

public final class MultivaluedPersonAttributeUtils
extends Object

Since:

uPortal 2.5

Version:

$Revision$ $Date$

Author:

Eric Dalquist

Method Summary

Modifier and Type	Method and Description
static <K,V> void	addResult(Map<K,List<V>> results, K key, Object value) Adds a key/value pair to the specified Map, creating multi-valued values when appropriate.
static <T> Collection<T>	flattenCollection(Collection<? extends Object> source) Takes a Collection and creates a flattened Collection out of it.
static Map<String,Set<String>>	parseAttributeToAttributeMapping(Map<String,? extends Object> mapping) Translate from a more flexible Attribute to Attribute mapping format to a Map from String to Set of Strings.
static Map<String,List<Object>>	toMultivaluedMap(Map<String,Object> seed) Convert the <String, Object> map to a <String, List<Object>> map by simply wrapping each value in a singleton (read-only) List

Methods inherited from class java.lang.Object

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

Method Detail

parseAttributeToAttributeMapping

public static Map<String,Set<String>> parseAttributeToAttributeMapping(Map<String,? extends Object> mapping)

Translate from a more flexible Attribute to Attribute mapping format to a Map from String to Set of Strings. The point of the map is to map from attribute names in the underlying data store (e.g., JDBC column names, LDAP attribute names) to uPortal attribute names. Any given underlying data store attribute might map to zero uPortal attributes (not appear in the map at all), map to exactly one uPortal attribute (appear in the Map as a mapping from a String to a String or as a mapping from a String to a Set containing just one String), or map to several uPortal attribute names (appear in the Map as a mapping from a String to a Set of Strings). This method takes as its argument a Map that must have keys of type String and values of type String or Set of Strings. The argument must not be null and must have no null keys. It must contain no keys other than Strings and no values other than Strings or Sets of Strings. This method will convert any non-string values to a String using the object's toString() method. This method returns a Map equivalent to its argument except whereever there was a String value in the Map there will instead be an immutable Set containing the String value. That is, the return value is normalized to be a Map from String to Set (of String).

Parameters:

mapping - Map from String names of attributes in the underlying store to uP attribute names or Sets of such names.

Returns:

a Map from String to Set of Strings

addResult

public static <K,V> void addResult(Map<K,List<V>> results,
                                   K key,
                                   Object value)

Adds a key/value pair to the specified Map, creating multi-valued values when appropriate.
Since multi-valued attributes end up with a value of type List, passing in a List of any type will cause its contents to be added to the results Map directly under the specified key

Type Parameters:

K - Key type (extends Object)

V - Value type (extends Object)

Parameters:

results - The Map to modify.

key - The key to add the value for.

value - The value to add for the key.

Throws:

IllegalArgumentException - if any argument is null

flattenCollection

public static <T> Collection<T> flattenCollection(Collection<? extends Object> source)

Takes a Collection and creates a flattened Collection out of it.

Type Parameters:

T - Type of collection (extends Object)

Parameters:

source - The Collection to flatten.

Returns:

A flattened Collection that contains all entries from all levels of source.

toMultivaluedMap

public static Map<String,List<Object>> toMultivaluedMap(Map<String,Object> seed)

Convert the <String, Object> map to a <String, List<Object>> map by simply wrapping each value in a singleton (read-only) List

Parameters:

seed - Map of objects

Returns:

Map where each value is a List with the value in it