cn.trinea.android.common.util

Class MapUtils

java.lang.Object

cn.trinea.android.common.util.MapUtils

public class MapUtils
extends java.lang.Object

Map Utils

Author:

Trinea 2011-7-22

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DEFAULT_KEY_AND_VALUE_PAIR_SEPARATOR default separator between key-value pairs
static java.lang.String	DEFAULT_KEY_AND_VALUE_SEPARATOR default separator between key and value

Constructor Summary

Constructors

Constructor and Description
MapUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static <K,V> K	getKeyByValue(java.util.Map<K,V> map, V value) get key by value, match the first entry front to back Attentions: for HashMap, the order of entry not same to put order, so you may need to use TreeMap
static <K,V> boolean	isEmpty(java.util.Map<K,V> sourceMap) is null or its size is 0 isEmpty(null) = true; isEmpty({}) = true; isEmpty({1, 2}) = false;
static java.util.Map<java.lang.String,java.lang.String>	parseKeyAndValueToMap(java.lang.String source) parse key-value pairs to map, ignore empty key, ignore space at the begging or end of key and value
static java.util.Map<java.lang.String,java.lang.String>	parseKeyAndValueToMap(java.lang.String source, boolean ignoreSpace) parse key-value pairs to map, ignore empty key
static java.util.Map<java.lang.String,java.lang.String>	parseKeyAndValueToMap(java.lang.String source, java.lang.String keyAndValueSeparator, java.lang.String keyAndValuePairSeparator, boolean ignoreSpace) parse key-value pairs to map, ignore empty key parseKeyAndValueToMap("","","",true)=null parseKeyAndValueToMap(null,"","",true)=null parseKeyAndValueToMap("a:b,:","","",true)={(a,b)} parseKeyAndValueToMap("a:b,:d","","",true)={(a,b)} parseKeyAndValueToMap("a:b,c:d","","",true)={(a,b),(c,d)} parseKeyAndValueToMap("a=b, c = d","=",",",true)={(a,b),(c,d)} parseKeyAndValueToMap("a=b, c = d","=",",",false)={(a, b),( c , d)} parseKeyAndValueToMap("a=b, c=d","=", ",", false)={(a,b),( c,d)} parseKeyAndValueToMap("a=b; c=d","=", ";", false)={(a,b),( c,d)} parseKeyAndValueToMap("a=b, c=d", ",", ";", false)={(a=b, c=d)}
static boolean	putMapNotEmptyKey(java.util.Map<java.lang.String,java.lang.String> map, java.lang.String key, java.lang.String value) add key-value pair to map, and key need not null or empty
static boolean	putMapNotEmptyKeyAndValue(java.util.Map<java.lang.String,java.lang.String> map, java.lang.String key, java.lang.String value) add key-value pair to map, both key and value need not null or empty
static boolean	putMapNotEmptyKeyAndValue(java.util.Map<java.lang.String,java.lang.String> map, java.lang.String key, java.lang.String value, java.lang.String defaultValue) add key-value pair to map, key need not null or empty
static <K,V> boolean	putMapNotNullKey(java.util.Map<K,V> map, K key, V value) add key-value pair to map, key need not null
static <K,V> boolean	putMapNotNullKeyAndValue(java.util.Map<K,V> map, K key, V value) add key-value pair to map, both key and value need not null
static java.lang.String	toJson(java.util.Map<java.lang.String,java.lang.String> map) join map

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_KEY_AND_VALUE_SEPARATOR

public static final java.lang.String DEFAULT_KEY_AND_VALUE_SEPARATOR

default separator between key and value

See Also:

Constant Field Values

DEFAULT_KEY_AND_VALUE_PAIR_SEPARATOR

public static final java.lang.String DEFAULT_KEY_AND_VALUE_PAIR_SEPARATOR

default separator between key-value pairs

See Also:

Constant Field Values

Constructor Detail

MapUtils

public MapUtils()

Method Detail

isEmpty

public static <K,V> boolean isEmpty(java.util.Map<K,V> sourceMap)

is null or its size is 0

 isEmpty(null)   =   true;
 isEmpty({})     =   true;
 isEmpty({1, 2})    =   false;
 

Parameters:

sourceMap -

Returns:

if map is null or its size is 0, return true, else return false.

putMapNotEmptyKey

public static boolean putMapNotEmptyKey(java.util.Map<java.lang.String,java.lang.String> map,
                        java.lang.String key,
                        java.lang.String value)

add key-value pair to map, and key need not null or empty

Parameters:

map -

key -

value -

Returns:

• if map is null, return false
• if key is null or empty, return false
• return Map.put(Object, Object)

putMapNotEmptyKeyAndValue

public static boolean putMapNotEmptyKeyAndValue(java.util.Map<java.lang.String,java.lang.String> map,
                                java.lang.String key,
                                java.lang.String value)

add key-value pair to map, both key and value need not null or empty

Parameters:

map -

key -

value -

Returns:

• if map is null, return false
• if key is null or empty, return false
• if value is null or empty, return false
• return Map.put(Object, Object)

putMapNotEmptyKeyAndValue

public static boolean putMapNotEmptyKeyAndValue(java.util.Map<java.lang.String,java.lang.String> map,
                                java.lang.String key,
                                java.lang.String value,
                                java.lang.String defaultValue)

add key-value pair to map, key need not null or empty

Parameters:

map -

key -

value -

defaultValue -

Returns:

• if map is null, return false
• if key is null or empty, return false
• if value is null or empty, put defaultValue, return true
• if value is neither null nor empty，put value, return true

putMapNotNullKey

public static <K,V> boolean putMapNotNullKey(java.util.Map<K,V> map,
                             K key,
                             V value)

add key-value pair to map, key need not null

Parameters:

map -

key -

value -

Returns:

• if map is null, return false
• if key is null, return false
• return Map.put(Object, Object)

putMapNotNullKeyAndValue

public static <K,V> boolean putMapNotNullKeyAndValue(java.util.Map<K,V> map,
                                     K key,
                                     V value)

add key-value pair to map, both key and value need not null

Parameters:

map -

key -

value -

Returns:

• if map is null, return false
• if key is null, return false
• if value is null, return false
• return Map.put(Object, Object)

getKeyByValue

public static <K,V> K getKeyByValue(java.util.Map<K,V> map,
                    V value)

get key by value, match the first entry front to back

Attentions:
• for HashMap, the order of entry not same to put order, so you may need to use TreeMap

Type Parameters:

V -

Parameters:

map -

value -

Returns:

• if map is null, return null
• if value exist, return key
• return null

parseKeyAndValueToMap

public static java.util.Map<java.lang.String,java.lang.String> parseKeyAndValueToMap(java.lang.String source,
                                                                     java.lang.String keyAndValueSeparator,
                                                                     java.lang.String keyAndValuePairSeparator,
                                                                     boolean ignoreSpace)

parse key-value pairs to map, ignore empty key

 parseKeyAndValueToMap("","","",true)=null
 parseKeyAndValueToMap(null,"","",true)=null
 parseKeyAndValueToMap("a:b,:","","",true)={(a,b)}
 parseKeyAndValueToMap("a:b,:d","","",true)={(a,b)}
 parseKeyAndValueToMap("a:b,c:d","","",true)={(a,b),(c,d)}
 parseKeyAndValueToMap("a=b, c = d","=",",",true)={(a,b),(c,d)}
 parseKeyAndValueToMap("a=b, c = d","=",",",false)={(a, b),( c , d)}
 parseKeyAndValueToMap("a=b, c=d","=", ",", false)={(a,b),( c,d)}
 parseKeyAndValueToMap("a=b; c=d","=", ";", false)={(a,b),( c,d)}
 parseKeyAndValueToMap("a=b, c=d", ",", ";", false)={(a=b, c=d)}
 

Parameters:

source - key-value pairs

keyAndValueSeparator - separator between key and value

keyAndValuePairSeparator - separator between key-value pairs

ignoreSpace - whether ignore space at the begging or end of key and value

Returns:

parseKeyAndValueToMap

public static java.util.Map<java.lang.String,java.lang.String> parseKeyAndValueToMap(java.lang.String source,
                                                                     boolean ignoreSpace)

parse key-value pairs to map, ignore empty key

Parameters:

source - key-value pairs

ignoreSpace - whether ignore space at the begging or end of key and value

Returns:

See Also:

MapUtils#parseKeyAndValueToMap(String, String, String, boolean)}, keyAndValueSeparator is {@link #DEFAULT_KEY_AND_VALUE_SEPARATOR}, keyAndValuePairSeparator is {@link #DEFAULT_KEY_AND_VALUE_PAIR_SEPARATOR}

parseKeyAndValueToMap

public static java.util.Map<java.lang.String,java.lang.String> parseKeyAndValueToMap(java.lang.String source)

parse key-value pairs to map, ignore empty key, ignore space at the begging or end of key and value

Parameters:

source - key-value pairs

Returns:

See Also:

MapUtils#parseKeyAndValueToMap(String, String, String, boolean)}, keyAndValueSeparator is {@link #DEFAULT_KEY_AND_VALUE_SEPARATOR}, keyAndValuePairSeparator is {@link #DEFAULT_KEY_AND_VALUE_PAIR_SEPARATOR}, ignoreSpace is true

toJson

public static java.lang.String toJson(java.util.Map<java.lang.String,java.lang.String> map)

join map

Parameters:

map -

Returns: