Class MapUtil
java.lang.Object
com.sure.tool.collection.MapUtil
Map 工具类,参考 Hutool 的
MapUtil 设计。
English: Map construction and lookup helpers with typed getters and null-safe operations.
- Since:
- 0.1.0
- Author:
- suretool
-
Nested Class Summary
Nested Classes -
Method Summary
Modifier and TypeMethodDescriptionstatic <K,V> Map <K, V> 集合→映射视图(对齐 GuavaMaps.asMap)。static <K,V> MapUtil.MapBuilder <K, V> builder()创建 Map 链式构建器(默认 LinkedHashMap 保持插入顺序)。static booleancontainsKey(Map<?, ?> map, Object key) Map 是否包含 key。static <K,V> Difference <K, V> difference(Map<K, V> left, Map<K, V> right) 两个 Map 的差异分析:只在左 / 只在右 / 共有但值不同。static <K,V> Map <K, V> emptyIfNull(Map<K, V> map) 空 Map 返回空 Map。static <K,V> Map <K, V> 按条件过滤 Map(不修改原 Map)。static <K,V> V 获取值,key 不存在时返回默认值。static BigDecimalgetBigDecimal(Map<?, ?> map, Object key) 取 BigDecimal。static BigDecimalgetBigDecimal(Map<?, ?> map, Object key, BigDecimal defaultValue) 取 BigDecimal(带默认值)。static <K> BigIntegergetBigInteger(Map<K, ?> map, K key) 从 Map 中取BigInteger类型的值。static boolean获取 boolean 值(缺失返回false)。static boolean获取 boolean 值。static byte取 byte(含默认值)。static char取 char(含默认值)。static Date取 Date(支持时间戳与常见日期格式)。static double获取 double 值(缺失返回0)。static double获取 double 值。static <K, E extends Enum<E>>
E从 Map 中取指定枚举类型的值。static float取 float(含默认值)。static int获取 int 值(缺失返回0)。static int获取 int 值。static <K> LocalDategetLocalDate(Map<K, ?> map, K key) 从 Map 中取LocalDate类型的值。static <K> LocalDateTimegetLocalDateTime(Map<K, ?> map, K key) 从 Map 中取LocalDateTime类型的值。static long获取 long 值(缺失返回0)。static long获取 long 值。static short取 short(含默认值)。static String获取 String 值(不存在时返回null)。static String获取 String 值。static <K,V> Map <V, K> 键值互换(适用于 BiMap 场景;重复值后者覆盖前者)。static booleanMap 是否为空。static booleanisNotEmpty(Map<?, ?> map) Map 是否非空。static Stringjoin(Map<?, ?> map, CharSequence delimiter, CharSequence keyValueSeparator) 拼接 Map 为字符串,如a=1,b=2。static <K,V> Map <K, V> 合并两个 Map(后者覆盖前者同名键)。static <K,V> Map <K, V> mergeAll(Map<K, V> target, Map<K, V> source, BinaryOperator<V> merge) 合并源 Map 到目标 Map(带冲突合并策略);源与目标为同一对象时安全。static <K,V> ConcurrentHashMap <K, V> 创建 ConcurrentHashMap。static <K,V> HashMap <K, V> 创建 HashMap。static <K,V> HashMap <K, V> newHashMap(int size) 创建带初始容量的 HashMap。static <K,V> LinkedHashMap <K, V> 创建 LinkedHashMap。static <K,V> TreeMap <K, V> 创建 TreeMap。static <K,V> Map <K, V> 从成对参数构建 Map,如of("a", 1, "b", 2)。static <K,V> Map <V, K> key/value 反转(值相同会互相覆盖)。static <K extends Comparable<? super K>, V>
Map<K, V> 按 key 排序(key 需可比),返回 LinkedHashMap。static <K extends Comparable<? super K>, V>
Map<K, V> 按键升序排序 Map(便捷版,委托sort(Map, boolean))。static <K, V extends Comparable<? super V>>
Map<K, V> sortByValue(Map<K, V> map, boolean isAscending) 按值排序(值需可比),返回有序 LinkedHashMap。static <K, V extends Comparable<? super V>>
Map<K, V> sortByValueDesc(Map<K, V> map) 按值降序排序(返回 LinkedHashMap 保持顺序)。static <T,K, V> Map <K, V> 可迭代对象转 Map(Guava uniqueIndex 语义):重复键抛IllegalArgumentException。static <T,K, V> Map <K, V> toMap(Iterable<T> iterable, Function<T, K> keyMapper, Function<T, V> valueMapper, BinaryOperator<V> merge) 可迭代对象转 Map(带冲突合并策略):重复键按 merge 合并。static PropertiestoProperties(Map<?, ?> map) Map 转 Properties(值经 String.valueOf 转换)。static <K,V, R> Map <K, R> transformEntries(Map<K, V> map, BiFunction<K, V, R> mapper) 键值联合变换(对齐 GuavaMaps.transformEntries)。static <K,V, R> Map <K, R> transformValues(Map<K, V> map, Function<V, R> mapper) 值变换(对齐 GuavaMaps.transformValues)。static <K,V> Map <K, V> uniqueIndex(Iterable<V> values, Function<V, K> keyMapper) 唯一索引(对齐 GuavaMaps.uniqueIndex)。static <K,V> Collection <V> 获取 Map 的值集合(null视为空集合)。
-
Method Details
-
isEmpty
-
isNotEmpty
-
newHashMap
创建 HashMap。- Type Parameters:
K- key 类型V- value 类型- Returns:
- HashMap
-
newHashMap
创建带初始容量的 HashMap。- Type Parameters:
K- key 类型V- value 类型- Parameters:
size- 初始容量- Returns:
- HashMap
-
newLinkedHashMap
创建 LinkedHashMap。- Type Parameters:
K- key 类型V- value 类型- Returns:
- LinkedHashMap
-
newTreeMap
创建 TreeMap。- Type Parameters:
K- key 类型V- value 类型- Returns:
- TreeMap
-
newConcurrentHashMap
创建 ConcurrentHashMap。- Type Parameters:
K- key 类型V- value 类型- Returns:
- ConcurrentHashMap
-
of
-
get
获取值,key 不存在时返回默认值。- Type Parameters:
K- key 类型V- value 类型- Parameters:
map- Mapkey- keydefaultValue- 默认值- Returns:
- 值或默认值
-
getStr
-
getStr
-
getInt
-
getInt
-
getLong
-
getLong
-
getDouble
-
getDouble
-
getBool
-
getBool
-
containsKey
-
emptyIfNull
-
reverse
-
join
拼接 Map 为字符串,如a=1,b=2。- Parameters:
map- Mapdelimiter- 条目分隔符keyValueSeparator- key/value 分隔符- Returns:
- 拼接结果
-
sortByValue
public static <K, V extends Comparable<? super V>> Map<K,V> sortByValue(Map<K, V> map, boolean isAscending) 按值排序(值需可比),返回有序 LinkedHashMap。- Type Parameters:
K- 键类型V- 值类型(Comparable)- Parameters:
map- 原 MapisAscending- 是否升序- Returns:
- 排序后的新 Map
-
getBigDecimal
取 BigDecimal。- Parameters:
map- Mapkey- 键- Returns:
- BigDecimal 值;缺失返回 null
-
getBigDecimal
取 BigDecimal(带默认值)。- Parameters:
map- Mapkey- 键defaultValue- 默认值- Returns:
- BigDecimal 值
-
toProperties
Map 转 Properties(值经 String.valueOf 转换)。- Parameters:
map- Map- Returns:
- Properties
-
sort
按 key 排序(key 需可比),返回 LinkedHashMap。- Type Parameters:
K- 键类型(Comparable)V- 值类型- Parameters:
map- 原 MapisAscending- 是否升序- Returns:
- 排序后新 Map
-
sortByKey
按键升序排序 Map(便捷版,委托sort(Map, boolean))。- Type Parameters:
K- 键类型V- 值类型- Parameters:
map- 原 Map- Returns:
- 排序后新 Map
-
filter
-
getDate
-
getFloat
-
getChar
-
getByte
-
getShort
-
builder
创建 Map 链式构建器(默认 LinkedHashMap 保持插入顺序)。- Type Parameters:
K- 键类型V- 值类型- Returns:
- MapBuilder
-
inverse
-
merge
-
sortByValueDesc
按值降序排序(返回 LinkedHashMap 保持顺序)。- Type Parameters:
K- 键类型V- 值类型- Parameters:
map- 原 Map- Returns:
- 排序后的 Map
-
values
获取 Map 的值集合(null视为空集合)。- Type Parameters:
K- 键类型V- 值类型- Parameters:
map- 原 Map- Returns:
- 值集合;
map为null返回空集合 - Since:
- 1.0.1
-
getBigInteger
从 Map 中取BigInteger类型的值。- Type Parameters:
K- 键类型- Parameters:
map- Mapkey- 键- Returns:
- 值;不存在或转换失败返回
null - Since:
- 1.0.1
-
getEnum
-
getLocalDate
-
getLocalDateTime
从 Map 中取LocalDateTime类型的值。- Type Parameters:
K- 键类型- Parameters:
map- Mapkey- 键- Returns:
- 日期时间值;不存在或转换失败返回
null - Since:
- 1.0.1
-
toMap
public static <T,K, Map<K,V> V> toMap(Iterable<T> iterable, Function<T, K> keyMapper, Function<T, V> valueMapper) 可迭代对象转 Map(Guava uniqueIndex 语义):重复键抛IllegalArgumentException。- Type Parameters:
T- 元素类型K- 键类型V- 值类型- Parameters:
iterable- 数据源(null 返回空 Map)keyMapper- 键映射(null 时抛NullPointerException)valueMapper- 值映射(null 时抛NullPointerException)- Returns:
- 转换结果(LinkedHashMap 保序)
- Since:
- 1.16.0
-
toMap
public static <T,K, Map<K,V> V> toMap(Iterable<T> iterable, Function<T, K> keyMapper, Function<T, V> valueMapper, BinaryOperator<V> merge) 可迭代对象转 Map(带冲突合并策略):重复键按 merge 合并。- Type Parameters:
T- 元素类型K- 键类型V- 值类型- Parameters:
iterable- 数据源(null 返回空 Map)keyMapper- 键映射(null 时抛NullPointerException)valueMapper- 值映射(null 时抛NullPointerException)merge- 冲突合并函数(null 时重复键取后者)- Returns:
- 转换结果(LinkedHashMap 保序)
- Since:
- 1.16.0
-
difference
两个 Map 的差异分析:只在左 / 只在右 / 共有但值不同。- Type Parameters:
K- 键类型V- 值类型- Parameters:
left- 左 Map(null 按空处理)right- 右 Map(null 按空处理)- Returns:
- 差异结果
Difference - Since:
- 1.16.0
-
mergeAll
合并源 Map 到目标 Map(带冲突合并策略);源与目标为同一对象时安全。- Type Parameters:
K- 键类型V- 值类型- Parameters:
target- 目标 Map(null 时不操作,返回 null)source- 源 Map(null 时不操作)merge- 冲突合并函数(null 时目标值覆盖源值)- Returns:
- 操作后的目标 Map
- Since:
- 1.16.0
-
transformValues
-
transformEntries
键值联合变换(对齐 GuavaMaps.transformEntries)。- Type Parameters:
K- 键类型V- 原值类型R- 新值类型- Parameters:
map- 原映射,可为nullmapper- 键值变换函数((K, V) -> R)- Returns:
- 变换后的 Map;
null输入返回空 Map - Since:
- 1.19.0
-
uniqueIndex
唯一索引(对齐 GuavaMaps.uniqueIndex)。将可迭代对象按键提取器建立映射;出现重复键抛
IllegalArgumentException。 原顺序保留(LinkedHashMap)。- Type Parameters:
K- 键类型V- 值类型- Parameters:
values- 待索引对象,可为nullkeyMapper- 键提取器- Returns:
- 唯一索引 Map;
null输入返回空 Map - Throws:
IllegalArgumentException- 存在重复键- Since:
- 1.19.0
-
asMap
-