Class AbstractMultimap<K,V>

java.lang.Object
cloud.opencode.base.collections.AbstractMultimap<K,V>
Type Parameters:
K - key type | 键类型
V - value type | 值类型
All Implemented Interfaces:
Multimap<K,V>, Serializable
Direct Known Subclasses:
ArrayListMultimap, HashSetMultimap, LinkedHashMultimap, TreeSetMultimap
public abstract class AbstractMultimap<K,V> extends Object implements Multimap<K,V>, Serializable
AbstractMultimap - Abstract Base for Multimap Implementations AbstractMultimap - Multimap 实现的抽象基类

Provides skeletal implementation for Multimap. Subclasses need to implement the collection factory method.

为 Multimap 提供骨架实现。子类需要实现集合工厂方法。

Features | 主要功能:

  • Common multimap operations - 通用多重映射操作
  • Live views - 实时视图
  • Serializable - 可序列化

Security | 安全性:

  • Thread-safe: No - 线程安全: 否
  • Null-safe: Implementation dependent - 空值安全: 取决于实现

Usage Examples | 使用示例:

// Subclass provides collection factory
Multimap<String, Integer> multimap = ArrayListMultimap.create();
multimap.put("a", 1);
multimap.put("a", 2);
Collection<Integer> values = multimap.get("a"); // [1, 2]
Since:
JDK 25, opencode-base-collections V1.0.0
Author:
Leon Soo www.LeonSoo.com
See Also:

  • Field Details

  • Constructor Details

    • AbstractMultimap

      protected AbstractMultimap(Map<K, Collection<V>> map)
      Constructor with backing map. 使用后备映射的构造方法。
      Parameters:
      map - backing map | 后备映射

  • Method Details

    • createCollection

      protected abstract Collection<V> createCollection()
      Create a new collection for values. 为值创建新集合。
      Returns:
      new collection | 新集合

    • size

      public int size()
      Description copied from interface: Multimap
      Return the total number of key-value pairs. 返回键值对的总数。
      Specified by:
      size in interface Multimap<K,V>
      Returns:
      size | 大小

    • isEmpty

      public boolean isEmpty()
      Description copied from interface: Multimap
      Check if the multimap is empty. 检查多重映射是否为空。
      Specified by:
      isEmpty in interface Multimap<K,V>
      Returns:
      true if empty | 如果为空则返回 true

    • containsKey

      public boolean containsKey(Object key)
      Description copied from interface: Multimap
      Check if the multimap contains the key. 检查多重映射是否包含键。
      Specified by:
      containsKey in interface Multimap<K,V>
      Parameters:
      key - the key | 键
      Returns:
      true if contains | 如果包含则返回 true

    • containsValue

      public boolean containsValue(Object value)
      Description copied from interface: Multimap
      Check if the multimap contains the value. 检查多重映射是否包含值。
      Specified by:
      containsValue in interface Multimap<K,V>
      Parameters:
      value - the value | 值
      Returns:
      true if contains | 如果包含则返回 true

    • containsEntry

      public boolean containsEntry(Object key, Object value)
      Description copied from interface: Multimap
      Check if the multimap contains the key-value pair. 检查多重映射是否包含键值对。
      Specified by:
      containsEntry in interface Multimap<K,V>
      Parameters:
      key - the key | 键
      value - the value | 值
      Returns:
      true if contains | 如果包含则返回 true

    • put

      public boolean put(K key, V value)
      Description copied from interface: Multimap
      Store a key-value pair. 存储键值对。
      Specified by:
      put in interface Multimap<K,V>
      Parameters:
      key - the key | 键
      value - the value | 值
      Returns:
      true if changed | 如果发生更改则返回 true

    • putAll

      public boolean putAll(K key, Iterable<? extends V> values)
      Description copied from interface: Multimap
      Store multiple values for a key. 为键存储多个值。
      Specified by:
      putAll in interface Multimap<K,V>
      Parameters:
      key - the key | 键
      values - the values | 值
      Returns:
      true if changed | 如果发生更改则返回 true

    • get

      public Collection<V> get(K key)
      Description copied from interface: Multimap
      Return the collection of values for the key. 返回键的值集合。
      Specified by:
      get in interface Multimap<K,V>
      Parameters:
      key - the key | 键
      Returns:
      values collection (never null, may be empty) | 值集合（不为 null，可能为空）

    • remove

      public boolean remove(Object key, Object value)
      Description copied from interface: Multimap
      Remove a single key-value pair. 移除单个键值对。
      Specified by:
      remove in interface Multimap<K,V>
      Parameters:
      key - the key | 键
      value - the value | 值
      Returns:
      true if removed | 如果移除则返回 true

    • removeAll

      public Collection<V> removeAll(Object key)
      Description copied from interface: Multimap
      Remove all values for a key. 移除键的所有值。
      Specified by:
      removeAll in interface Multimap<K,V>
      Parameters:
      key - the key | 键
      Returns:
      removed values | 移除的值

    • replaceValues

      public Collection<V> replaceValues(K key, Iterable<? extends V> values)
      Description copied from interface: Multimap
      Replace all values for a key. 替换键的所有值。
      Specified by:
      replaceValues in interface Multimap<K,V>
      Parameters:
      key - the key | 键
      values - the new values | 新值
      Returns:
      previous values | 之前的值

    • clear

      public void clear()
      Description copied from interface: Multimap
      Clear all entries. 清除所有条目。
      Specified by:
      clear in interface Multimap<K,V>

    • keySet

      public Set<K> keySet()
      Description copied from interface: Multimap
      Return a set view of the keys. 返回键的集合视图。
      Specified by:
      keySet in interface Multimap<K,V>
      Returns:
      key set | 键集合

    • keys

      public Multiset<K> keys()
      Description copied from interface: Multimap
      Return a multiset view of the keys (includes duplicates by value count). 返回键的多重集视图（按值计数包含重复）。
      Specified by:
      keys in interface Multimap<K,V>
      Returns:
      key multiset | 键多重集

    • values

      public Collection<V> values()
      Description copied from interface: Multimap
      Return a collection view of all values. 返回所有值的集合视图。
      Specified by:
      values in interface Multimap<K,V>
      Returns:
      values collection | 值集合

    • entries

      public Collection<Map.Entry<K,V>> entries()
      Description copied from interface: Multimap
      Return a collection view of all key-value pairs. 返回所有键值对的集合视图。
      Specified by:
      entries in interface Multimap<K,V>
      Returns:
      entries collection | 条目集合

    • asMap

      public Map<K, Collection<V>> asMap()
      Description copied from interface: Multimap
      Return a map view with key to collection mapping. 返回键到集合映射的视图。
      Specified by:
      asMap in interface Multimap<K,V>
      Returns:
      map view | 映射视图

    • equals

      public boolean equals(Object o)
      Overrides:
      equals in class Object

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object

    • toString

      public String toString()
      Overrides:
      toString in class Object