| OLD | NEW |
| 1 // Copyright 2013 The Chromium Authors. All rights reserved. | 1 // Copyright 2013 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 package org.chromium.base; | 5 package org.chromium.base; |
| 6 | 6 |
| 7 import java.util.ArrayList; | 7 import java.util.ArrayList; |
| 8 import java.util.Iterator; | 8 import java.util.Iterator; |
| 9 import java.util.List; | 9 import java.util.List; |
| 10 import java.util.NoSuchElementException; | 10 import java.util.NoSuchElementException; |
| 11 | 11 |
| 12 import javax.annotation.concurrent.NotThreadSafe; | 12 import javax.annotation.concurrent.NotThreadSafe; |
| 13 | 13 |
| 14 /** | 14 /** |
| 15 * A container for a list of observers. | 15 * A container for a list of observers. |
| 16 * <p/> | 16 * <p/> |
| 17 * This container can be modified during iteration without invalidating the iter
ator. | 17 * This container can be modified during iteration without invalidating the iter
ator. |
| 18 * So, it safely handles the case of an observer removing itself or other observ
ers from the list | 18 * So, it safely handles the case of an observer removing itself or other observ
ers from the list |
| 19 * while observers are being notified. | 19 * while observers are being notified. |
| 20 * <p/> | 20 * <p/> |
| 21 * The implementation (and the interface) is heavily influenced by the C++ Obser
verList. | 21 * The implementation (and the interface) is heavily influenced by the C++ Obser
verList. |
| 22 * Notable differences: | 22 * Notable differences: |
| 23 * - The iterator implements NOTIFY_EXISTING_ONLY. | 23 * - The iterator implements NOTIFY_EXISTING_ONLY. |
| 24 * - The FOR_EACH_OBSERVER closure is left to the clients to implement in term
s of iterator(). | 24 * - The range-based for loop is left to the clients to implement in terms of
iterator(). |
| 25 * <p/> | 25 * <p/> |
| 26 * This class is not threadsafe. Observers MUST be added, removed and will be no
tified on the same | 26 * This class is not threadsafe. Observers MUST be added, removed and will be no
tified on the same |
| 27 * thread this is created. | 27 * thread this is created. |
| 28 * | 28 * |
| 29 * @param <E> The type of observers that this list should hold. | 29 * @param <E> The type of observers that this list should hold. |
| 30 */ | 30 */ |
| 31 @NotThreadSafe | 31 @NotThreadSafe |
| 32 public class ObserverList<E> implements Iterable<E> { | 32 public class ObserverList<E> implements Iterable<E> { |
| 33 /** | 33 /** |
| 34 * Extended iterator interface that provides rewind functionality. | 34 * Extended iterator interface that provides rewind functionality. |
| (...skipping 205 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 240 } | 240 } |
| 241 | 241 |
| 242 private void compactListIfNeeded() { | 242 private void compactListIfNeeded() { |
| 243 if (!mIsExhausted) { | 243 if (!mIsExhausted) { |
| 244 mIsExhausted = true; | 244 mIsExhausted = true; |
| 245 ObserverList.this.decrementIterationDepthAndCompactIfNeeded(); | 245 ObserverList.this.decrementIterationDepthAndCompactIfNeeded(); |
| 246 } | 246 } |
| 247 } | 247 } |
| 248 } | 248 } |
| 249 } | 249 } |
| OLD | NEW |