深知大多数程序员,想要提升技能,往往是自己摸索成长,但自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,涵盖了95%以上鸿蒙开发知识点,真正体系化!
由于文件比较多,这里只是将部分目录截图出来,全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频,并且后续会持续更新
private val myFlow = flow<Int> producer@{
var value = 0
while (true) {
emit(value++)
delay(1000)
}
}
GlobalScope.launch {
myFlow.collect(object : FlowCollector<Int> {
override suspend fun emit(value: Int) {
Log.i(TAG, "receive $value")
}
})
}
这里定义了一个每间隔1秒发送一次数据的Flow,因为Flow需要运行在协程中,所以通过GlobalScope.launch
启动了一个协程,然后在协程中调用Flow
对象的collect
方法,并传递一个FlowCollector
实例,在其emit
方法中接收上游发送过来的数据。
需要注意的是,通过Flow Builder创建的Flow属于冷流,意味着只有当Flow的终端操作函数被调用时,比如collect
函数,才会执行生产者代码,也就是示例中的producer代码块,并且每次调用终端操作函数时都会创建一条新的数据流,彼此互不影响,在下面的示例中producer代码块会被执行两次,产生两条数据流:
GlobalScope.launch {
myFlow.collect consumer1@{ value -> Log.i(TAG, "receive $value") }
}
GlobalScope.launch {
myFlow.collect consumer2@{ value -> Log.i(TAG, "receive $value") }
}
此外,因为FlowCollector
的emit
方法并不是线程安全的,所以不允许我们在一个新的协程或者新的Dispatcher
中调用,以下代码都是非法的:
private val myFlow1 = flow<Int> {
GlobalScope.launch {
emit(1)
}
}
private val myFlow2 = flow<Int> {
withContext(Dispatchers.IO) {
emit(1)
}
}
1、操作符
1.1、生命周期
Flow中提供了onStart
、onCompletion
操作符用于监听数据流的开始、结束,以onStart
为例:
public fun <T> Flow<T>.onStart(
action: suspend FlowCollector<T>.() -> Unit
): Flow<T>
参数action是一个使用suspend
修饰,FlowCollector
的扩展函数,其Receiver直接/间接地持有从下游传递过来的FlowCollector
对象,允许我们调用emit
方法向数据流的开头添加额外的数据,如下所示:
GlobalScope.launch {
flowOf(1, 2)
.onStart {
emit(0)
}
.onCompletion {
emit(3)
}
.collect {
Log.i(TAG, "receive $it")
}
}
// receive 0
// receive 1
// receive 2
// receive 3
1.2、线程切换
前面有提到,不允许在新起的协程/线程中调用FlowCollector
的emit
方法,如果需要显示地切换生产者代码运行的线程,需要借助flowOn
操作符:
public fun <T> Flow<T>.flowOn(context: CoroutineContext): Flow<T>
private val myFlow = flow<Int> producer@{
var value = 0
while (true) {
emit(value++)
delay(1000)
}
}
GlobalScope.launch(Dispatchers.Main) {
myFlow.flowOn(Dispatchers.IO)
.onCompletion completation@{
Log.i(TAG, "on complete")
}
.collect consumer@{
Log.i(TAG, "receive $it")
}
}
flowOn
操作符只会切换上游数据流的CoroutineContext
,不会影响到下游数据流。所以在上述示例代码中,producer代码块会运行在子线程中,completation、consumer代码块会运行在主线程上。
1.3、异常处理
Flow中异常的处理是通过catch操作符来完成的,上游抛出的异常会被捕获,默认会结束流的执行:
GlobalScope.launch(Dispatchers.Main) {
flowOf(1, 2, 3)
.map {
if (it == 2) {
throw RuntimeException("error")
}
it
}.flowOn(Dispatchers.IO)
.catch { e ->
Log.i(TAG, "catch exception, ${e.message}")
}
.collect {
Log.i(TAG, "receive $it")
}
}
// receive 1
// catch exception, error
2、callbackFlow
flow构建 api只适用于同步生产的数据,而针对异步返回的数据,官方提供了另一个顶层函数:
public fun <T> callbackFlow(@BuilderInference block: suspend ProducerScope<T>.() -> Unit): Flow<T>
/**
* Sender's interface to [Channel].
*/
public interface SendChannel<in E> {
public suspend fun send(element: E)
public fun trySend(element: E): ChannelResult<Unit>
public fun close(cause: Throwable? = null): Boolean
......
}
block函数接收一个ProducerScope
对象,其实现了SendChannel
接口,允许我们通过send
、trySend
方法发送数据。callbackFlow
的底层基于Channel
,概念上类似于Java中的BlockingQueue
,不同之处在于它是非阻塞的,如果发送数据时缓冲区已满,会将发送方协程挂起并加入到内部维护的等待队列中,等待缓冲区有空闲时被唤醒。数据的接收也是类似的,如果当前缓冲区为空,会将接收方协程挂起并加入到等待队列中,等到有数据时被唤醒。
下面通过一个例子来给大家介绍一下callbackFlow
的使用:
private val myCallbackFlow = callbackFlow {
val callback = object : MyCallback {
override fun onNext(value: Int) {
trySend(value) // trySendBlocking(value)
}
override fun onCompletion() {
close()
}
override fun onFailure(throwable: Throwable?) {
cancel()
}
}
api.register(callback)
awaitClose { api.unregister(callback) }
}
GlobalScope.launch {
myCallbackFlow.collect {
Log.i(TAG, "receive $it")
}
}
trySend
方法是send
方法的非挂起版本,允许我们在协程外、非挂起函数中调用,但是它不能保证数据的发送,当缓冲区已满时,发送的数据会被丢弃掉。如果我们需要保证数据的发送,可以调用trySendBlocking
方法,当缓冲区已满时,会堵塞当前线程直至成功发送数据或者对应的Channel
、协程被关闭、取消。
需要注意的是,awaitClose
方法被强制要求调用,否则会抛出IllegalStateException
异常,这是为了避免因协程结束导致我们注册的callback泄露。awaitClose
方法会将当前协程挂起,并保证在Channel
关闭或者协程取消时执行我们传递的代码块,从而完成相关资源的释放。还有一点是,传递给awaitClose
方法的代码块不能保证和传递给callbackFlow
方法的代码块在同一个线程执行,因此相关的注册、反注册方法需要是线程安全的。
网上学习资料一大堆,但如果学到的知识不成体系,遇到问题时只是浅尝辄止,不再深入研究,那么很难做到真正的技术提升。
一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!
794404107)]
网上学习资料一大堆,但如果学到的知识不成体系,遇到问题时只是浅尝辄止,不再深入研究,那么很难做到真正的技术提升。
一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!