Java 响应式编程系列---Reactor Operator API 总结

最新推荐文章于 2025-01-21 11:05:40 发布

原创最新推荐文章于 2025-01-21 11:05:40 发布 · 1.4k 阅读

5 ·

CC 4.0 BY-SA版权

此博客上带有原创标识的文章.图片.文件等，未经本人允许，不得用于商业用途以及传统媒体。网络媒体或个人转载请注明出处和链接，否则属于侵权行为。

文章标签：

#vue #大数据 #js #spring #java

Java 专栏收录该内容

42 篇文章

订阅专栏

本文深入探讨Reactor框架，介绍如何利用其丰富的运算符进行数据处理。覆盖从简单转换到复杂编排的各种应用场景，并强调了背压机制的重要性。

尽管 Reactive Streams 规范并未指定任何运算符（Operators），但 Reactor 的核心价值之一就是提供了丰富的运算符。从简单的转换、过滤到复杂的编排和错误处理，涉及方方面面。

推荐通过参考文档而不是 JavaDoc 来学习 Mono/Flux API 和 Operator 操作符。参考：“which operator do I need?” appendix

注意点

使用 Reactor API 时，有以下几个注意点：

一、每个 Operator API 都会返回新实例

在 Reactor 中，操作符（Operators）好比流水线中的工作站。每个操作符都会向 Publisher 添加行为，并将上一步的 Publisher 包装成新实例。因而，整个链就被串起来，数据从第一个 Publisher 开始，沿着链向下移动，通过每个链接进行转换。最终，Subscriber 结束该流程。注意，直到 Subscriber 订阅 Publisher 为止，什么都不会发生。

理解操作符会创建新实例这一行为，有助于避免一些常见错误，详见：I Used an Operator on my Flux but it Doesn’t Seem to Apply. What Gives?

二、Nothing Happens Until You subscribe()

Reactor 中，当您编写 Publisher 链时，仅用于描述异步处理的抽象过程，默认情况下数据不会开始处理。只有通过订阅，将 Publisher 与 Subscriber 绑定在一起时，才能触发整个链中的数据流处理。这是由其内部实现方式决定的：Subscriber 发出请求信号并向上传播，直到源 Publisher。

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-P8VcnBbf-1612354225230)(https://qidawu.github.io/img/java/reactive-stream/reactive-stream/org.reactivestream_api.png)]

三、使用背压（Backpressure）进行流量控制

Propagating signals upstream is also used to implement backpressure, which we described in the assembly line analogy as a feedback signal sent up the line when a workstation processes more slowly than an upstream workstation.

The real mechanism defined by the Reactive Streams specification is pretty close to the analogy: A subscriber can work in unbounded mode and let the source push all the data at its fastest achievable rate or it can use the request mechanism to signal the source that it is ready to process at most n elements.

Intermediate operators can also change the request in-transit. Imagine a buffer operator that groups elements in batches of ten. If the subscriber requests one buffer, it is acceptable for the source to produce ten elements. Some operators also implement prefetching strategies, which avoid request(1) round-trips and is beneficial if producing the elements before they are requested is not too costly.

This transforms the push model into a push-pull hybrid, where the downstream can pull n elements from upstream if they are readily available. But if the elements are not ready, they get pushed by the upstream whenever they are produced.

Mono

https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Mono.html

for [0|1] elements

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Ap3o30h9-1612354225232)(https://qidawu.github.io/img/java/reactive-stream/reactor/mono/mono.svg)]

创建 Mono 流

mono_create

中间操作

Each operator adds behavior to a Publisher and wraps the previous step’s Publisher into a new instance. The whole chain is thus linked, such that data originates from the first Publisher and moves down the chain, transformed by each link. Eventually, a Subscriber finishes the process. Remember that nothing happens until a Subscriber subscribes to a Publisher.

While the Reactive Streams specification does not specify operators at all, one of the best added values of reactive libraries, such as Reactor, is the rich vocabulary of operators that they provide. These cover a lot of ground, from simple transformation and filtering to complex orchestration and error handling.

转换操作

mono_map

空值处理

mono_ifempty

执行操作

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-1X4WeSt3-1612354225238)(https://qidawu.github.io/img/java/reactive-stream/reactor/mono/mono_do.png)]

异常处理

mono_error

终结操作

阻塞返回结果

mono_block

Flux

https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Flux.html

for [N] elements

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-pkZl4Y3c-1612354225241)(https://qidawu.github.io/img/java/reactive-stream/reactor/flux/flux.svg)]

创建 Flux 流

普通创建

flux_create

定时创建

flux_create_interval

合并创建

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-4bv04g3Q-1612354225244)(https://qidawu.github.io/img/java/reactive-stream/reactor/flux/flux_create_combine.png)]

编程式创建

flux_create_2

其它

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-sU4wlzHz-1612354225246)(https://qidawu.github.io/img/java/reactive-stream/reactor/flux/flux_create_switchOnNext.png)]