Class FluentMap<K,V>

java.lang.Object
com.sure.tool.fluent.FluentMap<K,V>
Type Parameters:
K - 键类型
V - 值类型

public final class FluentMap<K,V> extends Object
链式 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 Details

    • of

      public static <K,V> FluentMap<K,V> of()
      创建空 Map 管道。

      示例:

      FluentMap<String, Integer> m = Fluent.map();
      
      Type Parameters:
      K - 键类型
      V - 值类型
      Returns:
      空管道实例
    • of

      public static <K,V> FluentMap<K,V> of(K key, V value)
      创建含单个键值对的 Map 管道。
      Type Parameters:
      K - 键类型
      V - 值类型
      Parameters:
      key - 键,不能为 null
      value - 值,不能为 null
      Returns:
      管道实例
      Throws:
      IllegalArgumentException - key 或 value 为 null
    • from

      public static <K,V> FluentMap<K,V> from(Map<? extends K, ? extends V> source)
      从既有 Map 创建管道(防御拷贝,插入顺序保留,原 Map 修改不影响管道)。

      示例:

      FluentMap<String, Integer> m = FluentMap.from(existingMap);
      
      Type Parameters:
      K - 键类型
      V - 值类型
      Parameters:
      source - 源 Map,不能为 null,键值均不能为 null
      Returns:
      管道实例(内部不可变副本)
      Throws:
      NullPointerException - source 为 null
      IllegalArgumentException - source 含 null 键或 null 值
    • put

      public FluentMap<K,V> put(K key, V value)
      插入或覆盖键值对。

      示例:

      Map<String, Integer> m = Fluent.map()
              .put("a", 1).put("b", 2).toMap();
      
      Parameters:
      key - 键,不能为 null
      value - 值,不能为 null
      Returns:
      新的管道实例
      Throws:
      IllegalArgumentException - key 或 value 为 null
    • putIfAbsent

      public FluentMap<K,V> putIfAbsent(K key, V value)
      键不存在时插入(已存在则保持不变)。
      Parameters:
      key - 键,不能为 null
      value - 值,不能为 null
      Returns:
      新的管道实例
      Throws:
      IllegalArgumentException - key 或 value 为 null
    • remove

      public FluentMap<K,V> remove(K key)
      移除指定键(不存在则原样返回)。
      Parameters:
      key - 键,可为 null(恒无操作)
      Returns:
      新的管道实例
    • mapValues

      public <V2> FluentMap<K,V2> mapValues(Function<? super V, ? extends V2> mapper)
      值映射(键保持不变)。

      示例:

      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 为 null
      IllegalArgumentException - 映射结果含 null
    • filterKeys

      public FluentMap<K,V> filterKeys(Predicate<? super K> predicate)
      按键过滤。
      Parameters:
      predicate - 过滤条件,不能为 null
      Returns:
      新的管道实例
      Throws:
      NullPointerException - predicate 为 null
    • filterValues

      public FluentMap<K,V> filterValues(Predicate<? super V> predicate)
      按值过滤。

      示例:

      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

      public Map<K,V> toMap()
      终端:返回不可变 Map(保插入顺序)。

      返回结果不可修改,且为独立副本,与管道内部互不影响。

      Returns:
      不可变 Map
    • get

      public V get(K key)
      终端:按键取值(键不存在或为 null 返回 null)。
      Parameters:
      key - 键,可为 null
      Returns:
      对应值或 null
    • size

      public int size()
      终端:键值对数量。
      Returns:
      数量
    • isEmpty

      public boolean isEmpty()
      终端:是否为空。
      Returns:
      空返回 true
    • containsKey

      public boolean containsKey(K key)
      终端:是否包含指定键(null 返回 false)。
      Parameters:
      key - 键,可为 null
      Returns:
      包含返回 true
    • keys

      public Set<K> keys()
      终端:返回不可变键集合(保插入顺序)。
      Returns:
      不可变 Set
    • values

      public List<V> values()
      终端:返回不可变值列表(保插入顺序)。
      Returns:
      不可变 List
    • toString

      public String toString()
      Overrides:
      toString in class Object