public class HashSet<E>细说

public class HashSet<E>

extends  AbstractSet<E> implements  Set<E>,  Cloneable,  Serializable

此类实现 Set 接口，由哈希表（实际上是一个 HashMap 实例）支持。它不保证集合的迭代顺序；特别是它不保证该顺序恒久不变。此类允许使用 null 元素。 

此类为基本操作提供了稳定性能，这些基本操作包括 add、remove、contains 和 size，假定哈希函数将这些元素正确地分布在桶中。对此集合进行迭代所需的时间与 HashSet 实例的大小（元素的数量）和底层 HashMap 实例（桶的数量）的“容量”的和成比例。因此，如果迭代性能很重要，则不要将初始容量设置得太高（或将加载因子设置得太低）。 

注意，此实现不是同步的。 如果多个线程同时访问一个集合，而其中至少一个线程修改了该集合，那么它 保持外部同步。这通常是通过对自然封装该集合的对象执行同步操作来完成的。如果不存在这样的对象，则应该使用 Collections.synchronizedSet 方法来“包装”集合。最好在创建时完成这一操作，以防止对 HashSet 实例进行意外的不同步访问： 

     Set s = Collections.synchronizedSet(new HashSet(...));
 

此类的 iterator 方法返回的迭代器是 的：在创建迭代器之后，如果对集合进行修改，除非通过迭代器自身的 remove 方法，否则在任何时间以任何方式对其进行修改，Iterator 都将抛出 ConcurrentModificationException。因此，面对并发的修改，迭代器很快就会完全失败，而不冒将来在某个不确定时间发生任意不确定行为的风险。 

注意，迭代器的快速失败行为无法得到保证，因为一般来说，不可能对是否出现不同步并发修改做出任何硬性保证。快速失败迭代器在尽最大努力抛出 ConcurrentModificationException。因此，为提高这类迭代器的正确性而编写一个依赖于此异常的程序是错误做法：

此类是 Java Collections Framework 的成员。 

构造方法摘要

HashSet()            构造一个新的空集合，其底层 HashMap 实例的默认初始容量是 16，加载因子是 0.75。

HashSet(Collection<? extends E> c)            构造一个包含指定 collection 中的元素的新 set。

HashSet(int initialCapacity)            构造一个新的空集合，其底层 HashMap 实例具有指定的初始容量和默认的加载因子（0.75）。

HashSet(int initialCapacity, float loadFactor)            构造一个新的空集合，其底层 HashMap 实例具有指定的初始容量和指定的加载因子。

方法摘要

boolean	add(E o)            如果此集合中还不包含指定元素，则添加指定元素。
void	clear()            从此集合中移除所有元素。
Object	clone()            返回此 HashSet 实例的浅表复制：并没有克隆这些元素本身。
boolean	contains(Object o)            Returns 如果此集合不包含指定元素，则返回 true。
boolean	isEmpty()            如果此集合不包含任何元素，则返回 true。
Iterator<E>	iterator()            返回对此集合中元素进行迭代的迭代器。
boolean	remove(Object o)            如果指定元素存在于此集合中，则将其移除。
int	size()            返回此集合中的元素的数量（集合的容量）。

 

构造方法详细信息

HashSet

public HashSet()

构造一个新的空集合，其底层  HashMap 实例的默认初始容量是 16，加载因子是 0.75。 

---

HashSet

public HashSet(Collection<? extends E> c)

构造一个包含指定 collection 中的元素的新 set。使用默认的加载因子 0.75 和足以包含指定集合中所有元素的初始容量来创建  HashMap。 

参数：

c - 其中的元素将存放在此 set 中的 collection。 

抛出：

NullPointerException - 如果指定的 collection 为 null。

---

HashSet

public HashSet(int initialCapacity,
               float loadFactor)

构造一个新的空集合，其底层  HashMap 实例具有指定的初始容量和指定的加载因子。 

参数：

initialCapacity - 哈希映射的初始容量。 

loadFactor - 哈希映射的加载因子。 

抛出：

IllegalArgumentException - 如果初始容量小于零，或者加载因子为非正数。

---

HashSet

public HashSet(int initialCapacity)

构造一个新的空集合，其底层  HashMap 实例具有指定的初始容量和默认的加载因子（ 0.75）。 

参数：

initialCapacity - 哈希表的初始容量。 

抛出：

IllegalArgumentException - 如果初始容量小于零。

方法详细信息

iterator

public Iterator<E> iterator()

返回对此集合中元素进行迭代的迭代器。返回元素的顺序并不是特定的。 

指定者：

接口  Iterable<E> 中的  iterator

指定者：

接口  Collection<E> 中的  iterator

指定者：

接口  Set<E> 中的  iterator

指定者：

类  AbstractCollection<E> 中的  iterator

返回：

对此集合中元素进行迭代的 Iterator。 

另请参见：

ConcurrentModificationException

---

size

public int size()

返回此集合中的元素的数量（集合的容量）。 

指定者：

接口  Collection<E> 中的  size

指定者：

接口  Set<E> 中的  size

指定者：

类  AbstractCollection<E> 中的  size

返回：

此集合中的元素的数量（集合的容量）。

---

isEmpty

public boolean isEmpty()

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

指定者：

接口  Collection<E> 中的  isEmpty

指定者：

接口  Set<E> 中的  isEmpty

覆盖：

类  AbstractCollection<E> 中的  isEmpty

返回：

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

---

contains

public boolean contains(Object o)

Returns 如果此集合不包含指定元素，则返回  true。 

指定者：

接口  Collection<E> 中的  contains

指定者：

接口  Set<E> 中的  contains

覆盖：

类  AbstractCollection<E> 中的  contains

参数：

o - 其在此集合中的存在已得到测试的元素。 

返回：

如果此集合不包含指定元素，则返回  true。

---

add

public boolean add(E o)

如果此集合中还不包含指定元素，则添加指定元素。 

指定者：

接口  Collection<E> 中的  add

指定者：

接口  Set<E> 中的  add

覆盖：

类  AbstractCollection<E> 中的  add

参数：

o - 将添加到此集合中的元素。 

返回：

如果该集合还不包含指定元素，则返回  true。

---

remove

public boolean remove(Object o)

如果指定元素存在于此集合中，则将其移除。 

指定者：

接口  Collection<E> 中的  remove

指定者：

接口  Set<E> 中的  remove

覆盖：

类  AbstractCollection<E> 中的  remove

参数：

o - 如果存在于此集合中则需要将其移除的对象。 

返回：

如果集合包含指定元素，则返回  true。

---

clear

public void clear()

从此集合中移除所有元素。 

指定者：

接口  Collection<E> 中的  clear

指定者：

接口  Set<E> 中的  clear

覆盖：

类  AbstractCollection<E> 中的  clear

---

clone

public Object clone()

返回此  HashSet 实例的浅表复制：并没有克隆这些元素本身。 

覆盖：

类  Object 中的  clone

返回：

此集合的浅表复制。 

另请参见：

Cloneable