Java ProjectReactor框架之Flux篇

Spring5现处在第四个预发布版,正式版将要发布了,它带来的一大特性就是响应式框架Spring WebFlux。默认使用ProjectReactor框架。因此。本文通过ProjectReactor中的Flux,来学习使用该框架,以及了解其传递的思想。

本文基于Reactor3.1 rc1

Reactor官方地址http://projectreactor.io/,官方文档写的十分详细,如果您有不错的英文能力,建议直接阅读官方文档。

Spring WebFlux 实践

首先,为大家带来一个使用了ProjectReactor的例子,该例子使用Spring Boot 2.0.0.BUILD-SNAPSHOT。因Spring Boot推荐默认配置(约定)优先,可以极大减少大量的重复的模版化代码,简化搭建过程。

Spring Boot 2.0.0稳定版还未出,不过也快了,目前处在第四个里程碑版本。

step1:搭建环境

spring boot部分工具如idea提供了可视化操作,选择reactive-web模块即可(你也可以多选一些你需要的模块),如果没有可视化的工具,也可访问官网的开始页面https://start.spring.io/,或者在pom中引入一下模块(web开发主流仍是maven,所以未采用gradle)

        
            org.springframework.boot
            spring-boot-starter-webflux
        
        
            io.projectreactor
            reactor-test
            test
        

step2:编写处理类

编写一个简单的处理类,TestHandler

@Service
@NonNullApi
public class TestHandler {

    public Mono data(ServerRequest request){
        Mono mono =  Mono.justOrEmpty(request.queryParam("data"))
                .defaultIfEmpty("this is null")
                .map(it -> it.concat("! from server webflux!"));
        return ServerResponse.ok().body(mono,String.class);
    }

}

step3:编写路由

spring webflux也提供了函数试的路由配置,如下

@Configuration
public class RoutingConfiguration {

    //...

    @Bean
    public RouterFunction testRouterFunction(TestHandler handle) {
        return RouterFunctions.route(GET("/test").and(accept(APPLICATION_JSON)), handle::data);
    }

}

step4:测试,验证

当浏览器输入http://localhost:8080/test,得到结果:this is null! from server webflux!
当浏览器输入http://localhost:8688/test?data=hi,得到结果:hi! from server webflux!

我的webflux项目地址:GitHub

深入学习

看过实践后,你会发现有大量的使用Flux和Mono,它们是什么呢?

Flux 继承自 Publisher ,用于代表拥有 0 到 n 元素的流,相对于 Mono (其包含0-1个元素) 更加复杂。所以弄懂了Flux,其实也已经对Mono熟悉了。

静态方法

Flux一般通过静态方法构造,所以先看看它的静态方法。

combineLatest

public static Flux combineLatest(Function combinator, Publisher... sources)
构建一个Flux,混合由多个的发布者发布最新事件.

Java ProjectReactor框架之Flux篇_第1张图片

Type Parameters:
T - 表示发布者的事件类型
V - 被混合者混合后的类型
Parameters:
sources - 发布者,提供事件
combinator - 混合者,接受最新的事件,处理并传递给下游。
Returns: 一个以Flux为基础的混合流
不同的参数方法很多,这里都只展示一个。

concat

public static Flux concat(Publisher... sources)
用于连接一个流。与combineLatest不同的是,concat都是在前一个流完成后在连接新的流。而combineLatest,则哪个事件最先到的,哪个先处理。

Java ProjectReactor框架之Flux篇_第2张图片

Type Parameters:
T - 事件的类型
Parameters:
sources - 一系列的发布者
Returns: 一个新的Flux连接了所有的发布者,并传递给下游

concatDelayError

拥有与concat类似的方法,不同的是,遇到错误不提前拦截,而是等到最后发布的事件处理完成后

create,push

public static Flux create(Consumer> emitter)
通过FluxSink API,以同步或者异步方式创建Flux。
例如:

 Flux.create(emitter -> {

     ActionListener al = e -> {
         emitter.next(textField.getText());
     };
     // without cleanup support:

     button.addActionListener(al);

     // with cleanup support:

     button.addActionListener(al);
     emitter.onDispose(() -> {
         button.removeListener(al);
     });
 });

这是非常有用的,如果一个流,需要动态添加或者移除其他的多个事件,通过异步的api。而且,你将不必担心被取消和背压。
create(Consumer> emitter, FluxSink.OverflowStrategy backpressure) 设置背压方式
push方法用处与使用方式与create几乎一致,它们唯一的区别在于CreateMode类型 create为PUSH_PULL,而push为PUSH_ONLY,从文档中也可以一个为多线程一个为单线程

backpressure(背压)概念的理解

这里,我摘自一位大神的话,背压是指在异步场景中,被观察者发送事件速度远快于观察者的处理速度的情况下,一种告诉上游的被观察者降低发送速度的策略。简而言之,背压是流速控制的一种策略。

更多的背压到http://www.jianshu.com/p/2c4799fa91a4这里不多做介绍了

defer

public static Flux defer(Supplier> supplier)
这个方法提供了一种惰性策略,发布者不会一开始发布消息,直到订阅者创建实例.

Java ProjectReactor框架之Flux篇_第3张图片

Type Parameters:
T - 发布者发布或订阅者接受的类型
Parameters:
supplier - 一个发布者的供应者,当订阅的时候回调
Returns: 一个惰性的Flux

empty

public static Flux empty()
创建一个不含任何事件的流.

error

public static Flux error(Throwable error)
返回一个带着立即终止标识和错误信息的流

first

public static Flux first(Publisher... sources)
挑选出第一个发布者,由其提供事件。能有效避免多个源的冲突。

Java ProjectReactor框架之Flux篇_第4张图片

from

public static Flux from(Publisher source)
public static Flux fromIterable(Iterable it)
public static Flux fromStream(Stream s)
从一个发布者创建一个flux流

fromArray,fromIterable,fromStream

public static Flux fromArray(T[] array)
通过一个数组,或者一个可迭代的元素,或者一个流,创建flux流.

Java ProjectReactor框架之Flux篇_第5张图片

Type Parameters:
T - 数组的类型和Flux的类型
Parameters:
emmm.. - 数组,可迭代的元素,流
Returns: 新的flux流

generate

public static Flux generate(Consumer> generator)
Programmatically create a Flux by generating signals one-by-one via a consumer callback.

Java ProjectReactor框架之Flux篇_第6张图片

Type Parameters:
T - the value type emitted
Parameters:
generator - Consume the SynchronousSink provided per-subscriber by Reactor to generate a single signal on each pass.
Returns: a Flux
没看懂,好像是说,通过编程方式创建一个一对一的消费回调

interval

public static Flux interval(Duration period)
间隔一定的时间,发送事件。
Runs on the Schedulers.parallel() Scheduler.

Java ProjectReactor框架之Flux篇_第7张图片

just

public static Flux just(T... data)
创建一个包含一系列元素的flux流

Java ProjectReactor框架之Flux篇_第8张图片

merge

public static Flux merge(Publisher... sources)
混合多个流,和combineLatest类似,但它要求是同类型的流合并,combineLatest需要提供合并方式

Java ProjectReactor框架之Flux篇_第9张图片

never

public static Flux never()
Create a Flux that will never signal any data, error or completion signal.

Java ProjectReactor框架之Flux篇_第10张图片

Type Parameters:
T - the Subscriber type target
Returns:
a never completing Flux
看一看,不是很明白,该流的用处。

range

public static Flux range(int start, int count)
提供从start,到start + count的所有整数的flux流

switchOnNext

public static Flux switchOnNext(Publisher> mergedPublishers)
从最新的发布者那里获取事件,如果有新的发布者加入,则改用新的发布者。
当最后一个发布者完成所有发布事件,并且没有发布者加入,则flux完成。

Java ProjectReactor框架之Flux篇_第11张图片

using

public static Flux using(Callable resourceSupplier, Function> sourceSupplier, Consumer resourceCleanup)
Uses a resource, generated by a supplier for each individual Subscriber, while streaming the values from a Publisher derived from the same resource and makes sure the resource is released if the sequence terminates or the Subscriber cancels.
Eager resource cleanup happens just before the source termination and exceptions raised by the cleanup Consumer may override the terminal even.

Java ProjectReactor框架之Flux篇_第12张图片

zip

public static Flux zip(Function combinator, Publisher... sources)
通过混合者,合并多个流成一个输出流,一一对应合并


Java ProjectReactor框架之Flux篇_第13张图片

...

看一下下面的api
public static Flux combineLatest(Publisher source1, Publisher source2, Publisher source3, Function combinator)
public static Flux combineLatest(Publisher source1, Publisher source2, Publisher source3, Publisher source4, Function combinator)
...
public static Flux> zip(Publisher source1, lisher source2)
public static Flux> zip(Publisher source1, lisher source2, lisher source3)
...
ヽ(o_ _)o摔倒,我也是服了project reactor 官方。

常用的实例方法

静态的方法介绍完了,但是实例方法比静态方法多太多,所以这里只举常用的几种介绍

all,any,hasElement,hasElements

这几个方法调用,均返回包涵一个Boolean信号的Mono。

  • all(Predicate predicate)表示所有值均满足条件
  • any(Predicate predicate)表示存在一个值满足条件
  • hasElement(T t)表示是否存在该值
  • hasElements()表示是否拥有一个或多个元素

as,compose

public final

P as(Function,P> transformer)
转化flux为一个目标类型。
官方例子:flux.as(Mono::from).subscribe()
将flux通过Mono.from函数转化为mono
public final Flux compose(Function,? extends Publisher> transformer)
compose与as的区别是转化类型做了限制,必须继承Publisher,同时compose是惰性的。在很多时候,写法上没有差别如flux.compose(Mono::from).subscribe()

blockFirst,blockLast

阻塞至第一个或者最后一个值处理完成

butter系列

该系列实例方法很多,作用是将一系列元素,分成一组或者多组,该方法可用在按组批量操作上,例如,以时间间隔分组,批量添加数据。

cache

如其名缓存,相当于复制一份用于接下来的操作,而当前的流将会被缓存起来,用于之后的操作。

cancelOn

public final Flux cancelOn(Scheduler scheduler)
取消

cast

public final Flux cast(Class clazz)
强转

checkpoint

用于检测当前节点,流中是否存在错误

collect系列

该系列实例方法,用于收集所有的元素到特定类型,如list、map等
处理完成时返回Mono

concatMap系列,flatMap系列

举例说明吧,[[1,2],[4,5],[6,7,8]] -> [1,2,4,5,6,7,8]起这种转化作用

Java ProjectReactor框架之Flux篇_第14张图片

flatMap系列一样

concatWith

与concatMap不同,这是相加

Java ProjectReactor框架之Flux篇_第15张图片

defaultIfEmpty

public final Flux defaultIfEmpty(T defaultV) 默认值

distinct

public final Flux distinct()
去重,相对与jdk8,多了下面两种方法
public final Flux distinct(Function keySelector)
public final > Flux distinct(Function Supplier distinctCollectionSupplier)
去除与V匹配的和第二个不怎么理解,,,这让我想到了filter

do系列

还系列有doOnNext,doOnError,doOnCancel等等,均表示完成后触发

elementAt

返回某一位置的值,类型为Mono,可以设置默认值

filter

public final Flux filter(Predicate p)
过滤出满足条件的

groupBy

public final Flux> groupBy(Function keyMapper)

Java ProjectReactor框架之Flux篇_第16张图片

分组,根据提供的keyMapper

My Blog: https://www.dnocm.com/

你可能感兴趣的:(Java ProjectReactor框架之Flux篇)