Print this page


Split Close
Expand all
Collapse all
          --- old/src/share/classes/java/util/concurrent/CopyOnWriteArraySet.java
          +++ new/src/share/classes/java/util/concurrent/CopyOnWriteArraySet.java
↓ open down ↓ 51 lines elided ↑ open up ↑
  52   52   *  <li>Traversal via iterators is fast and cannot encounter
  53   53   *      interference from other threads. Iterators rely on
  54   54   *      unchanging snapshots of the array at the time the iterators were
  55   55   *      constructed.
  56   56   * </ul>
  57   57   *
  58   58   * <p> <b>Sample Usage.</b> The following code sketch uses a
  59   59   * copy-on-write set to maintain a set of Handler objects that
  60   60   * perform some action upon state updates.
  61   61   *
  62      - * <pre>
       62 + *  <pre> {@code
  63   63   * class Handler { void handle(); ... }
  64   64   *
  65   65   * class X {
  66      - *    private final CopyOnWriteArraySet&lt;Handler&gt; handlers
  67      - *       = new CopyOnWriteArraySet&lt;Handler&gt;();
  68      - *    public void addHandler(Handler h) { handlers.add(h); }
       66 + *   private final CopyOnWriteArraySet<Handler> handlers
       67 + *     = new CopyOnWriteArraySet<Handler>();
       68 + *   public void addHandler(Handler h) { handlers.add(h); }
  69   69   *
  70      - *    private long internalState;
  71      - *    private synchronized void changeState() { internalState = ...; }
       70 + *   private long internalState;
       71 + *   private synchronized void changeState() { internalState = ...; }
  72   72   *
  73      - *    public void update() {
  74      - *       changeState();
  75      - *       for (Handler handler : handlers)
  76      - *          handler.handle();
  77      - *    }
  78      - * }
  79      - * </pre>
       73 + *   public void update() {
       74 + *     changeState();
       75 + *     for (Handler handler : handlers)
       76 + *        handler.handle();
       77 + *   }
       78 + * }}</pre>
  80   79   *
  81   80   * <p>This class is a member of the
  82   81   * <a href="{@docRoot}/../technotes/guides/collections/index.html">
  83   82   * Java Collections Framework</a>.
  84   83   *
  85   84   * @see CopyOnWriteArrayList
  86   85   * @since 1.5
  87   86   * @author Doug Lea
  88   87   * @param <E> the type of elements held in this collection
  89   88   */
↓ open down ↓ 304 lines elided ↑ open up ↑
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX