Kotlin Academy · 课时

runCatching 与 Result<T>

使用 runCatching 将异常封装在 Result 中,并以函数式方式处理结果。

第 3 / 4 课13 个步骤

runCatching 与 Result<T> 是 CoddyKit 上的免费 Kotlin Academy 课时。 这是第 3 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Kotlin Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Kotlin Academy 课程共包含 4 节课。

Result<T> 简介

Result<T> 是 Kotlin 用来包装操作结果的类型:要么是包含 T 类型值的成功,要么是包含 Throwable 的失败。

runCatching 基础

runCatching { ... } 会执行代码块,并将结果包装在 Result 中。

fun main() {
    val good = runCatching { 10 / 2 }
    val bad  = runCatching { 10 / 0 }
    println("good isSuccess = ${good.isSuccess}")
    println("bad isFailure  = ${bad.isFailure}")
}

提取值

getOrNull 返回值或 null。getOrThrow 在失败时重新抛出异常。getOrDefault 返回备用值。

fun main() {
    val r = runCatching { "42".toInt() }
    println(r.getOrNull())          // 42
    println(r.getOrDefault(-1))    // 42
    val bad = runCatching { "x".toInt() }
    println(bad.getOrNull())       // null
    println(bad.getOrDefault(0))   // 0
}

提取异常

exceptionOrNull() 在失败时返回异常,在成功时返回 null。

fun main() {
    val r = runCatching { error("boom") }
    println(r.exceptionOrNull()?.message) // boom
}

使用 map 转换

map { value -> ... } 会转换成功值。失败结果会原样传递。

fun main() {
    val r = runCatching { "10" }.map { it.toInt() * 2 }
    println(r.getOrNull()) // 20
}

mapCatching

mapCatching 会将转换过程包装在 try/catch 中,因此 Lambda 内部的异常也会变为失败结果。

fun main() {
    val r = runCatching { "abc" }.mapCatching { it.toInt() }
    println(r.isFailure) // true
    println(r.exceptionOrNull()?.message) // For input string: "abc"
}

recover 与 recoverCatching

recover { e -> fallback } 会通过计算恢复值,将失败转换为成功。

fun main() {
    val r = runCatching { "abc".toInt() }
        .recover { -1 }
    println(r.getOrNull()) // -1
}

onSuccess / onFailure

使用 onSuccess 和 onFailure 执行副作用,而不改变 Result。

fun main() {
    runCatching { "42".toInt() }
        .onSuccess { println("parsed: $it") }
        .onFailure { println("failed: ${it.message}") }
}

使用 fold 处理两条路径

fold(onSuccess, onFailure) 会从两个分支返回统一类型,适合将结果转换为可供用户界面使用的值。

fun main() {
    val r = runCatching { "10".toInt() }
    val msg: String = r.fold(
        onSuccess = { "OK: $it" },
        onFailure = { "ERR: ${it.message}" }
    )
    println(msg)
}

将 Result 用作返回类型

函数可以返回 Result<T>,从而让调用方明确处理错误。

fun parseInt(s: String): Result<Int> = runCatching { s.toInt() }
fun main() {
    parseInt("42").onSuccess { println("got $it") }
    parseInt("xx").onFailure { println("oops: ${it.message}") }
}

链式组合操作

将 runCatching 与 map、mapCatching、recover 结合起来,构建流畅的错误处理流程。

fun fetchUserId(): Result<Int> = runCatching { 42 }
fun loadName(id: Int): String = "User-$id"
fun main() {
    val name = fetchUserId()
        .map { loadName(it) }
        .recover { "Anonymous" }
        .getOrNull()
    println(name)
}

快速检查

哪个构建器会执行代码块,并将结果(值或异常)包装在 Result 中?

回顾

Result<T> 表示成功或失败。使用 runCatching 创建,使用 map/mapCatching 转换,使用 recover 恢复,使用 onSuccess/onFailure 观察,使用 fold 合并结果。它非常适合构建明确的错误处理流程。

免费开始

用 AI 导师学习 Kotlin — 免费

在浏览器中编写并运行真实代码,获得全天候 AI 导师的即时帮助,并在网页或应用中继续学习。

课程
51
课程
203

常见问题解答

「runCatching 与 Result<T>」课时是免费的吗?

是的 — 「runCatching 与 Result<T>」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Kotlin Academy 课程的其余内容,请升级到 CoddyKit PRO。 Kotlin Academy 课程共包含 4 节课。

「runCatching 与 Result<T>」这节课中我会学到什么?

使用 runCatching 将异常封装在 Result 中,并以函数式方式处理结果。 你通过在浏览器中直接运行的动手代码来练习 Kotlin Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Kotlin Academy 需要有经验吗?

无需任何先前经验。CoddyKit 上的 Kotlin Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 3 节课,共 4 节。

「runCatching 与 Result<T>」课时需要多长时间?

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。

我能在这节 Kotlin Academy 课中编写并运行代码吗?

能。每节 Kotlin Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. 作为表达式的 try/catch/finally
  2. 创建自定义异常类
  3. runCatching 与 Result
  4. 重新抛出异常与异常链
← 返回 Kotlin Academy