协程

Kotlin 协程 是可挂起计算的实例,允许以命令式的方式编写非阻塞代码。在语言方面,suspend 函数为异步操作提供了抽象,而在库方面,kotlinx.coroutines 提供了诸如 async { } 之类的函数和诸如 Flow 之类的类型。

Spring Data 模块在以下范围内提供对协程的支持

依赖项

kotlinx-coroutines-corekotlinx-coroutines-reactivekotlinx-coroutines-reactor 依赖项位于类路径中时,将启用协程支持。

在 Maven pom.xml 中添加的依赖项
<dependency>
	<groupId>org.jetbrains.kotlinx</groupId>
	<artifactId>kotlinx-coroutines-core</artifactId>
</dependency>

<dependency>
	<groupId>org.jetbrains.kotlinx</groupId>
	<artifactId>kotlinx-coroutines-reactive</artifactId>
</dependency>

<dependency>
	<groupId>org.jetbrains.kotlinx</groupId>
	<artifactId>kotlinx-coroutines-reactor</artifactId>
</dependency>
支持的版本 1.3.0 及更高版本。

响应式如何转换为协程?

对于返回值,从响应式到协程 API 的转换如下所示

  • fun handler(): Mono<Void> 变成 suspend fun handler()

  • fun handler(): Mono<T> 变成 suspend fun handler(): Tsuspend fun handler(): T?,具体取决于 Mono 是否可以为空(具有更静态类型的优势)

  • fun handler(): Flux<T> 变成 fun handler(): Flow<T>

Flow 是协程世界中 Flux 的等效项,适用于热或冷流、有限或无限流,主要区别如下

  • Flow 是基于推送的,而 Flux 是混合推送拉取的。

  • 反压通过挂起函数实现。

  • Flow 只有一个 单个挂起 collect 方法,并且运算符作为 扩展 实现。

  • 运算符易于实现,这要归功于协程。

  • 扩展允许向 Flow 添加自定义运算符。

  • 收集操作是挂起函数。

  • map 运算符 支持异步操作(不需要 flatMap),因为它采用挂起函数参数。

阅读这篇关于 使用 Spring、协程和 Kotlin Flow 实现响应式 的博文以了解更多详细信息,包括如何使用协程并发运行代码。

仓库

这是一个协程仓库的示例

interface CoroutineRepository : CoroutineCrudRepository<User, String> {

    suspend fun findOne(id: String): User

    fun findByFirstname(firstname: String): Flow<User>

    suspend fun findAllByFirstname(id: String): List<User>
}

协程仓库构建在响应式仓库之上,以通过 Kotlin 的协程公开数据访问的非阻塞特性。协程仓库上的方法可以由查询方法或自定义实现支持。如果自定义方法是可 suspend 的,则调用自定义实现方法会将协程调用传播到实际的实现方法,而无需要求实现方法返回响应式类型,例如 MonoFlux

请注意,根据方法声明,协程上下文可能可用也可能不可用。要保留对上下文的访问,请使用 suspend 声明您的方法,或返回启用上下文传播的类型,例如 Flow

  • suspend fun findOne(id: String): User:通过挂起检索一次数据并同步检索。

  • fun findByFirstname(firstname: String): Flow<User>:检索数据流。Flow 是急切创建的,而数据是在 Flow 交互(Flow.collect(…))时获取的。

  • fun getUser(): User:检索一次数据,**阻塞线程**且不进行上下文传播。应避免这种情况。

仅当仓库扩展 CoroutineCrudRepository 接口时,才会发现协程仓库。