Package net.sf.jstuff.core.collection

Class Maps

java.lang.Object

net.sf.jstuff.core.collection.Maps

public abstract class Maps
extends Object

Author:

Sebastian Thomschke

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Maps.MapDiff<K,V>

Constructor Summary

Constructors

Constructor	Description
Maps()

Method Summary

Modifier and Type	Method	Description
static <K, V> Maps.MapDiff<K,V>	diff(Map<K,V> leftMap, Map<K,V> rightMap)
static <K, V> Maps.MapDiff<K,V>	diff(Map<K,V> leftMap, Map<K,V> rightMap, IsEqual<? super V> isEqual)
static <K, V> V	get(@Nullable Map<K,V> map, K key, V defaultValue)
static <K, V> V	getOrThrow(Map<K,V> map, K key)
static <K, V> ArrayList<K>	keysAsArrayList(Map<K,V> map)
static <K, V> CharSequence	map2string(Map<K,V> values, String valueSeparator, String assignmentOperator)	Returns string in the format of "name1=value1,name2=value2" (if valueSeparator="," and assignmentOperator="=") Opposite to toMap(String, String, String)
static <K, V> HashMap<K,V>	newHashMap()
static <K, V> HashMap<K,V>	newHashMap(int initialSize)
static <K, V> HashMap<K,V>	newHashMap(@Nullable Map<? extends K,? extends V> initialValues)
static <K, V> HashMap<K,V>	newHashMap(Object @Nullable [] initialKeysAndValues)
static <K, V, KK extends K, VV extends V> HashMap<K,V>	newHashMap(KK firstKey, VV firstValue, Object... moreInitialKeysAndValues)
static <K, V> LinkedHashMap<K,V>	newLinkedHashMap()
static <K, V> LinkedHashMap<K,V>	newLinkedHashMap(int initialSize)
static <K, V> LinkedHashMap<K,V>	newLinkedHashMap(Object @Nullable [] initialKeysAndValues)
static <K, V, KK extends K, VV extends V> LinkedHashMap<K,V>	newLinkedHashMap(KK firstKey, VV firstValue, Object... moreInitialKeysAndValues)
static <K, V> ThreadLocal<HashMap<K,V>>	newThreadLocalHashMap()
static <K, V> ThreadLocal<WeakHashMap<K,V>>	newThreadLocalWeakHashMap()
static <K, V> TreeMap<K,V>	newTreeMap()
static <K, V> TreeMap<K,V>	newTreeMap(Comparator<? super K> keyComparator)
static <K, V> TreeMap<K,V>	newTreeMap(Comparator<? super K> keyComparator, Object @Nullable [] initialKeysAndValues)
static <K, V, KK extends K, VV extends V> TreeMap<K,V>	newTreeMap(Comparator<? super K> keyComparator, KK firstKey, VV firstValue, Object... moreInitialKeysAndValues)
static <K, V, KK extends K, VV extends V> TreeMap<K,V>	newTreeMap(KK firstKey, VV firstValue, Object... moreInitialKeysAndValues)
static <K, V, M extends Map<K, V>> M	putAll(M map, Object @Nullable [] keysAndValues)
static <K, V, M extends Map<K, V>> M	putAll(M map, K[] keys, V[] values)
static <K, V, KK extends K, VV extends V, M extends Map<K, V>> M	putAll(M map, KK firstKey, VV firstValue, Object... moreKeysAndValues)
static <K, V> Map<K,V>	putAllIfAbsent(Map<K,V> map, Map<? extends K,? extends V> entriesToAdd)
static <K, V, M extends Map<K, V>> M	putAllIfAbsent(M map, Object @Nullable [] keysAndValues)
static <K, V, M extends Map<K, V>> M	putAllIfAbsent(M map, K[] keys, V[] values)
static <K, V, KK extends K, VV extends V, M extends Map<K, V>> M	putAllIfAbsent(M map, KK firstKey, VV firstValue, Object... moreKeysAndValues)
static <KK, V> Map<KK,V>	remap(Map<?,V> map, Function<V,KK> keyMapper)
static <KK, V, VV> Map<KK,VV>	remap(Map<?,V> map, Function<V,KK> keyMapper, Function<V,VV> valueMapper)
static <K, KK, V> Map<KK,V>	remap(Map<K,V> map, BiFunction<K,V,KK> keyMapper)
static <K, KK, V, VV> Map<KK,VV>	remap(Map<K,V> map, BiFunction<K,V,KK> keyMapper, BiFunction<K,V,VV> valueMapper)
static <K, V extends Comparable<V>> @NonNull Map<K,V>	sortByValue(@NonNull Map<K,V> map)
static <K, V extends Comparable<V>> @NonNull Map<K,V>	sortByValue(@NonNull Map<K,V> map, @NonNull SortDirection direction)
static <K, V> Map<K,V>	sortByValue(Map<K,V> map, Comparator<V> comparator)
static Map<String,String>	toMap(String valuePairs, String valueSeparator, String assignmentOperator)	Converts key/value pairs defined in a string into a map.
static <T> Map<T,T>	toMap(T... keysAndValues)

Methods inherited from class java.lang.Object

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

Constructor Details

Maps

public Maps()

Method Details

diff

public static <K,
V> Maps.MapDiff<K,V> diff(Map<K,V> leftMap,
 Map<K,V> rightMap)

diff

public static <K,
V> Maps.MapDiff<K,V> diff(Map<K,V> leftMap,
 Map<K,V> rightMap,
 IsEqual<? super V> isEqual)

get

public static <K,
V> V get(@Nullable Map<K,V> map,
 K key,
 V defaultValue)

getOrThrow

public static <K,
V> V getOrThrow(Map<K,V> map,
 K key)
                          throws NoSuchElementException

Throws:

NoSuchElementException

keysAsArrayList

public static <K,
V> ArrayList<K> keysAsArrayList(Map<K,V> map)

map2string

public static <K,
V> CharSequence map2string(Map<K,V> values,
 String valueSeparator,
 String assignmentOperator)

Returns string in the format of "name1=value1,name2=value2" (if valueSeparator="," and assignmentOperator="=") Opposite to toMap(String, String, String)

newHashMap

public static <K,
V> HashMap<K,V> newHashMap()

newHashMap

public static <K,
V> HashMap<K,V> newHashMap(int initialSize)

newHashMap

public static <K,
V,
KK extends K,
VV extends V>
HashMap<K,V> newHashMap(KK firstKey,
 VV firstValue,
 Object... moreInitialKeysAndValues)

newHashMap

public static <K,
V> HashMap<K,V> newHashMap(@Nullable Map<? extends K,? extends V> initialValues)

newHashMap

public static <K,
V> HashMap<K,V> newHashMap(Object @Nullable [] initialKeysAndValues)

newLinkedHashMap

public static <K,
V> LinkedHashMap<K,V> newLinkedHashMap()

newLinkedHashMap

public static <K,
V> LinkedHashMap<K,V> newLinkedHashMap(int initialSize)

newLinkedHashMap

public static <K,
V,
KK extends K,
VV extends V>
LinkedHashMap<K,V> newLinkedHashMap(KK firstKey,
 VV firstValue,
 Object... moreInitialKeysAndValues)

newLinkedHashMap

public static <K,
V> LinkedHashMap<K,V> newLinkedHashMap(Object @Nullable [] initialKeysAndValues)

newThreadLocalHashMap

public static <K,
V> ThreadLocal<HashMap<K,V>> newThreadLocalHashMap()

newThreadLocalWeakHashMap

public static <K,
V> ThreadLocal<WeakHashMap<K,V>> newThreadLocalWeakHashMap()

newTreeMap

public static <K,
V> TreeMap<K,V> newTreeMap()

newTreeMap

public static <K,
V> TreeMap<K,V> newTreeMap(Comparator<? super K> keyComparator)

newTreeMap

public static <K,
V,
KK extends K,
VV extends V>
TreeMap<K,V> newTreeMap(Comparator<? super K> keyComparator,
 KK firstKey,
 VV firstValue,
 Object... moreInitialKeysAndValues)

newTreeMap

public static <K,
V> TreeMap<K,V> newTreeMap(Comparator<? super K> keyComparator,
 Object @Nullable [] initialKeysAndValues)

newTreeMap

public static <K,
V,
KK extends K,
VV extends V>
TreeMap<K,V> newTreeMap(KK firstKey,
 VV firstValue,
 Object... moreInitialKeysAndValues)

putAll

public static <K,
V,
M extends Map<K,
V>> M putAll(M map,
 K[] keys,
 V[] values)

putAll

public static <K,
V,
KK extends K,
VV extends V,
M extends Map<K,
V>>
M putAll(M map,
 KK firstKey,
 VV firstValue,
 Object... moreKeysAndValues)

putAll

public static <K,
V,
M extends Map<K,
V>> M putAll(M map,
 Object @Nullable [] keysAndValues)

putAllIfAbsent

public static <K,
V> Map<K,V> putAllIfAbsent(Map<K,V> map,
 Map<? extends K,? extends V> entriesToAdd)

putAllIfAbsent

public static <K,
V,
M extends Map<K,
V>> M putAllIfAbsent(M map,
 K[] keys,
 V[] values)

putAllIfAbsent

public static <K,
V,
KK extends K,
VV extends V,
M extends Map<K,
V>>
M putAllIfAbsent(M map,
 KK firstKey,
 VV firstValue,
 Object... moreKeysAndValues)

putAllIfAbsent

public static <K,
V,
M extends Map<K,
V>> M putAllIfAbsent(M map,
 Object @Nullable [] keysAndValues)

remap

public static <KK,
V> Map<KK,V> remap(Map<?,V> map,
 Function<V,KK> keyMapper)

remap

public static <KK,
V,
VV> Map<KK,VV> remap(Map<?,V> map,
 Function<V,KK> keyMapper,
 Function<V,VV> valueMapper)

remap

public static <K,
KK,
V> Map<KK,V> remap(Map<K,V> map,
 BiFunction<K,V,KK> keyMapper)

remap

public static <K,
KK,
V,
VV> Map<KK,VV> remap(Map<K,V> map,
 BiFunction<K,V,KK> keyMapper,
 BiFunction<K,V,VV> valueMapper)

sortByValue

@NonNullByDefault({})
public static <K,
V extends Comparable<V>>
@NonNull Map<K,V> sortByValue(@NonNull Map<K,V> map)

sortByValue

public static <K,
V> Map<K,V> sortByValue(Map<K,V> map,
 Comparator<V> comparator)

sortByValue

@NonNullByDefault({})
public static <K,
V extends Comparable<V>>
@NonNull Map<K,V> sortByValue(@NonNull Map<K,V> map,
 @NonNull SortDirection direction)

toMap

public static Map<String,String> toMap(String valuePairs,
 String valueSeparator,
 String assignmentOperator)

Converts key/value pairs defined in a string into a map. E.g. toMap("name1=value1,name2=value2", "\"", "=")

toMap

@SafeVarargs
public static <T> Map<T,T> toMap(T... keysAndValues)