反应式扩展

工程开发 社区

技能解读

当前原文的自动摘译,尚未人工审校。

何时使用此技能

在以下情况下使用此技能: 随着时间的推移编写事件 - UI 输入、传感器/提要更新、websocket 消息、域事件 您需要 debounce、throttle、merge、combine-latest、distinct-until-changed 等操作符 使用 ReactiveProperty / BindableReactiveProperty 构建 MVVM 状态 使用 Task / async 和 IAsyncEnumerable 桥接基于推送的流

参考文件

rx-net-differences.md:与 System.Reactive (Rx.NET) 相比的每个有意义的差异 — 新的核心类型、错误模型、运算符重命名、删除的 API、调度程序交换和迁移清单。 async-and-integration-patterns.md:常见模式 — 使用 AwaitOperation、Task 集成、IAsyncEnumerable 往返、ReactiveProperty/MVVM、主题和订阅生命周期进行异步调度。

为什么 R3 存在(“为什么使用它”)

作者(neuecc)构建了 R3 来修复System.Reactive中的具体缺陷:异常会默默地杀死订阅。在 Rx 中,管道中的一个异常会调用 OnError 并永远取消订阅 — 对于长期事件流来说是“一个价值十亿美元的错误”(一个错误的 UI 事件会破坏整个订阅)。 R3 将错误路由至

心智模型

R3 用抽象类替换了 Rx 的接口,并用携带结果的单个完成替换了 Rx 的两种方法错误契约。语法是(OnNext | OnErrorResume)* OnCompleted(Result)?。请注意与 Rx 的OnNext* (OnError | OnCompleted)? 的区别:错误和终止是解耦的。错误只是一个通知;只有OnCompleted结束流,并且它携带一个Result,它是

默认情况下错误不会终止

这是 Rx 最大的行为变化。要选择回到经典的“错误终止序列”行为,请插入.OnErrorResumeAsFailure()——错误然后流向OnCompleted(Result.Failure(e)),下游OnNext停止。用Catch恢复。完整捕获的运行和(故意缺席的)Retry 故事位于 rx-net-differences.md 中。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
工程开发
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@Aaronontheweb · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

输出预览 r3-reactive-extensions.preview
using R3;

var subscription = Observable
    .EveryValueChanged(model, m => m.SearchText)   // emits when the property changes
    .Debounce(TimeSpan.FromMilliseconds(300))      // Rx called this "Throttle" (see differences)
    .DistinctUntilChanged()
    .SubscribeAwait(async (text, ct) =>
    {
        var results = await _api.SearchAsync(text, ct);
        Render(results);
    }, AwaitOperation.Switch);                      // cancel the in-flight search on a new keystroke

// Dispose to unsubscribe; or route into a DisposableBag / AddTo(token).
subscription.Dispose();

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。