Class MultiMap<K,V>

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

public class MultiMap<K,V> extends Object
多值映射:一个键关联多个值(有序、保持插入顺序),对标 Guava Multimap 与 commons-collections4 MultiValuedMap 的常用子集,零依赖。

典型场景:标签分组、一对多关联、按组收集数据。内部使用 LinkedHashMap 与 ArrayList,迭代顺序稳定。

线程安全:本类非线程安全;并发场景需外部同步。

Since:
1.10.0
  • Constructor Details

    • MultiMap

      public MultiMap()
  • Method Details

    • put

      public boolean put(K key, V value)
      添加一个值到指定键,键不存在时自动创建列表。
      Parameters:
      key - 键
      value - 值(可为 null)
      Returns:
      若该键此前未包含此值返回 true
    • putAll

      public MultiMap<K,V> putAll(K key, Collection<? extends V> values)
      批量添加多个值到指定键。
      Parameters:
      key - 键
      values - 值集合(可为空)
      Returns:
      本对象,支持链式调用
    • get

      public List<V> get(K key)
      获取指定键关联的所有值;键不存在时返回空不可变列表(不抛异常)。
      Parameters:
      key - 键
      Returns:
      值列表(只读视图)
    • removeAll

      public List<V> removeAll(K key)
      移除指定键下的所有值。
      Parameters:
      key - 键
      Returns:
      被移除的值列表;键不存在返回空列表
    • remove

      public boolean remove(K key, V value)
      移除指定键下的单个值。
      Parameters:
      key - 键
      value - 值
      Returns:
      移除成功返回 true
    • containsKey

      public boolean containsKey(K key)
      是否包含指定键。
      Parameters:
      key - 键
      Returns:
      是否包含
    • containsValue

      public boolean containsValue(V value)
      是否存在至少一个值与 value 相等。
      Parameters:
      value - 值
      Returns:
      是否存在
    • keyCount

      public int keyCount()
      键的数量(去重)。
      Returns:
      键数量
    • size

      public int size()
      全部值的总数(含重复)。
      Returns:
      值总数
    • values

      public List<V> values()
      全部值的扁平集合。
      Returns:
      值集合
    • keys

      public Set<K> keys()
      全部键集合(保持插入顺序)。
      Returns:
      键集合
    • entries

      public Set<Map.Entry<K,List<V>>> entries()
      键值对条目集合(key → 其全部值列表)。
      Returns:
      条目集合
    • asMap

      public Map<K,List<V>> asMap()
      转为普通 Map 视图(值为只读列表)。
      Returns:
      Map 视图
    • clear

      public void clear()
      清空所有键值。
    • isEmpty

      public boolean isEmpty()
      是否为空。
      Returns:
      是否为空
    • toString

      public String toString()
      Overrides:
      toString in class Object