Package org.miaixz.bus.core.center

Class CollectionOperation<E>

java.lang.Object
org.miaixz.bus.core.center.CollectionOperation<E>
Type Parameters:
E - 元素类型
public class CollectionOperation<E> extends Object
集合运算，包括：
  • 求集合的并集
  • 求集合的唯一并集
  • 求集合的完全并集
  • 求集合的交集
  • 求集合的差集
Since:
Java 17+
Author:
Kimi Liu

  • Constructor Summary

    Constructors
    Constructor
    Description
    CollectionOperation(Collection<? extends E>[] colls)
    构造

  • Method Summary

    Modifier and Type
    Method
    Description
    Collection<E>
    disjunction()
    多个集合的差集 针对一个集合中存在多个相同元素的情况，计算每两个集合中此元素的个数，保留两个集合中此元素个数差的个数 例如：
    Collection<E>
    intersection()
    多个集合的交集 针对一个集合中存在多个相同元素的情况，计算两个集合中此元素的个数，保留最少的个数 例如：集合1：[a, b, c, c, c]，集合2：[a, b, c, c] 结果：[a, b, c, c]，此结果中只保留了两个c
    Set<E>
    intersectionDistinct()
    多个集合的唯一交集 针对一个集合中存在多个相同元素的情况，只保留一个 例如：集合1：[a, b, c, c, c]，集合2：[a, b, c, c] 结果：[a, b, c]，此结果中只保留了一个c
    static <E> CollectionOperation<E>
    of(Collection<? extends E>... colls)
    创建运算对象
    List<E>
    subtract()
    计算集合的单差集，即只返回【集合1】中有，但是【集合2】、【集合3】...中没有的元素，例如：
    Collection<E>
    union()
    多个集合的并集 针对一个集合中存在多个相同元素的情况，计算两个集合中此元素的个数，保留最多的个数 例如：集合1：[a, b, c, c, c]，集合2：[a, b, c, c] 结果：[a, b, c, c, c]，此结果中只保留了三个c
    List<E>
    unionAll()
    多个集合的完全并集，类似于SQL中的“UNION ALL” 针对一个集合中存在多个相同元素的情况，保留全部元素 例如：集合1：[a, b, c, c, c]，集合2：[a, b, c, c] 结果：[a, b, c, c, c, a, b, c, c]
    Set<E>
    unionDistinct()
    多个集合的非重复并集，类似于SQL中的“UNION DISTINCT” 针对一个集合中存在多个相同元素的情况，只保留一个 例如：集合1：[a, b, c, c, c]，集合2：[a, b, c, c] 结果：[a, b, c]，此结果中只保留了一个c

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Constructor Details

    • CollectionOperation

      public CollectionOperation(Collection<? extends E>[] colls)
      构造
      Parameters:
      colls - 集合数组

  • Method Details

    • of

      @SafeVarargs public static <E> CollectionOperation<E> of(Collection<? extends E>... colls)
      创建运算对象
      Type Parameters:
      E - 元素类型
      Parameters:
      colls - 集合列表
      Returns:
      CollectionOperation

    • union

      public Collection<E> union()
      多个集合的并集 针对一个集合中存在多个相同元素的情况，计算两个集合中此元素的个数，保留最多的个数 例如：集合1：[a, b, c, c, c]，集合2：[a, b, c, c] 结果：[a, b, c, c, c]，此结果中只保留了三个c
      Returns:
      并集的集合，返回 ArrayList

    • unionDistinct

      public Set<E> unionDistinct()
      多个集合的非重复并集，类似于SQL中的“UNION DISTINCT” 针对一个集合中存在多个相同元素的情况，只保留一个 例如：集合1：[a, b, c, c, c]，集合2：[a, b, c, c] 结果：[a, b, c]，此结果中只保留了一个c
      Returns:
      并集的集合，返回 LinkedHashSet

    • unionAll

      public List<E> unionAll()
      多个集合的完全并集，类似于SQL中的“UNION ALL” 针对一个集合中存在多个相同元素的情况，保留全部元素 例如：集合1：[a, b, c, c, c]，集合2：[a, b, c, c] 结果：[a, b, c, c, c, a, b, c, c]
      Returns:
      并集的集合，返回 ArrayList

    • intersection

      public Collection<E> intersection()
      多个集合的交集 针对一个集合中存在多个相同元素的情况，计算两个集合中此元素的个数，保留最少的个数 例如：集合1：[a, b, c, c, c]，集合2：[a, b, c, c] 结果：[a, b, c, c]，此结果中只保留了两个c
      Returns:
      交集的集合，返回 ArrayList

    • intersectionDistinct

      public Set<E> intersectionDistinct()
      多个集合的唯一交集 针对一个集合中存在多个相同元素的情况，只保留一个 例如：集合1：[a, b, c, c, c]，集合2：[a, b, c, c] 结果：[a, b, c]，此结果中只保留了一个c
      Returns:
      唯一交集的集合，返回 LinkedHashSet

    • disjunction

      public Collection<E> disjunction()
      多个集合的差集 针对一个集合中存在多个相同元素的情况，计算每两个集合中此元素的个数，保留两个集合中此元素个数差的个数 例如： 
           disjunction([a, b, c, c, c], [a, b, c, c]) - [c]
     disjunction([a, b], [])                    - [a, b]
     disjunction([a, b, c], [b, c, d])          - [a, d]
      任意一个集合为空，返回另一个集合 两个集合无差集则返回空集合
      Returns:
      差集的集合，返回 ArrayList

    • subtract

      public List<E> subtract()
      计算集合的单差集，即只返回【集合1】中有，但是【集合2】、【集合3】...中没有的元素，例如： 
           subtract([1,2,3,4],[2,3,4,5]) - [1]
      Returns:
      单差集的List