io.axual.common.tools

Class MapUtil

java.lang.Object

io.axual.common.tools.MapUtil

public class MapUtil
extends java.lang.Object

Class with generic Map helper methods.

Method Summary

Modifier and Type	Method and Description
static <K,V> MapBuilder<K,V>	builder()
static <K,V> MapBuilder<K,V>	builder(java.util.Map<K,V> initialMap)
static java.util.Properties	mapToProperties(java.util.Map<?,?> map) Convert a generic map to a Properties object.
static <V> java.util.Map<java.lang.String,V>	objectToStringMap(java.util.Map<java.lang.Object,V> map) Filter a map with Object keys.
static <V> java.util.Map<java.lang.String,V>	prefixItems(java.util.Map<java.lang.String,V> map, java.lang.String prefix) Apply a given prefix to all String keys in a map.
static <K,V> java.util.Map<K,V>	put(java.util.Map<K,V> source, K key, V value)
static <K,V> java.util.Map<K,V>	putAllIfAbsent(java.util.Map<K,V> target, java.util.Map<? extends K,? extends V> source)
static <K,V> java.util.Map<K,V>	putIfAbsent(java.util.Map<K,V> target, K key, V value)
static <V> java.util.Map<java.lang.Object,V>	stringMapToObjectMap(java.util.Map<java.lang.String,V> map) Convert a map with String keys to a generic map with Object keys.
static <K> java.lang.String	stringValue(java.util.Map<K,?> map, K key) Return the String value of given key from a given map.
static <K> java.lang.String	stringValue(java.util.Map<K,?> map, K key, java.lang.String defaultValue) Return the String value of given key from a given map.
static <K> java.util.Map<K,java.lang.String>	stringValues(java.util.Map<K,?> map) Convert a map with any type of values to a map with only String values.
static <V> java.util.Map<java.lang.String,V>	unprefixItems(java.util.Map<java.lang.String,V> map, java.lang.String prefix)

Methods inherited from class java.lang.Object

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

Method Detail

builder

public static <K,V> MapBuilder<K,V> builder()

builder

public static <K,V> MapBuilder<K,V> builder(java.util.Map<K,V> initialMap)

objectToStringMap

public static <V> java.util.Map<java.lang.String,V> objectToStringMap(java.util.Map<java.lang.Object,V> map)

Filter a map with Object keys. The result is the same map but with only the keys of type String.

Type Parameters:

V - the value type of the map

Parameters:

map - the input map with Object keys

Returns:

the output map containing only String keys

stringMapToObjectMap

public static <V> java.util.Map<java.lang.Object,V> stringMapToObjectMap(java.util.Map<java.lang.String,V> map)

Convert a map with String keys to a generic map with Object keys.

Type Parameters:

V - the value type of the map

Parameters:

map - the input map with String keys

Returns:

the output map with Object keys

mapToProperties

public static java.util.Properties mapToProperties(java.util.Map<?,?> map)

Convert a generic map to a Properties object.

Parameters:

map - the input map

Returns:

the output properties

prefixItems

public static <V> java.util.Map<java.lang.String,V> prefixItems(java.util.Map<java.lang.String,V> map,
                                                                java.lang.String prefix)

Apply a given prefix to all String keys in a map.

Type Parameters:

V - the value type of the map

Parameters:

map - the input map with String keys

prefix - the prefix to apply to every key

Returns:

the output map with all prefixed keys

unprefixItems

public static <V> java.util.Map<java.lang.String,V> unprefixItems(java.util.Map<java.lang.String,V> map,
                                                                  java.lang.String prefix)

stringValues

public static <K> java.util.Map<K,java.lang.String> stringValues(java.util.Map<K,?> map)

Convert a map with any type of values to a map with only String values.

Type Parameters:

K - the key type of the map

Parameters:

map - the input map with any type of values

Returns:

the output map with String values

stringValue

public static <K> java.lang.String stringValue(java.util.Map<K,?> map,
                                               K key)

Return the String value of given key from a given map.

Type Parameters:

K - the key type of the map

Parameters:

map - the input map with given key

key - the key to look up

Returns:

the string value found in the map at given key, or null if no String value found

stringValue

public static <K> java.lang.String stringValue(java.util.Map<K,?> map,
                                               K key,
                                               java.lang.String defaultValue)

Return the String value of given key from a given map.

Type Parameters:

K - the key type of the map

Parameters:

map - the input map with given key

key - the key to look up

defaultValue - the default value to return if no String value found for given key

Returns:

the string value found, or defaultValue if no String value found

putIfAbsent

public static <K,V> java.util.Map<K,V> putIfAbsent(java.util.Map<K,V> target,
                                                   K key,
                                                   V value)

putAllIfAbsent

public static <K,V> java.util.Map<K,V> putAllIfAbsent(java.util.Map<K,V> target,
                                                      java.util.Map<? extends K,? extends V> source)

put

public static <K,V> java.util.Map<K,V> put(java.util.Map<K,V> source,
                                           K key,
                                           V value)