lumis.util.collections

Class Maps

java.lang.Object

lumis.util.collections.Maps

public abstract class Maps
extends Object

Provides utility methods for maps.

Since:

8.2.0

Version:

$Revision: 19766 $ $Date: 2017-01-05 20:35:09 +0000 (Thu, 05 Jan 2017) $

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Maps.IMapBuilder<K,V> Map builder.

Method Summary

Modifier and Type	Method and Description
static <K,V> Maps.IMapBuilder<K,V>	builder() Returns a new map builder.
static <K,V> Map.Entry<K,V>	entryOf(K key, V value) Returns a new map entry of the given key-value pair.
static <K,V> Map<K,V>	singleEntry(K key, V value) Returns a single-entry map, containing the given key-value pair.
static <K,V> String	stringify(Map<K,V> map, String separator, IStringify<Map.Entry<K,V>> stringify) Creates a string representation of the given map, using its entries as values.
static <K,V> String	stringify(Map<K,V> map, String prefix, String suffix, boolean includePrefixAndSuffixOnlyIfMapNotEmpty, String separator, IStringify<Map.Entry<K,V>> stringify) Creates a string representation of the given map, using its entries as values.
static <K,V> String	stringify(Map<K,V> map, String prefix, String suffix, String separator, IStringify<Map.Entry<K,V>> stringify) Creates a string representation of the given map, using its entries as values.

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> Maps.IMapBuilder<K,V> builder()

Returns a new map builder.

Returns:

a new map builder.

Since:

8.2.0

stringify

public static <K,V> String stringify(Map<K,V> map,
                                     String separator,
                                     IStringify<Map.Entry<K,V>> stringify)
                              throws PortalException

Creates a string representation of the given map, using its entries as values. By convention, does not check whether the given stringify has returned null before concatenating to the result string.

Parameters:

map - the map.

separator - the separator to use between the entries of the map.

stringify - the stringfy to be used to convert entries in strings.

Returns:

the created string.

Throws:

PortalException

Since:

9.0.0

stringify

public static <K,V> String stringify(Map<K,V> map,
                                     String prefix,
                                     String suffix,
                                     String separator,
                                     IStringify<Map.Entry<K,V>> stringify)
                              throws PortalException

Creates a string representation of the given map, using its entries as values. By convention, does not check whether the given stringify has returned null before concatenating to the result string.

Parameters:

map - the map.

prefix - the prefix to be appended in final string.

suffix - the suffix to be appended in final string.

separator - the separator to use between the entries of the map.

stringify - the stringfy to be used to convert entries in strings.

Returns:

the created string.

Throws:

PortalException

Since:

9.0.0

stringify

public static <K,V> String stringify(Map<K,V> map,
                                     String prefix,
                                     String suffix,
                                     boolean includePrefixAndSuffixOnlyIfMapNotEmpty,
                                     String separator,
                                     IStringify<Map.Entry<K,V>> stringify)
                              throws PortalException

Creates a string representation of the given map, using its entries as values. By convention, does not check whether the given stringify has returned null before concatenating to the result string.

Parameters:

map - the map.

prefix - the prefix to be appended in final string.

suffix - the suffix to be appended in final string.

includePrefixAndSuffixOnlyIfMapNotEmpty - indicates whether prefix and suffix should be added only if the given collection is not empty.

separator - the separator to use between the entries of the map.

stringify - the stringfy to be used to convert entries in strings.

Returns:

the created string.

Throws:

PortalException

Since:

9.0.0

singleEntry

public static <K,V> Map<K,V> singleEntry(K key,
                                         V value)

Returns a single-entry map, containing the given key-value pair.

Parameters:

key - the key

value - the value

Returns:

a single-entry map, containing the given key-value pair.

Since:

9.0.0

entryOf

public static <K,V> Map.Entry<K,V> entryOf(K key,
                                           V value)

Returns a new map entry of the given key-value pair.

Parameters:

key - the key.

value - the value.

Returns:

a new map entry of the given key-value pair.

Since:

10.0.0