Java多线程系列--“JUC集合”03之 CopyOnWriteArraySet

 

概要

本章是JUC系列中的CopyOnWriteArraySet篇。接下来,会先对CopyOnWriteArraySet进行基本介绍,然后再说明它的原理,接着通过代码去分析,最后通过示例更进一步的了解CopyOnWriteArraySet。内容包括:
CopyOnWriteArraySet介绍
CopyOnWriteArraySet原理和数据结构
CopyOnWriteArraySet函数列表
CopyOnWriteArraySet源码(JDK1.7.0_40版本)
CopyOnWriteArraySet示例

转载请注明出处:http://www.cnblogs.com/skywang12345/p/3498497.html

 

CopyOnWriteArraySet介绍

它是线程安全的无序的集合,可以将它理解成线程安全的HashSet有意思的是,CopyOnWriteArraySet和HashSet虽然都继承于共同的父类AbstractSet;但是,HashSet是通过“散列表(HashMap)”实现的,而CopyOnWriteArraySet则是通过“动态数组(CopyOnWriteArrayList)”实现的,并不是散列表。
和CopyOnWriteArrayList类似,CopyOnWriteArraySet具有以下特性:
1. 它最适合于具有以下特征的应用程序:Set 大小通常保持很小,只读操作远多于可变操作,需要在遍历期间防止线程间的冲突。
2. 它是线程安全的。
3. 因为通常需要复制整个基础数组,所以可变操作(add()、set() 和 remove() 等等)的开销很大。
4. 迭代器支持hasNext(), next()等不可变操作,但不支持可变 remove()等 操作。
5. 使用迭代器进行遍历的速度很快,并且不会与其他线程发生冲突。在构造迭代器时,迭代器依赖于不变的数组快照。

建议:在学习CopyOnWriteArraySet之前,先通过"Java 集合系列16之 HashSet详细介绍(源码解析)和使用示例"对HashSet进行了解。

 

CopyOnWriteArraySet原理和数据结构

CopyOnWriteArraySet的数据结构,如下图所示:

Java多线程系列--“JUC集合”03之 CopyOnWriteArraySet

说明
  1. CopyOnWriteArraySet继承于AbstractSet,这就意味着它是一个集合。
  2. CopyOnWriteArraySet包含CopyOnWriteArrayList对象,它是通过CopyOnWriteArrayList实现的。而CopyOnWriteArrayList本质是个动态数组队列,
所以CopyOnWriteArraySet相当于通过通过动态数组实现的“集合”! CopyOnWriteArrayList中允许有重复的元素;但是,CopyOnWriteArraySet是一个集合,所以它不能有重复集合。因此,CopyOnWriteArrayList额外提供了addIfAbsent()和addAllAbsent()这两个添加元素的API,通过这些API来添加元素时,只有当元素不存在时才执行添加操作!
   至于CopyOnWriteArraySet的“线程安全”机制,和CopyOnWriteArrayList一样,是通过volatile和互斥锁来实现的。这个在前一章节介绍CopyOnWriteArrayList时数据结构时,已经进行了说明,这里就不再重复叙述了。

 

CopyOnWriteArraySet函数列表

Java多线程系列--“JUC集合”03之 CopyOnWriteArraySet
// 创建一个空 set。
CopyOnWriteArraySet()
// 创建一个包含指定 collection 所有元素的 set。
CopyOnWriteArraySet(Collection<? extends E> c)

// 如果指定元素并不存在于此 set 中,则添加它。
boolean add(E e)
// 如果此 set 中没有指定 collection 中的所有元素,则将它们都添加到此 set 中。
boolean addAll(Collection<? extends E> c)
// 移除此 set 中的所有元素。
void clear()
// 如果此 set 包含指定元素,则返回 true。
boolean contains(Object o)
// 如果此 set 包含指定 collection 的所有元素,则返回 true。
boolean containsAll(Collection<?> c)
// 比较指定对象与此 set 的相等性。
boolean equals(Object o)
// 如果此 set 不包含任何元素,则返回 true。
boolean isEmpty()
// 返回按照元素添加顺序在此 set 中包含的元素上进行迭代的迭代器。
Iterator<E> iterator()
// 如果指定元素存在于此 set 中,则将其移除。
boolean remove(Object o)
// 移除此 set 中包含在指定 collection 中的所有元素。
boolean removeAll(Collection<?> c)
// 仅保留此 set 中那些包含在指定 collection 中的元素。
boolean retainAll(Collection<?> c)
// 返回此 set 中的元素数目。
int size()
// 返回一个包含此 set 所有元素的数组。
Object[] toArray()
// 返回一个包含此 set 所有元素的数组;返回数组的运行时类型是指定数组的类型。
<T> T[] toArray(T[] a)
Java多线程系列--“JUC集合”03之 CopyOnWriteArraySet

 

CopyOnWriteArraySet源码(JDK1.7.0_40版本)

CopyOnWriteArraySet.java的完整源码如下:

Java多线程系列--“JUC集合”03之 CopyOnWriteArraySet
  1 /*
  2  * ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
  3  *
  4  *
  5  *
  6  *
  7  *
  8  *
  9  *
 10  *
 11  *
 12  *
 13  *
 14  *
 15  *
 16  *
 17  *
 18  *
 19  *
 20  *
 21  *
 22  *
 23  */
 24 
 25 /*
 26  *
 27  *
 28  *
 29  *
 30  *
 31  * Written by Doug Lea with assistance from members of JCP JSR-166
 32  * Expert Group and released to the public domain, as explained at
 33  * http://creativecommons.org/publicdomain/zero/1.0/
 34  */
 35 
 36 package java.util.concurrent;
 37 import java.util.*;
 38 
 39 /**
 40  * A {@link java.util.Set} that uses an internal {@link CopyOnWriteArrayList}
 41  * for all of its operations.  Thus, it shares the same basic properties:
 42  * <ul>
 43  *  <li>It is best suited for applications in which set sizes generally
 44  *       stay small, read-only operations
 45  *       vastly outnumber mutative operations, and you need
 46  *       to prevent interference among threads during traversal.
 47  *  <li>It is thread-safe.
 48  *  <li>Mutative operations (<tt>add</tt>, <tt>set</tt>, <tt>remove</tt>, etc.)
 49  *      are expensive since they usually entail copying the entire underlying
 50  *      array.
 51  *  <li>Iterators do not support the mutative <tt>remove</tt> operation.
 52  *  <li>Traversal via iterators is fast and cannot encounter
 53  *      interference from other threads. Iterators rely on
 54  *      unchanging snapshots of the array at the time the iterators were
 55  *      constructed.
 56  * </ul>
 57  *
 58  * <p> <b>Sample Usage.</b> The following code sketch uses a
 59  * copy-on-write set to maintain a set of Handler objects that
 60  * perform some action upon state updates.
 61  *
 62  *  <pre> {@code
 63  * class Handler { void handle(); ... }
 64  *
 65  * class X {
 66  *   private final CopyOnWriteArraySet<Handler> handlers
 67  *     = new CopyOnWriteArraySet<Handler>();
 68  *   public void addHandler(Handler h) { handlers.add(h); }
 69  *
 70  *   private long internalState;
 71  *   private synchronized void changeState() { internalState = ...; }
 72  *
 73  *   public void update() {
 74  *     changeState();
 75  *     for (Handler handler : handlers)
 76  *        handler.handle();
 77  *   }
 78  * }}</pre>
 79  *
 80  * <p>This class is a member of the
 81  * <a href="{@docRoot}/../technotes/guides/collections/index.html">
 82  * Java Collections Framework</a>.
 83  *
 84  * @see CopyOnWriteArrayList
 85  * @since 1.5
 86  * @author Doug Lea
 87  * @param <E> the type of elements held in this collection
 88  */
 89 public class CopyOnWriteArraySet<E> extends AbstractSet<E>
 90         implements java.io.Serializable {
 91     private static final long serialVersionUID = 5457747651344034263L;
 92 
 93     private final CopyOnWriteArrayList<E> al;
 94 
 95     /**
 96      * Creates an empty set.
 97      */
 98     public CopyOnWriteArraySet() {
 99         al = new CopyOnWriteArrayList<E>();
100     }
101 
102     /**
103      * Creates a set containing all of the elements of the specified
104      * collection.
105      *
106      * @param c the collection of elements to initially contain
107      * @throws NullPointerException if the specified collection is null
108      */
109     public CopyOnWriteArraySet(Collection<? extends E> c) {
110         al = new CopyOnWriteArrayList<E>();
111         al.addAllAbsent(c);
112     }
113 
114     /**
115      * Returns the number of elements in this set.
116      *
117      * @return the number of elements in this set
118      */
119     public int size() {
120         return al.size();
121     }
122 
123     /**
124      * Returns <tt>true</tt> if this set contains no elements.
125      *
126      * @return <tt>true</tt> if this set contains no elements
127      */
128     public boolean isEmpty() {
129         return al.isEmpty();
130     }
131 
132     /**
133      * Returns <tt>true</tt> if this set contains the specified element.
134      * More formally, returns <tt>true</tt> if and only if this set
135      * contains an element <tt>e</tt> such that
136      * <tt>(o==null&nbsp;?&nbsp;e==null&nbsp;:&nbsp;o.equals(e))</tt>.
137      *
138      * @param o element whose presence in this set is to be tested
139      * @return <tt>true</tt> if this set contains the specified element
140      */
141     public boolean contains(Object o) {
142         return al.contains(o);
143     }
144 
145     /**
146      * Returns an array containing all of the elements in this set.
147      * If this set makes any guarantees as to what order its elements
148      * are returned by its iterator, this method must return the
149      * elements in the same order.
150      *
151      * <p>The returned array will be "safe" in that no references to it
152      * are maintained by this set.  (In other words, this method must
153      * allocate a new array even if this set is backed by an array).
154      * The caller is thus free to modify the returned array.
155      *
156      * <p>This method acts as bridge between array-based and collection-based
157      * APIs.
158      *
159      * @return an array containing all the elements in this set
160      */
161     public Object[] toArray() {
162         return al.toArray();
163     }
164 
165     /**
166      * Returns an array containing all of the elements in this set; the
167      * runtime type of the returned array is that of the specified array.
168      * If the set fits in the specified array, it is returned therein.
169      * Otherwise, a new array is allocated with the runtime type of the
170      * specified array and the size of this set.
171      *
172      * <p>If this set fits in the specified array with room to spare
173      * (i.e., the array has more elements than this set), the element in
174      * the array immediately following the end of the set is set to
175      * <tt>null</tt>.  (This is useful in determining the length of this
176      * set <i>only</i> if the caller knows that this set does not contain
177      * any null elements.)
178      *
179      * <p>If this set makes any guarantees as to what order its elements
180      * are returned by its iterator, this method must return the elements
181      * in the same order.
182      *
183      * <p>Like the {@link #toArray()} method, this method acts as bridge between
184      * array-based and collection-based APIs.  Further, this method allows
185      * precise control over the runtime type of the output array, and may,
186      * under certain circumstances, be used to save allocation costs.
187      *
188      * <p>Suppose <tt>x</tt> is a set known to contain only strings.
189      * The following code can be used to dump the set into a newly allocated
190      * array of <tt>String</tt>:
191      *
192      * <pre>
193      *     String[] y = x.toArray(new String[0]);</pre>
194      *
195      * Note that <tt>toArray(new Object[0])</tt> is identical in function to
196      * <tt>toArray()</tt>.
197      *
198      * @param a the array into which the elements of this set are to be
199      *        stored, if it is big enough; otherwise, a new array of the same
200      *        runtime type is allocated for this purpose.
201      * @return an array containing all the elements in this set
202      * @throws ArrayStoreException if the runtime type of the specified array
203      *         is not a supertype of the runtime type of every element in this
204      *         set
205      * @throws NullPointerException if the specified array is null
206      */
207     public <T> T[] toArray(T[] a) {
208         return al.toArray(a);
209     }
210 
211     /**
212      * Removes all of the elements from this set.
213      * The set will be empty after this call returns.
214      */
215     public void clear() {
216         al.clear();
217     }
218 
219     /**
220      * Removes the specified element from this set if it is present.
221      * More formally, removes an element <tt>e</tt> such that
222      * <tt>(o==null&nbsp;?&nbsp;e==null&nbsp;:&nbsp;o.equals(e))</tt>,
223      * if this set contains such an element.  Returns <tt>true</tt> if
224      * this set contained the element (or equivalently, if this set
225      * changed as a result of the call).  (This set will not contain the
226      * element once the call returns.)
227      *
228      * @param o object to be removed from this set, if present
229      * @return <tt>true</tt> if this set contained the specified element
230      */
231     public boolean remove(Object o) {
232         return al.remove(o);
233     }
234 
235     /**
236      * Adds the specified element to this set if it is not already present.
237      * More formally, adds the specified element <tt>e</tt> to this set if
238      * the set contains no element <tt>e2</tt> such that
239      * <tt>(e==null&nbsp;?&nbsp;e2==null&nbsp;:&nbsp;e.equals(e2))</tt>.
240      * If this set already contains the element, the call leaves the set
241      * unchanged and returns <tt>false</tt>.
242      *
243      * @param e element to be added to this set
244      * @return <tt>true</tt> if this set did not already contain the specified
245      *         element
246      */
247     public boolean add(E e) {
248         return al.addIfAbsent(e);
249     }
250 
251     /**
252      * Returns <tt>true</tt> if this set contains all of the elements of the
253      * specified collection.  If the specified collection is also a set, this
254      * method returns <tt>true</tt> if it is a <i>subset</i> of this set.
255      *
256      * @param  c collection to be checked for containment in this set
257      * @return <tt>true</tt> if this set contains all of the elements of the
258      *         specified collection
259      * @throws NullPointerException if the specified collection is null
260      * @see #contains(Object)
261      */
262     public boolean containsAll(Collection<?> c) {
263         return al.containsAll(c);
264     }
265 
266     /**
267      * Adds all of the elements in the specified collection to this set if
268      * they‘re not already present.  If the specified collection is also a
269      * set, the <tt>addAll</tt> operation effectively modifies this set so
270      * that its value is the <i>union</i> of the two sets.  The behavior of
271      * this operation is undefined if the specified collection is modified
272      * while the operation is in progress.
273      *
274      * @param  c collection containing elements to be added to this set
275      * @return <tt>true</tt> if this set changed as a result of the call
276      * @throws NullPointerException if the specified collection is null
277      * @see #add(Object)
278      */
279     public boolean addAll(Collection<? extends E> c) {
280         return al.addAllAbsent(c) > 0;
281     }
282 
283     /**
284      * Removes from this set all of its elements that are contained in the
285      * specified collection.  If the specified collection is also a set,
286      * this operation effectively modifies this set so that its value is the
287      * <i>asymmetric set difference</i> of the two sets.
288      *
289      * @param  c collection containing elements to be removed from this set
290      * @return <tt>true</tt> if this set changed as a result of the call
291      * @throws ClassCastException if the class of an element of this set
292      *         is incompatible with the specified collection (optional)
293      * @throws NullPointerException if this set contains a null element and the
294      *         specified collection does not permit null elements (optional),
295      *         or if the specified collection is null
296      * @see #remove(Object)
297      */
298     public boolean removeAll(Collection<?> c) {
299         return al.removeAll(c);
300     }
301 
302     /**
303      * Retains only the elements in this set that are contained in the
304      * specified collection.  In other words, removes from this set all of
305      * its elements that are not contained in the specified collection.  If
306      * the specified collection is also a set, this operation effectively
307      * modifies this set so that its value is the <i>intersection</i> of the
308      * two sets.
309      *
310      * @param  c collection containing elements to be retained in this set
311      * @return <tt>true</tt> if this set changed as a result of the call
312      * @throws ClassCastException if the class of an element of this set
313      *         is incompatible with the specified collection (optional)
314      * @throws NullPointerException if this set contains a null element and the
315      *         specified collection does not permit null elements (optional),
316      *         or if the specified collection is null
317      * @see #remove(Object)
318      */
319     public boolean retainAll(Collection<?> c) {
320         return al.retainAll(c);
321     }
322 
323     /**
324      * Returns an iterator over the elements contained in this set
325      * in the order in which these elements were added.
326      *
327      * <p>The returned iterator provides a snapshot of the state of the set
328      * when the iterator was constructed. No synchronization is needed while
329      * traversing the iterator. The iterator does <em>NOT</em> support the
330      * <tt>remove</tt> method.
331      *
332      * @return an iterator over the elements in this set
333      */
334     public Iterator<E> iterator() {
335         return al.iterator();
336     }
337 
338     /**
339      * Compares the specified object with this set for equality.
340      * Returns {@code true} if the specified object is the same object
341      * as this object, or if it is also a {@link Set} and the elements
342      * returned by an {@linkplain List#iterator() iterator} over the
343      * specified set are the same as the elements returned by an
344      * iterator over this set.  More formally, the two iterators are
345      * considered to return the same elements if they return the same
346      * number of elements and for every element {@code e1} returned by
347      * the iterator over the specified set, there is an element
348      * {@code e2} returned by the iterator over this set such that
349      * {@code (e1==null ? e2==null : e1.equals(e2))}.
350      *
351      * @param o object to be compared for equality with this set
352      * @return {@code true} if the specified object is equal to this set
353      */
354     public boolean equals(Object o) {
355         if (o == this)
356             return true;
357         if (!(o instanceof Set))
358             return false;
359         Set<?> set = (Set<?>)(o);
360         Iterator<?> it = set.iterator();
361 
362         // Uses O(n^2) algorithm that is only appropriate
363         // for small sets, which CopyOnWriteArraySets should be.
364 
365         //  Use a single snapshot of underlying array
366         Object[] elements = al.getArray();
367         int len = elements.length;
368         // Mark matched elements to avoid re-checking
369         boolean[] matched = new boolean[len];
370         int k = 0;
371         outer: while (it.hasNext()) {
372             if (++k > len)
373                 return false;
374             Object x = it.next();
375             for (int i = 0; i < len; ++i) {
376                 if (!matched[i] && eq(x, elements[i])) {
377                     matched[i] = true;
378                     continue outer;
379                 }
380             }
381             return false;
382         }
383         return k == len;
384     }
385 
386     /**
387      * Test for equality, coping with nulls.
388      */
389     private static boolean eq(Object o1, Object o2) {
390         return (o1 == null ? o2 == null : o1.equals(o2));
391     }
392 }
View Code

CopyOnWriteArraySet是通过CopyOnWriteArrayList实现的,它的API基本上都是通过调用CopyOnWriteArrayList的API来实现的。相信对CopyOnWriteArrayList了解的话,对CopyOnWriteArraySet的了解是水到渠成的事;所以,这里就不再对CopyOnWriteArraySet的代码进行详细的解析了。若对CopyOnWriteArrayList不了解,请参考“Java多线程系列--“JUC集合”02之 CopyOnWriteArrayList”。

 

CopyOnWriteArraySet示例

下面,我们通过一个例子去对比HashSet和CopyOnWriteArraySet。

Java多线程系列--“JUC集合”03之 CopyOnWriteArraySet
import java.util.*;
import java.util.concurrent.*;

/*
 *   CopyOnWriteArraySet是“线程安全”的集合,而HashSet是非线程安全的。
 *
 *   下面是“多个线程同时操作并且遍历集合set”的示例
 *   (01) 当set是CopyOnWriteArraySet对象时,程序能正常运行。
 *   (02) 当set是HashSet对象时,程序会产生ConcurrentModificationException异常。
 *
 * @author skywang
 */
public class CopyOnWriteArraySetTest1 {

    // TODO: set是HashSet对象时,程序会出错。
    //private static Set<String> set = new HashSet<String>();
    private static Set<String> set = new CopyOnWriteArraySet<String>();
    public static void main(String[] args) {
    
        // 同时启动两个线程对set进行操作!
        new MyThread("ta").start();
        new MyThread("tb").start();
    }

    private static void printAll() {
        String value = null;
        Iterator iter = set.iterator();
        while(iter.hasNext()) {
            value = (String)iter.next();
            System.out.print(value+", ");
        }
        System.out.println();
    }

    private static class MyThread extends Thread {
        MyThread(String name) {
            super(name);
        }
        @Override
        public void run() {
                int i = 0;
            while (i++ < 10) {
                // “线程名” + "-" + "序号"
                String val = Thread.currentThread().getName() + "-" + (i%6);
                set.add(val);
                // 通过“Iterator”遍历set。
                printAll();
            }
        }
    }
}
Java多线程系列--“JUC集合”03之 CopyOnWriteArraySet

(某一次)运行结果

Java多线程系列--“JUC集合”03之 CopyOnWriteArraySet
ta-1, tb-1, ta-1, 
tb-1, ta-1, 
tb-1, ta-1, ta-2, 
tb-1, ta-1, ta-2, tb-1, tb-2, 
ta-2, ta-1, tb-2, tb-1, ta-3, 
ta-2, ta-1, tb-2, tb-1, ta-3, ta-2, tb-3, 
tb-2, ta-1, ta-3, tb-1, tb-3, ta-2, ta-4, 
tb-2, ta-1, ta-3, tb-1, tb-3, ta-2, ta-4, tb-2, tb-4, 
ta-3, ta-1, tb-3, tb-1, ta-4, ta-2, tb-4, tb-2, ta-5, 
ta-3, ta-1, tb-3, tb-1, ta-4, ta-2, tb-4, tb-2, ta-5, ta-3, tb-5, 
tb-3, ta-1, ta-4, tb-1, tb-4, ta-2, ta-5, tb-2, tb-5, ta-3, ta-0, 
tb-3, ta-1, ta-4, tb-1, tb-4, ta-2, ta-5, tb-2, tb-5, ta-3, ta-0, tb-3, tb-0, 
ta-4, ta-1, tb-4, tb-1, ta-5, ta-2, tb-5, tb-2, ta-0, ta-3, tb-0, 
tb-3, ta-1, ta-4, tb-1, tb-4, ta-2, ta-5, tb-5, ta-0, tb-0, 
ta-1, tb-2, tb-1, ta-3, ta-2, tb-3, tb-2, ta-4, ta-3, tb-4, tb-3, ta-5, ta-4, tb-5, tb-4, ta-0, ta-5, tb-0, 
tb-5, ta-1, ta-0, tb-1, tb-0, 
ta-2, ta-1, tb-2, tb-1, ta-3, ta-2, tb-3, tb-2, ta-4, ta-3, tb-4, tb-3, ta-5, tb-5, ta-0, tb-0, 
ta-4, ta-1, tb-4, tb-1, ta-5, ta-2, tb-5, tb-2, ta-0, ta-3, tb-0, 
tb-3, ta-1, ta-4, tb-1, tb-4, ta-2, ta-5, tb-2, tb-5, ta-3, ta-0, tb-3, tb-0, 
ta-4, tb-4, ta-5, tb-5, ta-0, tb-0, 
Java多线程系列--“JUC集合”03之 CopyOnWriteArraySet

结果说明
由于set是集合对象,因此它不会包含重复的元素。
如果将源码中的set改成HashSet对象时,程序会产生ConcurrentModificationException异常。

 


更多内容

1. Java多线程系列--“JUC集合”01之 框架

2. Java多线程系列--“JUC集合”02之 CopyOnWriteArrayLis

3. Java多线程系列目录(共xx篇)

4. Java 集合系列目录(Category)

 

Java多线程系列--“JUC集合”03之 CopyOnWriteArraySet

上一篇:ASP.NET MVC5学习笔记之Controller同步执行架构分析


下一篇:MVC缓存02,使用数据层缓存,添加或修改时让缓存失效