Jetpack Compose Academy · 课时

使用 Moshi 解析 JSON

将响应映射为 Kotlin 数据类。

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

本课时的部分内容尚未翻译，以英文显示。

Why You Need a Parser

The server sends raw JSON text, but your UI needs real Kotlin objects. A parser like Moshi bridges that gap automatically.

Map JSON to a Data Class

Each JSON object becomes a Kotlin data class. Moshi matches field names and fills in the properties for you. ✨

data class User(
    val id: Int,
    val name: String
)

Use @JsonClass for Codegen

Add @JsonClass with generateAdapter true so Moshi builds a fast adapter at compile time instead of using slow reflection.

@JsonClass(generateAdapter = true)
data class User(val id: Int, val name: String)

Rename Fields With @Json

When a JSON key uses snake_case, the @Json annotation maps it to a clean Kotlin property name without renaming the API.

@Json(name = "full_name")
val fullName: String

Nullable Means Optional

If a field might be missing, make it nullable with a question mark. Moshi sets it to null instead of crashing on absent keys.

data class User(
    val id: Int,
    val bio: String?
)

Default Values Are Handy

Give a property a default value and Moshi uses it whenever the JSON omits that field, keeping your model resilient to change.

val isVerified: Boolean = false

Nested Objects Just Work

If your JSON nests another object, model it as its own data class. Moshi parses the whole tree in one pass.

data class User(val id: Int, val address: Address)

Lists of Objects

A JSON array maps cleanly to a Kotlin List of your data class. Moshi builds every item for you in order.

@GET("users")
fun getUsers(): Call<List<User>>

Build a Moshi Instance

Create one shared Moshi object and add the Kotlin adapter factory so it understands data classes properly.

val moshi = Moshi.Builder()
    .add(KotlinJsonAdapterFactory())
    .build()

Plug Moshi Into Retrofit

Pass your Moshi instance to MoshiConverterFactory when building Retrofit, and every response is parsed without extra code.

.addConverterFactory(MoshiConverterFactory.create(moshi))

Keep Models Focused

Only model the fields you actually use. Moshi ignores unknown JSON keys, so a lean data class stays clean and fast.

Quick Check

How do you map a JSON key named first_name to a Kotlin property called firstName?

Recap: JSON Into Objects

You modeled responses as data classes, handled renames, nulls, and nesting, and wired Moshi into Retrofit. Next you'll call these endpoints from a ViewModel.

常见问题解答

「使用 Moshi 解析 JSON」课时是免费的吗？

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

「使用 Moshi 解析 JSON」这节课中我会学到什么？

将响应映射为 Kotlin 数据类。你通过在浏览器中直接运行的动手代码来练习 Jetpack Compose Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Jetpack Compose Academy 需要有经验吗？

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

「使用 Moshi 解析 JSON」课时需要多长时间？

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

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

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

此课程中的所有课时

← 返回 Jetpack Compose Academy