OLD | NEW |
1 // Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file |
2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
4 | 4 |
5 part of dart.async; | 5 part of dart.async; |
6 | 6 |
7 /** Abstract and private interface for a place to put events. */ | 7 /** Abstract and private interface for a place to put events. */ |
8 abstract class _EventSink<T> { | 8 abstract class _EventSink<T> { |
9 void _add(T data); | 9 void _add(T data); |
10 void _addError(Object error, StackTrace stackTrace); | 10 void _addError(Object error, StackTrace stackTrace); |
(...skipping 18 matching lines...) Expand all Loading... |
29 * | 29 * |
30 * The only public methods are those of [StreamSubscription], so instances of | 30 * The only public methods are those of [StreamSubscription], so instances of |
31 * [_BufferingStreamSubscription] can be returned directly as a | 31 * [_BufferingStreamSubscription] can be returned directly as a |
32 * [StreamSubscription] without exposing internal functionality. | 32 * [StreamSubscription] without exposing internal functionality. |
33 * | 33 * |
34 * The [StreamController] is a public facing version of [Stream] and this class, | 34 * The [StreamController] is a public facing version of [Stream] and this class, |
35 * with some methods made public. | 35 * with some methods made public. |
36 * | 36 * |
37 * The user interface of [_BufferingStreamSubscription] are the following | 37 * The user interface of [_BufferingStreamSubscription] are the following |
38 * methods: | 38 * methods: |
| 39 * |
39 * * [_add]: Add a data event to the stream. | 40 * * [_add]: Add a data event to the stream. |
40 * * [_addError]: Add an error event to the stream. | 41 * * [_addError]: Add an error event to the stream. |
41 * * [_close]: Request to close the stream. | 42 * * [_close]: Request to close the stream. |
42 * * [_onCancel]: Called when the subscription will provide no more events, | 43 * * [_onCancel]: Called when the subscription will provide no more events, |
43 * either due to being actively canceled, or after sending a done event. | 44 * either due to being actively canceled, or after sending a done event. |
44 * * [_onPause]: Called when the subscription wants the event source to pause. | 45 * * [_onPause]: Called when the subscription wants the event source to pause. |
45 * * [_onResume]: Called when allowing new events after a pause. | 46 * * [_onResume]: Called when allowing new events after a pause. |
| 47 * |
46 * The user should not add new events when the subscription requests a paused, | 48 * The user should not add new events when the subscription requests a paused, |
47 * but if it happens anyway, the subscription will enqueue the events just as | 49 * but if it happens anyway, the subscription will enqueue the events just as |
48 * when new events arrive while still firing an old event. | 50 * when new events arrive while still firing an old event. |
49 */ | 51 */ |
50 class _BufferingStreamSubscription<T> implements StreamSubscription<T>, | 52 class _BufferingStreamSubscription<T> implements StreamSubscription<T>, |
51 _EventSink<T>, | 53 _EventSink<T>, |
52 _EventDispatch<T> { | 54 _EventDispatch<T> { |
53 /** The `cancelOnError` flag from the `listen` call. */ | 55 /** The `cancelOnError` flag from the `listen` call. */ |
54 static const int _STATE_CANCEL_ON_ERROR = 1; | 56 static const int _STATE_CANCEL_ON_ERROR = 1; |
55 /** | 57 /** |
(...skipping 29 matching lines...) Expand all Loading... |
85 /** Bit vector based on state-constants above. */ | 87 /** Bit vector based on state-constants above. */ |
86 int _state; | 88 int _state; |
87 | 89 |
88 /** | 90 /** |
89 * Queue of pending events. | 91 * Queue of pending events. |
90 * | 92 * |
91 * Is created when necessary, or set in constructor for preconfigured events. | 93 * Is created when necessary, or set in constructor for preconfigured events. |
92 */ | 94 */ |
93 _PendingEvents _pending; | 95 _PendingEvents _pending; |
94 | 96 |
95 _BufferingStreamSubscription(void onData(T data), | 97 _BufferingStreamSubscription(void onDataHandler(T data), |
96 Function onError, | 98 Function onErrorHandler, |
97 void onDone(), | 99 void onDoneHandler(), |
98 bool cancelOnError) | 100 bool cancelOnError) |
99 : _onData = Zone.current.registerUnaryCallback(onData), | 101 : _state = (cancelOnError ? _STATE_CANCEL_ON_ERROR : 0) { |
100 _onError = _registerErrorHandler(onError, Zone.current), | 102 onData(onDataHandler); |
101 _onDone = Zone.current.registerCallback(onDone), | 103 onError(onErrorHandler); |
102 _state = (cancelOnError ? _STATE_CANCEL_ON_ERROR : 0) { | 104 onDone(onDoneHandler); |
103 assert(_onData != null); | |
104 assert(_onError != null); | |
105 assert(_onDone != null); | |
106 } | 105 } |
107 | 106 |
108 /** | 107 /** |
109 * Sets the subscription's pending events object. | 108 * Sets the subscription's pending events object. |
110 * | 109 * |
111 * This can only be done once. The pending events object is used for the | 110 * This can only be done once. The pending events object is used for the |
112 * rest of the subscription's life cycle. | 111 * rest of the subscription's life cycle. |
113 */ | 112 */ |
114 void _setPendingEvents(_PendingEvents pendingEvents) { | 113 void _setPendingEvents(_PendingEvents pendingEvents) { |
115 assert(_pending == null); | 114 assert(_pending == null); |
(...skipping 882 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
998 _Future<bool> hasNext = _futureOrPrefetch; | 997 _Future<bool> hasNext = _futureOrPrefetch; |
999 _clear(); | 998 _clear(); |
1000 hasNext._complete(false); | 999 hasNext._complete(false); |
1001 return; | 1000 return; |
1002 } | 1001 } |
1003 _subscription.pause(); | 1002 _subscription.pause(); |
1004 _futureOrPrefetch = null; | 1003 _futureOrPrefetch = null; |
1005 _state = _STATE_EXTRA_DONE; | 1004 _state = _STATE_EXTRA_DONE; |
1006 } | 1005 } |
1007 } | 1006 } |
OLD | NEW |