Class FluentMap<K,V>
java.lang.Object
com.sure.tool.fluent.FluentMap<K,V>
- Type Parameters:
K- 键类型V- 值类型
链式 Map 构建与变换(Fluent API 全面化第三项)。
与 MapUtil 静态方法形态并存:支持「构建 → 变换 → 终端」一条链完成。
中间操作返回新的 FluentMap(内部 Map 不可变,插入顺序保留,原 Map 不受影响);
终端 toMap() 等返回不可变结果(对标 Guava ImmutableMap 理念,零依赖实现)。
键与值均不允许为 null:任何途径引入 null 都会抛 IllegalArgumentException。
示例:
Map<String, Integer> m = Fluent.<String, Integer>map()
.put("a", 1).put("b", 2).filterValues(v -> v > 1).toMap();
// {"b": 2},不可变、保插入顺序
- Since:
- 1.19.0
-
Method Summary
Modifier and TypeMethodDescriptionbooleancontainsKey(K key) 终端:是否包含指定键(null 返回 false)。filterKeys(Predicate<? super K> predicate) 按键过滤。filterValues(Predicate<? super V> predicate) 按值过滤。static <K,V> FluentMap <K, V> 从既有 Map 创建管道(防御拷贝,插入顺序保留,原 Map 修改不影响管道)。终端:按键取值(键不存在或为 null 返回 null)。booleanisEmpty()终端:是否为空。keys()终端:返回不可变键集合(保插入顺序)。值映射(键保持不变)。static <K,V> FluentMap <K, V> of()创建空 Map 管道。static <K,V> FluentMap <K, V> of(K key, V value) 创建含单个键值对的 Map 管道。插入或覆盖键值对。putIfAbsent(K key, V value) 键不存在时插入(已存在则保持不变)。移除指定键(不存在则原样返回)。intsize()终端:键值对数量。toMap()终端:返回不可变 Map(保插入顺序)。toString()values()终端:返回不可变值列表(保插入顺序)。
-
Method Details
-
of
创建空 Map 管道。示例:
FluentMap<String, Integer> m = Fluent.map();- Type Parameters:
K- 键类型V- 值类型- Returns:
- 空管道实例
-
of
创建含单个键值对的 Map 管道。- Type Parameters:
K- 键类型V- 值类型- Parameters:
key- 键,不能为 nullvalue- 值,不能为 null- Returns:
- 管道实例
- Throws:
IllegalArgumentException- key 或 value 为 null
-
from
从既有 Map 创建管道(防御拷贝,插入顺序保留,原 Map 修改不影响管道)。示例:
FluentMap<String, Integer> m = FluentMap.from(existingMap);- Type Parameters:
K- 键类型V- 值类型- Parameters:
source- 源 Map,不能为 null,键值均不能为 null- Returns:
- 管道实例(内部不可变副本)
- Throws:
NullPointerException- source 为 nullIllegalArgumentException- source 含 null 键或 null 值
-
put
-
putIfAbsent
-
remove
-
mapValues
值映射(键保持不变)。示例:
Map<String, String> m = Fluent.<String, Integer>map() .put("a", 1).mapValues(v -> "v" + v).toMap(); // {"a": "v1"}- Type Parameters:
V2- 目标值类型- Parameters:
mapper- 映射函数,不能为 null;结果不能为 null- Returns:
- 新的管道实例
- Throws:
NullPointerException- mapper 为 nullIllegalArgumentException- 映射结果含 null
-
filterKeys
-
filterValues
按值过滤。示例:
Map<String, Integer> m = Fluent.<String, Integer>map() .put("a", 1).put("b", 2).filterValues(v -> v > 1).toMap(); // {"b": 2}- Parameters:
predicate- 过滤条件,不能为 null- Returns:
- 新的管道实例
- Throws:
NullPointerException- predicate 为 null
-
toMap
-
get
-
size
public int size()终端:键值对数量。- Returns:
- 数量
-
isEmpty
public boolean isEmpty()终端:是否为空。- Returns:
- 空返回 true
-
containsKey
终端:是否包含指定键(null 返回 false)。- Parameters:
key- 键,可为 null- Returns:
- 包含返回 true
-
keys
-
values
-
toString
-