Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(279)

Side by Side Diff: lib/src/stream_group.dart

Issue 2660333005: Change generic comment syntax to real generic syntax. (Closed)
Patch Set: Created 3 years, 10 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
OLDNEW
1 // Copyright (c) 2015, the Dart project authors. Please see the AUTHORS file 1 // Copyright (c) 2015, 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 import 'dart:async'; 5 import 'dart:async';
6 6
7 /// A collection of streams whose events are unified and sent through a central 7 /// A collection of streams whose events are unified and sent through a central
8 /// stream. 8 /// stream.
9 /// 9 ///
10 /// Both errors and data events are forwarded through [stream]. The streams in 10 /// Both errors and data events are forwarded through [stream]. The streams in
(...skipping 35 matching lines...) Expand 10 before | Expand all | Expand 10 after
46 /// If it's a broadcast group and it goes dormant again, broadcast stream 46 /// If it's a broadcast group and it goes dormant again, broadcast stream
47 /// subscriptions will be canceled and set to null again. Single-subscriber 47 /// subscriptions will be canceled and set to null again. Single-subscriber
48 /// stream subscriptions will be left intact, since they can't be 48 /// stream subscriptions will be left intact, since they can't be
49 /// re-subscribed. 49 /// re-subscribed.
50 final _subscriptions = new Map<Stream<T>, StreamSubscription<T>>(); 50 final _subscriptions = new Map<Stream<T>, StreamSubscription<T>>();
51 51
52 /// Merges the events from [streams] into a single (single-subscriber) stream. 52 /// Merges the events from [streams] into a single (single-subscriber) stream.
53 /// 53 ///
54 /// This is equivalent to adding [streams] to a group, closing that group, and 54 /// This is equivalent to adding [streams] to a group, closing that group, and
55 /// returning its stream. 55 /// returning its stream.
56 static Stream/*<T>*/ merge/*<T>*/(Iterable<Stream/*<T>*/> streams) { 56 static Stream<T> merge<T>(Iterable<Stream<T>> streams) {
57 var group = new StreamGroup/*<T>*/(); 57 var group = new StreamGroup<T>();
58 streams.forEach(group.add); 58 streams.forEach(group.add);
59 group.close(); 59 group.close();
60 return group.stream; 60 return group.stream;
61 } 61 }
62 62
63 /// Creates a new stream group where [stream] is single-subscriber. 63 /// Creates a new stream group where [stream] is single-subscriber.
64 StreamGroup() { 64 StreamGroup() {
65 _controller = new StreamController<T>( 65 _controller = new StreamController<T>(
66 onListen: _onListen, 66 onListen: _onListen,
67 onPause: _onPause, 67 onPause: _onPause,
68 onResume: _onResume, 68 onResume: _onResume,
69 onCancel: _onCancel, 69 onCancel: _onCancel,
70 sync: true); 70 sync: true);
71 } 71 }
72 72
73 /// Creates a new stream group where [stream] is a broadcast stream. 73 /// Creates a new stream group where [stream] is a broadcast stream.
74 StreamGroup.broadcast() { 74 StreamGroup.broadcast() {
75 _controller = new StreamController<T>.broadcast( 75 _controller = new StreamController<T>.broadcast(
76 onListen: _onListen, 76 onListen: _onListen, onCancel: _onCancelBroadcast, sync: true);
77 onCancel: _onCancelBroadcast,
78 sync: true);
79 } 77 }
80 78
81 /// Adds [stream] as a member of this group. 79 /// Adds [stream] as a member of this group.
82 /// 80 ///
83 /// Any events from [stream] will be emitted through [this.stream]. If this 81 /// Any events from [stream] will be emitted through [this.stream]. If this
84 /// group has a listener, [stream] will be listened to immediately; otherwise 82 /// group has a listener, [stream] will be listened to immediately; otherwise
85 /// it will only be listened to once this group gets a listener. 83 /// it will only be listened to once this group gets a listener.
86 /// 84 ///
87 /// If this is a single-subscription group and its subscription has been 85 /// If this is a single-subscription group and its subscription has been
88 /// canceled, [stream] will be canceled as soon as its added. If this returns 86 /// canceled, [stream] will be canceled as soon as its added. If this returns
(...skipping 97 matching lines...) Expand 10 before | Expand all | Expand 10 after
186 if (!stream.isBroadcast) return; 184 if (!stream.isBroadcast) return;
187 subscription.cancel(); 185 subscription.cancel();
188 _subscriptions[stream] = null; 186 _subscriptions[stream] = null;
189 }); 187 });
190 } 188 }
191 189
192 /// Starts actively forwarding events from [stream] to [_controller]. 190 /// Starts actively forwarding events from [stream] to [_controller].
193 /// 191 ///
194 /// This will pause the resulting subscription if [this] is paused. 192 /// This will pause the resulting subscription if [this] is paused.
195 StreamSubscription<T> _listenToStream(Stream<T> stream) { 193 StreamSubscription<T> _listenToStream(Stream<T> stream) {
196 var subscription = stream.listen( 194 var subscription = stream.listen(_controller.add,
197 _controller.add, 195 onError: _controller.addError, onDone: () => remove(stream));
198 onError: _controller.addError,
199 onDone: () => remove(stream));
200 if (_state == _StreamGroupState.paused) subscription.pause(); 196 if (_state == _StreamGroupState.paused) subscription.pause();
201 return subscription; 197 return subscription;
202 } 198 }
203 199
204 /// Closes the group, indicating that no more streams will be added. 200 /// Closes the group, indicating that no more streams will be added.
205 /// 201 ///
206 /// If there are no streams in the group, [stream] is closed immediately. 202 /// If there are no streams in the group, [stream] is closed immediately.
207 /// Otherwise, [stream] will close once all streams in the group close. 203 /// Otherwise, [stream] will close once all streams in the group close.
208 /// 204 ///
209 /// Returns a [Future] that completes once [stream] has actually been closed. 205 /// Returns a [Future] that completes once [stream] has actually been closed.
(...skipping 38 matching lines...) Expand 10 before | Expand all | Expand 10 after
248 244
249 /// The name of the state. 245 /// The name of the state.
250 /// 246 ///
251 /// Used for debugging. 247 /// Used for debugging.
252 final String name; 248 final String name;
253 249
254 const _StreamGroupState(this.name); 250 const _StreamGroupState(this.name);
255 251
256 String toString() => name; 252 String toString() => name;
257 } 253 }
OLDNEW

Powered by Google App Engine
This is Rietveld 408576698