Kotlin Academy · 课时

Result 类型

Q: 「Result 类型」这节课中我会学到什么？

表示成功与失败 你通过在浏览器中直接运行的动手代码来练习 Kotlin Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

表示成功与失败

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

Success 或 failure

许多操作都可能失败。Kotlin 的 Result 类型表示一种结果：要么是携带值的 success，要么是携带异常的 failure，而不会抛出异常。

创建 Success

使用 Result.success(value) 将一个值包装为成功结果。

fun main() {
    val r: Result<Int> = Result.success(42)
    println(r.isSuccess)
    println(r.getOrNull())
}

创建 failure

使用 Result.failure(exception) 表示错误。在您选择将其解包之前，不会抛出异常。

fun main() {
    val r: Result<Int> = Result.failure(IllegalStateException("bad"))
    println(r.isFailure)
    println(r.exceptionOrNull()?.message)
}

getOrNull 和 exceptionOrNull

安全地检查结果：getOrNull() 返回值或 null，而 exceptionOrNull() 返回错误或 null。

fun main() {
    val ok = Result.success("hi")
    val bad = Result.failure<String>(RuntimeException("oops"))
    println(ok.getOrNull())
    println(bad.exceptionOrNull()?.message)
}

getOrDefault

使用 getOrDefault 为 failure 提供备用值。当您有合理的默认值时，这比检查 null 更简洁。

fun main() {
    val bad: Result<Int> = Result.failure(Exception())
    println(bad.getOrDefault(0))
    val ok: Result<Int> = Result.success(7)
    println(ok.getOrDefault(0))
}

getOrElse

getOrElse 根据异常计算备用值，让您能够针对不同的错误做出不同的反应。

fun main() {
    val r: Result<Int> = Result.failure(IllegalArgumentException("nope"))
    val value = r.getOrElse { e -> if (e is IllegalArgumentException) -1 else -2 }
    println(value)
}

getOrThrow

当您确实需要异常时，getOrThrow() 会返回值，或重新抛出存储的异常。

fun main() {
    val ok = Result.success(10)
    println(ok.getOrThrow())

    try {
        Result.failure<Int>(IllegalStateException("fail")).getOrThrow()
    } catch (e: Exception) {
        println("caught: " + e.message)
    }
}

返回 Result

函数可以返回 Result，从而在其签名中明确表示可能失败，并要求调用方处理两种结果。

fun parse(s: String): Result<Int> {
    val n = s.toIntOrNull()
    return if (n != null) Result.success(n)
           else Result.failure(NumberFormatException(s))
}

fun main() {
    println(parse("123").getOrNull())
    println(parse("x").exceptionOrNull()?.message)
}

Result 与异常

异常不会显示在签名中，并且会打乱控制流。Result 将 failure 变成可以像其他值一样传递和转换的值：明确、可组合，并且难以忽略。

何时使用 Result

对于可恢复且预期会发生、需要调用方处理的失败，请使用 Result。对于真正异常的程序员错误情况（例如违反契约），请继续抛出异常。

值，而不是跳转

关键转变在于：错误变成普通的返回值。接下来您将学习 runCatching，它可以自动将抛出的异常捕获到 Result 中。

快速检查

请测试您对 Result 类型的理解。

回顾

您学习了 Result 类型：

使用 Result.success / Result.failure 创建
使用 getOrNull、exceptionOrNull 检查
使用 getOrDefault、getOrElse、getOrThrow 恢复
返回它，使 failure 得到明确表示

下一步：runCatching。

常见问题解答

「Result 类型」课时是免费的吗？

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

「Result 类型」这节课中我会学到什么？

表示成功与失败你通过在浏览器中直接运行的动手代码来练习 Kotlin Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Kotlin Academy 需要有经验吗？

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

「Result 类型」课时需要多长时间？

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

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

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

此课程中的所有课时

← 返回 Kotlin Academy