Kotlin Flow 操作符的基本用法

转记
http://www.gityunstar.com/post/27fe75f8efac11eba2c000163e0febfd
https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/

前置资料

  • 冷流 ?

冷指的是 无消费者时 则不会生产数据

  • 热流 ?

热指的是 无观察者时 也会生产数据

Flow分类

  • 一般 Flow

一般的Fow , 仅有一个观察者 。冷流 。

//构建

val testFlow = flow{
    emit("hello")
    emit("flow")
}

//接收
coroutineScope.launch{
  testFlow.collect{ value->
     println(value)
  }
}

//打印
hello
flow

  • StateFlow

有状态Flow ,可以有多个观察者,热流
构造时需要传入初始值 : initialState
常用作与UI相关的数据观察,类比LiveData

//创建
val uiState=MutableStateFlow(Result.Loading)

//监听
coroutineScope.launch{
    uiState.collect{ value->
         println(value)
    }    
}

//赋值
uiState.value=Result.Sucess 

//打印结果
Result.Loading
Result.Sucess

  • SharedFlow

可定制化的StateFlow,可以有多个观察者,热流. 无需初始值,有三个可选参数:
replay - 重播给新订阅者的值的数量(不能为负,默认为零)。
extraBufferCapacity - 除了replay之外缓冲的值的数量。 当有剩余缓冲区空间时, emit不会挂起(可选,不能为负,默认为零)。
onBufferOverflow - 配置缓冲区溢出的操作(可选,默认为暂停尝试发出值)
使用SharedFlow 你可以写个 FlowEventBus

//创建
val signEvent=MutableSharedFlow  ()

//监听
coroutineScope.launch{
    signEvent.collect{ value->
         println(value)
    }    
}
//赋值
signEvent.tryEmit("hello")
signEvent.tryEmit("shared flow")

//打印结果
hello
shared flow

操作符

  • 中间操作符
    • 一般来说是用来执行一些操作,不会立即执行,返回值还是个Flow
  • 末端操作符
    • 会触发流的执行,返回值不是Flow

[图片上传失败...(image-fdee44-1658984978428)]

创建Flow

  • flow

创建Flow的基本方法.
使用 emit 发射单个值
使用 emitAll 发射一个流 ,类似 list.addAll(anotherList)

flow{
    emit(1)
    emit(2)
    emit(flowOf(1,2,3))
}

  • flowOf

快速创建 flow ,类比 listOf()

val testFLow = flowOf(1,2,3)
launch{
    testFLow.collect{ value->
        print(value)
    }
}

//打印结果
1
2
3

  • asFlow

将其他数据转换成 普通的flow ,一般是****集合****向Flow的转换

listOf(1,2,3).asFlow()

  • callbackFlow

将回调方法改造成flow ,类似suspendCoroutine

fun flowFrom(api: CallbackBasedApi): Flow = callbackFlow {
    val callback = object : Callback {
        override fun onNextValue(value: T) {
            send(value)
                .onFailure { throwable ->

                }

        }

        override fun onApiError(cause: Throwable) {
            cancel(CancellationException("API Error", cause))
        }

        override fun onCompleted() = channel.close()
    }
    api.register(callback)
    awaitClose { api.unregister(callback) }
}
  • emptyFlow

返回一个空流 .

emptyFlow()
  • channelFlow

在一般的flow在构造代码块中不允许切换线程,ChannelFlow则允许内部切换线程

//构建

val channelFlow = channelFlow {
 send("hello")
    withContext(Dispatchers.IO) {
     send("channel flow")
    }
 }

//监听

coroutineScope.launch{
    signEvent.collect{ value->
         println(value)
    }
}

末端操作符

  • collect

触发flow的运行 。 通常的监听方式

launch{
    flowOf(1,2,3).collect{ value->
        print(value)
    }
}

// 1 2 3
  • collectIndexed

带下标的 收集操作

launch{
    flowOf(1,2,3).collectIndexed{ value->
        print(value)
    }
}
// 1 2 3
  • collectLatest

collect的区别是 ,有新值发出时,如果此时上个收集尚未完成,则会取消掉上个值的收集操作

flow {
 emit(1)
    delay(50)
    emit(2)
 } .collectLatest { value ->

 println("Collecting $value")
    delay(100) // Emulate work
    println("$value collected")

 }

//输出
Collecting 1
Collecting 2
2 collected

只想要最新的数据,中间值可以丢弃时可以使用此方式

  • toCollection

将结果添加到集合

val array = arrayListOf(0)
launch {
  flow {
     emit(1)
     emit(2)
    } .toCollection(array)
 }

array.forEach { value->
  print(value)
 }

//打印结果 

0 1 2
  • toList

将结果转换为List

flow {
   emit(1)
   emit(2)
} .toList().forEach{value->
    print(value)
}
// 1 2
  • toSet

将结果转换为Set

flow {
   emit(1)
   emit(1)
} .toSet().forEach{value->
    print(value)
}
// 1
  • launchIn

直接触发流的执行,不设置action,入参为coroutineScope 一般不会直接调用,会搭配别的操作符一起使用,如onEach,onCompletion 。返回值是Job

flow {
   emit(1)
   emit(2)
 }.launchIn ( lifecycleScope )
  • last

返回流 发出 的最后一个值 ,如果为空会抛异常

val myFlow= flow {
   emit(1)
   emit(2)
 }

launch{
    print(myFlow.last())
}

// 2
  • lastOrNull

返回流 发出 的最后一个值 ,可以为空

val myFlow= emptyFlow()
launch{
    print(myFlow.lastOrNull())
}

// null
  • first

返回流 发出 的第一个值 ,如果为空会抛异常

val myFlow= flow {
   emit(1)
   emit(2)
 }
launch{
    print(myFlow.first())
}

// 1
  • firstOrNull

返回流 发出 的第一个值 ,可以为空

val myFlow= emptyFlow()
launch{
    print(myFlow.firstOrNull())
}
// null
  • single

接收流发送的第一个值 ,区别于first(),如果为空或者发了不止一个值,则都会报错

val myFlow= flow {
     emit(1)
}

launch {
     print(myFlow.single()) // 1
}

val myFlow1= flow {
   emit(1)
   emit(2)
 }

launch {
   print(myFlow 1 . single ()) // error
}
  • singleOrNull

接收流发送的第一个值 ,可以为空,但如果发了不止一个值,依旧会报错

val myFlow= flow {
 emit(1)
}

launch  {
 print(myFlow. singleOrNull ()) // 1
}
  • count

返回流发送值的个数。 类似 list.size() ,注:sharedFlow无效(无意义)

val myFlow= flow {
   emit(1)
   emit(2)
}
launch{
    print(myFlow.count())
}
//2
  • fold

从初始值开始 执行遍历,并将结果作为下个执行的 参数。

val sum= flowOf(2, 3, 4)
            .fold(1, { result, value ->
                 result + value
            })
// sum = 10, 相当于 1 + 2 + 3 + 4
  • reduce

fold 差不多。 无初始值

val result= flowOf(1, 2, 3)
                .reduce { acc, value ->
                     acc + value
                }
 //result = 6   1 + 2  +3 

回调操作符

  • onStart

在上游流开始之前被调用。 可以发出额外元素,也可以处理其他事情,比如发埋点

flow{
   emit(Result.Success)
}.onStart{
   emit(Result.Loading)
}
  • onCompletion

在流取消或者结束时调用。可以执行发送元素,发埋点等操作

flow{
   emit(Result.Success)
}.onCompletion{
   emit(Result.End)
}
  • onEach

在上游向下游发出元素之前调用

flow{
   emit(1)
   emit(2)
   emit(3)
}.onEach{ value->
   println(value)
}.launchIn(lifecycleScope)

// 打印结果
1
2
3
  • onEmpty

当流完成却没有发出任何元素时回调。 可以用来兜底.。

emptyFlow().onEmpty {
   emit("兜底数据")
 } .launchIn(lifecycleScope)
  • onSubscription

SharedFlow 专属操作符 (StateFlowSharedFlow 的一种特殊实现)
建立订阅之后 回调。 和 onStart 有些区别 ,SharedFlow 是热流,因此如果在onStart里发送值,则下游可能接收不到。

val state = MutableSharedFlow().onSubscription {
     emit("onSubscription")
 }

launch{
    state.collect { value->
        println(value)
    }
}

//打印结果

onSubscription

变换操作符

  • map

将发出的值 进行变换 ,lambda的返回值为最终发送的值

flow {
    emit(1)
    emit(2)
 } .map { value ->
    value * 2
 } .collect {
    println(value)
}

//打印结果
2
4
  • mapLatest

类比 collectLatest ,当有新值发送时如果上个变换还没结束,会先取消掉

flow {
    emit("a")
    delay(100)
    emit("b")
}.mapLatest { value ->
    println("Started computing $value")
    delay(200)
    "Computed $value"
}.collect {value->
 print(value)
}

// 打印结果
Started computing a
Started computing b
Computed b
  • mapNotNull

仅发送 map后不为空的值

flow {
    emit("a")
    emit("b")
 } .mapNotNull { value ->
  if (value != null) {
        value
    } else {
        null
 }
 }.collect { value ->
    print(value)
}
// 结果

b
  • transform

对发出的值 进行变换 。区别于maptransform的接收者是FlowCollector ,因此它非常灵活,可以变换、跳过它或多次发送。

flow {
    emit(1)
    emit(2)
 } .transform { value ->
  if (value == 1) {
        emit("value :$value*2")
    }
    emit("transform :$value")
 }.collect { value->
  println(value)
}

// 打印结果

value : 1*2
transform :1
transform :2
  • transformLatest

类比 mapLatest ,当有新值发送时如果上个变换还没结束,会先取消掉

flow {
  emit("a")
  delay(100)
  emit("b")
 }.transformLatest { value ->
  emit(value)
  delay(200)
  emit(value + "_last")
 }.collect {value->
  println(value)
}

// 打印结果
a
b
b_last
  • transformWhile

这个变化的lambda 的返回值是 Boolean ,如果为 False则不再进行后续变换, 为 True则继续执行

flow {
    emit("a")
    emit("b")
 } .transformWhile { value ->
    emit(value)
    true
 } .collect { value->
  println(value)
}

//结果
a
b

--------------------

flow {
    emit("a")
    emit("b")
 }.transformWhile { value ->
    emit(value)
    false
 }.collect { value->
    println(value)
}

//结果
a
  • asStateFlow

MutableStateFlow 转换为 StateFlow ,就是变成不可变的。常用在对外暴露属性时使用

private val _uiState = MutableStateFlow(Loading)

val uiState = _uiState.asStateFlow()
  • asSharedFlow

MutableSharedFlow 转换为 SharedFlow ,就是变成不可变的。常用在对外暴露属性时使用

private val _uiState = MutableStateFlow(Loading)

val uiState = _uiState.asStateFlow()
  • receiveAsFlow

Channel 转换为Flow ,可以有多个观察者,但不是多播,可能会轮流收到值。

private val _event = Channel()

val event= _event.receiveAsFlow() 
  • consumeAsFlow

Channel 转换为Flow ,但不能多个观察者(会crash)!

private val _event = Channel()

val event= _event.consumeAsFlow () 
  • withIndex

将结果包装成IndexedValue 类型

flow {
    emit("a")
    emit("b")
 } .withIndex().collect {
  print(it.index + ": " + it.value)
}

//结果
0 : a
1 : b
  • scan

fold 相似,区别是fold 返回的是最终结果,scan返回的是个flow ,会把初始值和每一步的操作结果发送出去。

flowOf(1, 2, 3).scan(0) { acc, value ->
    acc + value 
 }.collect {
  print(it)
}

// 0 1 3 6
acc 是上一步操作的结果, value 是发射的值

0 是 初始值 
1 是 0 + 1 = 1
3 是 1 + 2 = 3
6 是 3 + 3 = 6
  • produceIn

转换为 ReceiveChannel , 不常用。
注: Channel 内部有 ReceiveChannelSendChannel之分,看名字就是一个发送,一个接收。

flowOf(1, 2, 3).produceIn(this)
               .consumeEach { value->
                    print(value)
               }

//1 2 3
  • runningFold

区别于 fold ,就是返回一个新流,将每步的结果发射出去。

flowOf(1, 2, 3).runningFold(1){ acc, value ->
     acc + value
 } .collect { value->
     print(value)
 }
 // 1 2 4 7
  • runningReduce

区别于 reduce ,就是返回一个新流,将每步的结果发射出去。

flowOf(1, 2, 3).runningReduce(1) { acc, value ->
     acc + value
 } .collect { value->
     print(value)
 }
 // 1 3 6
  • shareIn

将普通flow 转化为 SharedFlow , 其有三个参数
scope: CoroutineScope 开始共享的协程范围 started: SharingStarted 控制何时开始和停止共享的策略
replay: Int = 0 发给 新的订阅者 的旧值数量

其中 started 有一些可选项:
Eagerly : 共享立即开始,永不停止
Lazily : 当第一个订阅者出现时,永不停止
WhileSubscribed : 在第一个订阅者出现时开始共享,在最后一个订阅者消失时立即停止(默认情况下),永久保留重播缓存(默认情况下)
WhileSubscribed 具有以下可选参数:
stopTimeoutMillis — 配置最后一个订阅者消失到协程停止共享之间的延迟(以毫秒为单位)。 默认为零(立即停止)。
replayExpirationMillis - 共享的协程从停止到重新激活,这期间缓存的时效

val share = flowOf(1,2,3).shareIn(this,SharingStarted.Eagerly)

//可以有多个观察者
state.collect{value->
  print(value)
}
  • stateIn

将普通flow 转化为 StateFlow 。 其有三个参数:
scope - 开始共享的协程范围
started - 控制何时开始和停止共享的策略
initialValue - 状态流的初始值

val  state = flowOf(Success).stateIn(lifecycleScope,SharingStarted.Eagerly,Loading)

state.collect{value->
  print(value)
}
// Loading  Success

stateInsharedIn 通常用在其他来源的flow的改造监听,不会像上面那样使用。

过滤操作符

  • filter

筛选出符合条件的值

flow {
    emit("a")
    emit("b")
}.filter { value ->
    value == "a"
}.collect { value->
    print(value)
}

//结果
a
  • filterInstance

筛选对应类型的值

flow {
    emit("a")
    emit("b")
    emit(1)
 }.filterIsInstance().collect { value->
    print(value)
 }

//结果

a
b
  • filterNot

筛选不符合条件相反的值,相当于filter取反

flow {
    emit("a")
    emit("b")
 }.filterNot { it == "a" } .collect { value ->
   print(value)
}

//结果
b
  • filterNotNull

筛选不为空的值

flow {
    emit("a")
    emit(null)
    emit("b")
 }.filterNotNull().collect { value->
  print(value)
}

//结果
a
b
  • drop

入参countint类型 ,作用是 丢弃掉前 n 个的值

flow {
    emit(1)
    emit(2)
    emit(3)
 }.drop(2).collect { value ->
  print(value)
}

//结果
3
  • dropWhile

这个操作符有点特别,和filter 不同! 它是找到第一个不满足条件的,返回其和其之后的值。
如果首项就不满足条件,则是全部返回。

flow {
 emit(3)
 emit(1) //从此项开始不满足条件
 emit(2)
 emit(4)
}. dropWhile { it == 3  } .collect { value ->
  print(value)
}

//结果 
1 2 4

flow {
 emit(1) //从首项开始就不满足条件
 emit(2)
 emit(3)
 emit(4)
}. dropWhile { it == 3  } .collect { value ->
 print(value)
}

//结果

1 2 3 4
  • take

返回前 n个 元素

flow {
    emit(1)
    emit(2)
    emit(3)
 } .take(2) .collect { value ->
    print(value)
}

//结果
1
2
  • takeWhile

也是找第一个不满足条件的项,但是取其之前的值 ,和dropWhile 相反。

如果第一项就不满足,则为空流

flow {
    emit(1)
    emit(2)
    emit(3) //从此项开始不满足条件
    emit(4)
 } .takeWhile { it <3  } .collect { value ->
    print(value)
}

//结果
1 2 

flow {
    emit(3)  //从此项开始不满足条件
    emit(1)
    emit(2)
    emit(4)
 } .takeWhile { it <3  } .onEmpty {
  print( "empty")
 }.collect { value ->
  print(value)
}

//结果
empty
  • debounce

防抖节流 ,指定时间内的值只接收最新的一个,其他的过滤掉。搜索联想场景适用

flow {
    emit(1)
    delay(90)
    emit(2)
    delay(90)
    emit(3)
    delay(1010)
    emit(4)
    delay(1010)
    emit(5)
}.debounce(1000)

 // 3 4 5
  • sample

采样 。给定一个时间周期,仅获取周期内最新发出的值

flow {
    repeat(10) {
        emit(it)
        delay(110)
    }
}.sample(200)

// 1 3 5 7 9

//图示

       【1】

|-----------|

1          200  

               2    【3】

           |------------|

          200           400
  • distinctUntilChangedBy

去重操作符,判断连续的两个值是否重复,可以选择是否丢弃重复值。

keySelector: (T) -> Any? 指定用来判断是否需要比较的 key

有点类似Recyclerview的DiffUtil机制。

flowOf(
    Funny(name = "Tom", age = 8),
    Funny(name = "Tom", age = 12),
    Funny(name = "Tom", age = 12)
).distinctUntilChangedBy { it.name } .collect { value ->
     print(value.toString())
}

// Funny(name=Tom, age=8)
  • distinctUntilChanged

过滤用,distinctUntilChangedBy 的简化调用 。连续两个值一样,则跳过发送

flowOf(1, 1, 3,1).distinctUntilChanged()
                .collect { value ->
                   print(value)
                }

// 1 3 1

组合操作符

  • combine

组合每个流最新发出的值。

val flow = flowOf(1, 2).onEach { delay(10) }
val flow2 = flowOf("a", "b", "c").onEach { delay(15) }
flow.combine(flow2) { i, s -> i.toString() + s } .collect {
  println(it) // Will print "1a 2a 2b 2c"
}
  • combineTransform

顾名思义 combine + **transform******

val numberFlow = flowOf(1, 2).onEach { delay(10) }
val stringFlow = flowOf("a", "b", "c").onEach { delay(15) }

numberFlow.combineTransform(stringFlow) { number, string ->
     emit("$number :$string")
 }.collect { value ->
     println( value )
 }

//结果
1 :a
2 :a
2 :b
2 :c
  • merge

合并多个流成 一个流。 可以用在 多级缓存加载上

val numberFlow = flowOf(1, 2).onEach { delay(10) }
val stringFlow = flowOf("a", "b", "c").onEach { delay(15) }

listOf(numberFlow,stringFlow).merge()
                             .collect { value ->
                                 print(value)
                             }

// 1 a 2 b c
  • flattenConcat

以顺序方式将给定的流展开为单个流 ,是Flow>的扩展函数

flow {
    emit(flowOf(1, 2, 3))
    emit(flowOf(4, 5, 6))
 } .flattenConcat().collect { value->
     print(value)
 }

// 1 2 3 4 5 6
  • flattenMerge

作用和 flattenConcat 一样,但是可以设置并发收集流的数量。

有个入参:concurrency: Int ,当其 == 1时,效果和 flattenConcat 一样,大于 1 时,则是并发收集。

flow {
    emit(flowOf(1, 2, 3).flowOn(Dispatchers.IO))
    emit(flowOf(4, 5, 6).flowOn(Dispatchers.IO))
    emit(flowOf(7, 8, 9).flowOn(Dispatchers.IO))
 }.flattenMerge(3).collect { value->
     print(value)
 }

//1 2 3 7 8 9 4 5 6 (顺序并不固定)
  • flatMapContact

这是一个组合操作符,相当于 map + flattenConcat , 通过 map 转成一个流,在通过 flattenConcat

展开合并成一个流

flowOf(1, 2, 3).flatMapConcat {
     flowOf(it.toString() + " map")
 } .collect { value ->
     print ln (value)
 }

// 1 map 
// 2 map
// 3 map
  • flatMapLatest

和其他 带 Latest的操作符 一样,如果下个值来了,上变换还没结束,就取消掉。

相当于 transformLatest + emitAll

flow {
     emit("a")
     delay(100)
     emit("b")
 }.flatMapLatest { value ->
     flow {
         emit(value)
         delay(200)
         emit(value + "_last")
     }
 }.collect { value ->
     print(value)
 }

 // a b b_last
  • flatMapMerge

也是组合操作符,简化使用。 map + flattenMerge 。 因此也是有 concurrency: Int 这样一个参数,来限制并发数。

flowOf("a","b","c","d","e","f").flatMapMerge(3) { value ->
     flow {
         emit(value)
     } .flowOn(Dispatchers.IO)
 }.collect { value ->
     print(value)
 }

// b a c d e f
  • zip

对两个流进行组合,分别从二者取值,一旦一个流结束了,那整个过程就结束了。

val flow = flowOf(1, 2, 3).onEach { delay(10) }

val flow2 = flowOf("a", "b", "c", "d").onEach { delay(15) }

flow.zip(flow2) { i, s -> i.toString() + s }.collect {
    println(it) 
}

 // Will print "1a 2b 3c"

功能性操作符

  • cancellable

接收的的时候判断 协程是否被取消 ,如果已取消,则抛出异常

val job= flowOf(1,3,5,7).cancellable().onEach { value->
     print(value)
 } .launchIn(lifecycleScope)

 //取消
 job.cancel()
  • catch

上游异常进行捕获 ,对下游无影响

上游 指的是 此操作符之前的流

下游 指的是此操作符之后的流

flow {
  throw IOException("")     
 } .catch { e ->
  if(e is IOException){
        //...
 }
}
  • retryWhen

有条件的进行重试 ,lambda 中有两个参数: 一个是 异常原因,一个是当前重试的 index (从0开始).

lambda 的返回值 为 Booleantrue则继续重试 ,false 则结束重试

flow {
    print("doing")
    throw IOException("")
 } .retryWhen { cause,attempt->
     if(attempt > 4){
        return@retryWhen false
     }
    cause is IOException
 }
  • retry

重试机制 ,当流发生异常时可以重新执行。retryWhen 的简化版。

retries: ``Long`` = Long.MAX_VALUE 指定重试次数,以及控制是否继续重试.(默认为true)

flow {
  throw IOException("")     
 }. retry (3){ e->
  if(e is IOException){
      true
  }else {
      false
  }
}

flow {
  throw IOException("")     
 }.retry(3)
  • buffer

如果操作符的代码需要相当****长时间来执行 ,可使用buffer操作符在执行期间为其创建一个单独的协程

capacity: Int = BUFFERED 缓冲区的容量

onBufferOverflow: BufferOverflow = BufferOverflow.``SUSPEND **溢出的话执行的操作

有三个选择 : SUSPEND 挂起, DROP_OLDEST 丢掉旧的,DROP_LATEST 丢掉新的

flowOf("A", "B", "C")
    .onEach  { println("1$it") }
    .collect { println("2$it") }

Q : -->-- [1A] -- [2A] -- [1B] -- [2B] -- [1C] -- [2C] -->--

flowOf("A", "B", "C")
 .onEach  { println("1$it") }
 .buffer()  // <--------------- buffer between onEach and collect
 .collect { println("2$it") }

P : -->-- [1A] -- [1B] -- [1C] ---------->--  // flowOf(...).onEach { ... }

                      |
                      | channel               // buffer()
                      V

Q : -->---------- [2A] -- [2B] -- [2C] -->--  // collect
  • conflate

仅保留最新值, 内部就是 buffer``(``CONFLATED``)

flow {
      repeat(30) {
      delay(100)
      emit(it)
    }
 }.conflate().onEach { delay(1000) } .collect { value ->
     print(value)
 }

// 0 7 15 22 29  (结果不固定)
  • flowOn

指定上游操作的执行线程 。 想要切换执行线程 就用它!

flow.map { ... } // Will be executed in IO
 . flowOn (Dispatchers.IO) // This one takes precedence
 . collect{ ... }

总结

以上就是Kotlin Flow所有操作符的基本用法,在实际场景中按需使用。比如上面说的:搜索场景使用debounce防抖,网络请求使用retry,组件通信使用SharedFlow, 数据合并使用combine等操作符。提升开发效率啦噜

你可能感兴趣的:(Kotlin Flow 操作符的基本用法)