java.util.concurrent
类 ConcurrentSkipListSet

java.lang.Object
  java.util.AbstractCollection<E>
      java.util.AbstractSet<E>
          java.util.concurrent.ConcurrentSkipListSet<E>

类型参数：

E - 此 set 维护的元素类型

所有已实现的接口：

Serializable, Cloneable, Iterable<E>, Collection<E>, NavigableSet<E>, Set<E>, SortedSet<E>

public class ConcurrentSkipListSet<E>
     

      extends 
      AbstractSet<E>
     
     

      implements 
      NavigableSet<E>, 
      Cloneable, 
      Serializable
     

一个基于 ConcurrentSkipListMap 的可缩放并发 NavigableSet 实现。set 的元素可以根据它们的自然顺序进行排序，也可以根据创建 set 时所提供的 Comparator 进行排序，具体取决于使用的构造方法。

此实现为 contains、add、remove 操作及其变体提供预期平均 log(n) 时间开销。多个线程可以安全地并发执行插入、移除和访问操作。迭代器是弱一致 的，返回的元素将反映迭代器创建时或创建后某一时刻的 set 状态。它们不 抛出 ConcurrentModificationException，可以并发处理其他操作。升序排序视图及其迭代器比降序排序视图及其迭代器更快。

请注意，与在大多数 collection 中不同，这里的 size 方法不是 一个固定时间 (constant-time) 操作。由于这些 set 的异步特性，确定元素的当前数目需要遍历元素。此外，批量操作 addAll、removeAll、retainAll 和 containsAll 并不 保证能以原子方式 (atomically) 执行。例如，与 addAll 操作一起并发操作的迭代器只能查看某些附加元素。

此类及其迭代器实现 Set 和 Iterator 接口的所有可选 方法。与大多数其他并发 collection 实现一样，此类不允许使用 null 元素，因为无法可靠地将 null 参数及返回值与不存在的元素区分开来。

此类是 Java Collections Framework 的成员。

从以下版本开始：

1.6

另请参见：

序列化表格

ConcurrentSkipListSet

public ConcurrentSkipListSet()

构造一个新的空 set，该 set 按照元素的 自然顺序对其进行排序。

ConcurrentSkipListSet

public ConcurrentSkipListSet(Comparator<? super E> comparator)

构造一个新的空 set，该 set 按照指定的比较器对其元素进行排序。

参数：

comparator - 用于对此 set 进行排序的比较器。如果此参数为 null，则使用元素的 自然顺序。

ConcurrentSkipListSet

public ConcurrentSkipListSet(Collection<? extends E> c)

构造一个包含指定 collection 中元素的新 set，这个新 set 按照元素的 自然顺序对其进行排序。

参数：

c - 将组成新 set 的元素

抛出：

ClassCastException - 如果 c 中的元素不是 Comparable，或者无法相互比较

NullPointerException - 如果指定的 collection 或它的任何元素为 null

ConcurrentSkipListSet

public ConcurrentSkipListSet(SortedSet<E> s)

构造一个新 set，该 set 所包含的元素与指定的有序 set 包含的元素相同，使用的顺序也相同。

参数：

s - 有序 set，其元素将组成新的 set

抛出：

NullPointerException - 如果指定的有序 set 或它的任何元素为 null

clone

public ConcurrentSkipListSet<E> clone()

返回此 ConcurrentSkipListSet 实例的浅表副本。(这些元素本身没有复制。）

覆盖：

类 Object 中的 clone

返回：

此 set 的浅表副本

另请参见：

Cloneable

size

public int size()

返回此 set 中的元素数目。如果此 set 包含的元素数大于 Integer.MAX_VALUE，则返回 Integer.MAX_VALUE。

请注意，与在大多数 collection 中不同，此方法在这里不是 一个固定时间 (constant-time) 操作。由于这些 set 的异步特性，确定元素的当前数目需要遍历元素以计算其数目。此外，在执行此方法期间大小可能更改，在这种情况下，返回的结果将不准确。因此，此方法在并发应用程序中通常不是很有用。

指定者：

接口 Collection<E> 中的 size

指定者：

接口 Set<E> 中的 size

指定者：

类 AbstractCollection<E> 中的 size

返回：

此 set 中的元素数

isEmpty

public boolean isEmpty()

如果此 set 不包含任何元素，则返回 true。

指定者：

接口 Collection<E> 中的 isEmpty

指定者：

接口 Set<E> 中的 isEmpty

覆盖：

类 AbstractCollection<E> 中的 isEmpty

返回：

如果此 set 不包含任何元素，则返回 true

contains

public boolean contains(Object o)

如果此 set 包含指定的元素，则返回 true。更确切地讲，当且仅当此 set 包含一个满足 o.equals(e) 的元素 e 时，返回 true。

指定者：

接口 Collection<E> 中的 contains

指定者：

接口 Set<E> 中的 contains

覆盖：

类 AbstractCollection<E> 中的 contains

参数：

o - 检查是否包含在此 set 中的对象

返回：

如果此 set 包含指定的元素，则返回 true

抛出：

ClassCastException - 如果指定的元素无法与此 set 中的当前元素进行比较

NullPointerException - 如果指定的元素为 null

add

public boolean add(E e)

如果此 set 中不包含指定元素，则添加指定元素。更确切地讲，如果此 set 不包含满足 e.equals(e2) 的元素 e2，则向 set 中添加指定的元素 e。如果此 set 已经包含该元素，则调用不更改该 set 并返回 false。

指定者：

接口 Collection<E> 中的 add

指定者：

接口 Set<E> 中的 add

覆盖：

类 AbstractCollection<E> 中的 add

参数：

e - 要添加到此 set 的元素

返回：

如果此 set 尚未包含指定的元素，则返回 true

抛出：

ClassCastException - 如果 e 无法与此 set 中的当前元素进行比较

NullPointerException - 如果指定的元素为 null

remove

public boolean remove(Object o)

如果此 set 中存在指定的元素，则将其移除。更确切地讲，如果此 set 中包含满足 o.equals(e) 的元素 e，则移除该元素。如果此 set 包含该元素（或者此 set 由于调用而发生了更改），则返回 true。（一旦调用返回，则此 set 不再包含该元素。）

指定者：

接口 Collection<E> 中的 remove

指定者：

接口 Set<E> 中的 remove

覆盖：

类 AbstractCollection<E> 中的 remove

参数：

o - 要从此 set 中移除的对象（如果存在）

返回：

如果此 set 中包含指定的元素，则返回 true

抛出：

ClassCastException - 如果 o 无法与此 set 中的当前元素进行比较

NullPointerException - 如果指定的元素为 null

clear

public void clear()

从此 set 中移除所有元素。

指定者：

接口 Collection<E> 中的 clear

指定者：

接口 Set<E> 中的 clear

覆盖：

类 AbstractCollection<E> 中的 clear

iterator

public Iterator<E> iterator()

返回在此 set 的元素上以升序进行迭代的迭代器。

指定者：

接口 Iterable<E> 中的 iterator

指定者：

接口 Collection<E> 中的 iterator

指定者：

接口 NavigableSet<E> 中的 iterator

指定者：

接口 Set<E> 中的 iterator

指定者：

类 AbstractCollection<E> 中的 iterator

返回：

在此 set 的元素上以升序进行迭代的迭代器

descendingIterator

public Iterator<E> descendingIterator()

返回在此 set 的元素上以降序进行迭代的迭代器。

指定者：

接口 NavigableSet<E> 中的 descendingIterator

返回：

在此 set 的元素上以降序进行迭代的迭代器

equals

public boolean equals(Object o)

比较指定对象与此 set 的相等性。如果指定的对象也是一个 set，两个 set 的大小相同，并且指定 set 的所有成员都包含在此 set 中（或者此 set 的所有成员都包含在指定的 set 中），则返回 true。此定义确保了 equals 方法可在不同的 set 接口实现间正常工作。

指定者：

接口 Collection<E> 中的 equals

指定者：

接口 Set<E> 中的 equals

覆盖：

类 AbstractSet<E> 中的 equals

参数：

o - 要与此 set 进行相等性比较的对象

返回：

如果指定的对象等于此 set，则返回 true。

另请参见：

Object.hashCode(), Hashtable

removeAll

public boolean removeAll(Collection<?> c)

从此 set 中移除包含在指定 collection 中的所有元素。如果指定的 collection 也是一个 set，那么此操作将实际修改此 set，从而其值是两个 set 的一个 不对称差集。

指定者：

接口 Collection<E> 中的 removeAll

指定者：

接口 Set<E> 中的 removeAll

覆盖：

类 AbstractSet<E> 中的 removeAll

参数：

c - 包含要从此 set 中移除的元素的 collection

返回：

如果此 set 由于调用而发生更改，则返回 true

抛出：

ClassCastException - 如果此 set 中一个或多个元素的类型与指定的 collection 不兼容

NullPointerException - 如果指定的 collection 或其任何元素为 null

另请参见：

AbstractCollection.remove(Object), AbstractCollection.contains(Object)

lower

public E lower(E e)

从接口 NavigableSet 复制的描述

返回此 set 中严格小于给定元素的最大元素；如果不存在这样的元素，则返回 null。

指定者：

接口 NavigableSet<E> 中的 lower

参数：

e - 要匹配的值

返回：

小于 e 的最大元素；如果不存在这样的元素，则返回 null

抛出：

ClassCastException - 如果指定元素不能与 set 中的当前元素进行比较

NullPointerException - 如果指定的元素为 null

floor

public E floor(E e)

从接口 NavigableSet 复制的描述

返回此 set 中小于等于给定元素的最大元素；如果不存在这样的元素，则返回 null。

指定者：

接口 NavigableSet<E> 中的 floor

参数：

e - 要匹配的值

返回：

小于等于 e 的最大元素；如果不存在这样的元素，则返回 null

抛出：

ClassCastException - 如果指定元素不能与 set 中的当前元素进行比较

NullPointerException - 如果指定的元素为 null

ceiling

public E ceiling(E e)

从接口 NavigableSet 复制的描述

返回此 set 中大于等于给定元素的最小元素；如果不存在这样的元素，则返回 null。

指定者：

接口 NavigableSet<E> 中的 ceiling

参数：

e - 要匹配的值

返回：

大于等于 e 的最小元素；如果不存在这样的元素，则返回 null

抛出：

ClassCastException - 如果指定元素不能与 set 中的当前元素进行比较

NullPointerException - 如果指定的元素为 null

higher

public E higher(E e)

从接口 NavigableSet 复制的描述

返回此 set 中严格大于给定元素的最小元素；如果不存在这样的元素，则返回 null。

指定者：

接口 NavigableSet<E> 中的 higher

参数：

e - 要匹配的值

返回：

大于 e 的最小元素；如果不存在这样的元素，则返回 null

抛出：

ClassCastException - 如果指定元素不能与 set 中的当前元素进行比较

NullPointerException - 如果指定的元素为 null

pollFirst

public E pollFirst()

从接口 NavigableSet 复制的描