org.adroitlogic.x.utils

Class MapUtils

java.lang.Object

org.adroitlogic.x.utils.MapUtils

public class MapUtils
extends Object

Utility class for handling Java map data structures

Since:

17.01

Author:

Udith Gunaratna

Constructor Summary

Constructors

Constructor and Description
MapUtils()

Method Summary

Modifier and Type	Method and Description
static <K,V> Map<K,V>	cloneMap(Map<K,V> originalMap) Creates a clone of a given Map.
static List<StringPair>	toListOfStringPairs(Map<String,String> sourceMap)
static List<StringTrio>	toListOfStringTrios(Map<String,Map<String,String>> sourceMap)
static <T> Map<String,List<T>>	toMapOfListType(Map<String,List<Object>> map, Class<T> type) Converts a map with String keys and List of Object values to a map with String keys and List of given type of values
static <T> Map<String,T>	toMapOfType(Map<String,Object> map, Class<T> type) Converts a map with String keys and Object values to a map with String keys and type values
static Map<String,List<String>>	toStringListMap(Map<String,List<Object>> map) Converts a map with String keys and List of Object values to a map with String keys and List of String values
static Map<String,String>	toStringValuedMap(Map<String,Object> map) Converts a map with String keys and Object values to a map with String keys and String values

Methods inherited from class java.lang.Object

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

Constructor Detail

MapUtils

public MapUtils()

Method Detail

toStringValuedMap

public static Map<String,String> toStringValuedMap(Map<String,Object> map)

Converts a map with String keys and Object values to a map with String keys and String values

Parameters:

map - the map with String keys and Object values

Returns:

a map with String keys and String values

toMapOfType

public static <T> Map<String,T> toMapOfType(Map<String,Object> map,
                                            Class<T> type)

Converts a map with String keys and Object values to a map with String keys and type values

Type Parameters:

T - the type of the values in the resulting map

Parameters:

map - the map with String keys and Object values

type - the class of the type of the resulting map values

Returns:

a map with String keys and type values

Throws:

IllegalArgumentException - if the any of the values in the map cannot be converted to the given type

toStringListMap

public static Map<String,List<String>> toStringListMap(Map<String,List<Object>> map)

Converts a map with String keys and List of Object values to a map with String keys and List of String values

Parameters:

map - the map with String keys and List of Object values

Returns:

a map with String keys and List of String values

toMapOfListType

public static <T> Map<String,List<T>> toMapOfListType(Map<String,List<Object>> map,
                                                      Class<T> type)

Converts a map with String keys and List of Object values to a map with String keys and List of given type of values

Type Parameters:

T - the type of the resulting values in the List values in the Map

Parameters:

map - the map with String keys and List of Object values

type - the class of the type that the resulting values in the List values of the Map

Returns:

a map with String keys and List of given type of values

Throws:

IllegalArgumentException - if the any of the objects in any of the lists in the map cannot be converted to the given type

toListOfStringPairs

public static List<StringPair> toListOfStringPairs(Map<String,String> sourceMap)

toListOfStringTrios

public static List<StringTrio> toListOfStringTrios(Map<String,Map<String,String>> sourceMap)

cloneMap

public static <K,V> Map<K,V> cloneMap(Map<K,V> originalMap)

Creates a clone of a given Map. The original and cloned maps will refer separate objects for Java immutable entries (keys or values) while both will refer the same objects for mutable objects.

Type Parameters:

K - the type of the entry keys

V - the type of the entry values

Parameters:

originalMap - the map to be cloned

Returns:

new instance of Map with the contents of the original map, or empty map if the original map is null