如何在Dart中创建StreamTransformer？

Question

尝试构建一个自定义StreamTransformer类,但是很多示例似乎已经过时了,文档中找到的那些不是(某些类型语言可能会考虑的)作为一个类(在这里找到:https ://api.dartlang.org/apidocs/channels/stable/dartdoc-viewer/dart:async.StreamTransformer).这似乎不是一种非常像Dart的方式来接近它,而是更像是一种类似Javascript的方式(我正在使用Dart来避免).

许多在线消息来源说这是你创建StreamTransformer的方式,但扩展它时会出现错误.

class exampleStreamTransformer extends StreamTransformer
{
  //... (This won't work)
}

"实现"似乎是要走的路,同时实现所需的绑定功能:

class exampleStreamTransformer implements StreamTransformer
{
  Stream bind(Stream stream)
  {
    //... (Go on to return new stream, etc)
  }
}

我似乎无法找到这种方式的任何示例,但我自己抛出了一些东西(在我的IDE中已被接受,但在运行时不被接受,当它尝试使用pause getter时我得到一个空对象错误):

class exampleStreamTransformer implements StreamTransformer
{
  StreamController<String> _controller;
  StreamSubscription<String> _subscription;

  Stream bind(Stream stream)
  {
    _controller = new StreamController<String>(
        onListen: ()
        {
          _subscription = stream.listen((data)
          {
            // Transform the data.
            _controller.add(data);
          },
          onError: _controller.addError,
          onDone: _controller.close,
          cancelOnError: true); // Unsure how I'd pass this in?????
        },
        onPause: _subscription.pause,
        onResume: _subscription.resume,
        onCancel: _subscription.cancel,
        sync: true
    );

    return _controller.stream;
  }
}

想以这种方式实现它,就像在'打字'的方式来制作课程一样,任何帮助都非常感谢,谢谢.

Answer 1

与 不同map，变压器更强大，允许您维护内部状态，并在需要时发出值。它可以实现map做不到的事情，比如延迟、重复值、有选择地省略一些值等等。

本质上，该实现需要一种bind基于传入的旧流提供新流的方法，以及一种cast有助于在运行时进行类型检查的方法。

下面是实现“TallyTransformer”的一个过于简化的示例，该示例将整数值流转换为总和流。例如，如果到目前为止输入流为1, 1, 1, -2, 0, ...，则输出流将为1, 2, 3, 1, 1, ...，即对到目前为止的所有输入求和。

用法示例：stream.transform(TallyTransformer())

class TallyTransformer implements StreamTransformer {
  StreamController _controller = StreamController();
  int _sum = 0; // sum of all values so far

  @override
  Stream bind(Stream stream) {
    // start listening on input stream
    stream.listen((value) {
      _sum += value; // add the new value to sum
      _controller.add(_sum); // emit current sum to our listener
    });
    // return an output stream for our listener
    return _controller.stream;
  }

  @override
  StreamTransformer<RS, RT> cast<RS, RT>() {
    return StreamTransformer.castFrom(this);
  }
}

此示例过于简化（但仍然有效），并且不涵盖流暂停、恢复或取消等情况。如果遇到"Stream has already been listened"错误，请确保流正在广播。

Answer 2

为什么不使用StreamTransformer.fromHandler()：

import 'dart:async';

void handleData(data, EventSink sink) {
  sink.add(data*2);
}

void main() {
  StreamTransformer doubleTransformer = new StreamTransformer.fromHandlers(handleData: handleData);

  StreamController controller = new StreamController();
  controller.stream.transform(doubleTransformer).listen((data) {
    print('data: $data');
  });

  controller.add(1);
  controller.add(2);
  controller.add(3);
}

输出：

data: 2
data: 4
data: 6

Answer 3

https://github.com/dart-lang/sdk/issues/27740#issuecomment-258073139

您可以使用 StreamTransformer.fromHandlers 轻松创建仅将输入事件转换为输出事件的转换器。

例子：

new StreamTransformer.fromHandlers(handleData: (String event, EventSink output) {
  if (event.startsWith('data:')) {
    output.add(JSON.decode(event.substring('data:'.length)));
  } else if (event.isNotEmpty) {
    output.addError('Unexpected data from CloudBit stream: "$event"');
  }
});

Answer 4

好的。这是另一个工作示例：

import 'dart:async';

class DuplicateTransformer<S, T> implements StreamTransformer<S, T> {
  StreamController _controller;

  StreamSubscription _subscription;

  bool cancelOnError;

  // Original Stream
  Stream<S> _stream;

  DuplicateTransformer({bool sync: false, this.cancelOnError}) {
    _controller = new StreamController<T>(onListen: _onListen, onCancel: _onCancel, onPause: () {
      _subscription.pause();
    }, onResume: () {
      _subscription.resume();
    }, sync: sync);
  }

  DuplicateTransformer.broadcast({bool sync: false, bool this.cancelOnError}) {
    _controller = new StreamController<T>.broadcast(onListen: _onListen, onCancel: _onCancel, sync: sync);
  }

  void _onListen() {
    _subscription = _stream.listen(onData,
      onError: _controller.addError,
      onDone: _controller.close,
      cancelOnError: cancelOnError);
  }

  void _onCancel() {
    _subscription.cancel();
    _subscription = null;
  }

  /**
   * Transformation
   */

  void onData(S data) {
    _controller.add(data);
    _controller.add(data); /* DUPLICATE EXAMPLE!! REMOVE FOR YOUR OWN IMPLEMENTATION!! */
  }

  /**
   * Bind
   */

  Stream<T> bind(Stream<S> stream) {
    this._stream = stream;
    return _controller.stream;
  }
}

void main() {
  // Create StreamController
  StreamController controller = new StreamController.broadcast();
  // Transform
  Stream s = controller.stream.transform(new DuplicateTransformer.broadcast());

  s.listen((data) {
    print('data: $data');
  }).cancel();

  s.listen((data) {
    print('data2: $data');
  }).cancel();

  s.listen((data) {
    print('data3: $data');
  });

  // Simulate data

  controller.add(1);
  controller.add(2);
  controller.add(3);
}

让我添加一些注释：

• implements在查看其他dart内部转换器的源代码时，使用似乎是正确的方法。
• 我为常规流和广播流都实现了这两个版本。
• 如果是常规流，则可以直接在新的流控制器上调用取消/暂停/恢复，因为我们只能听一次。
• 如果使用广播流，我发现只有在没有人正在收听该流的情况下才调用listen（）。onCancel的行为相同。如果最后一个订阅者取消了其订阅，则会调用onCancel。这就是为什么在此处使用相同功能的原因。