Как разобрать JSON в Kotlin: подробное руководство для начинающих

Проблема и её решение

Ваша ошибка связана с тем, что Gson (как и многие Java-библиотеки) возвращает nullable тип (Post?), а Kotlin требует явной обработки null. Это особенность Kotlin — он строже относится к null-безопасности, чем Java.

Есть два основных подхода к парсингу JSON в Kotlin:

• kotlinx.serialization — официальная библиотека от JetBrains, наиболее идиоматичная для Kotlin
• Gson/Jackson с адаптацией — привычный для Java-разработчиков подход с дополнительной обработкой

1. Рекомендуемый способ: kotlinx.serialization

Это лучший выбор для Kotlin-проектов. Библиотека полностью учитывает особенности языка, включая null-безопасность и sealed-классы.

Шаг 1: Добавьте зависимости в build.gradle.kts

plugins {
    kotlin("jvm") version "1.9.0"
    kotlin("plugin.serialization") version "1.9.0"
}

dependencies {
    implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.6.0")
}

Шаг 2: Аннотируйте data class

import kotlinx.serialization.Serializable
import kotlinx.serialization.json.Json

@Serializable
data class Post(
    val userId: Int,
    val id: Int,
    val title: String,
    val body: String
)

Шаг 3: Парсинг

val jsonString = """
{
  "userId": 1,
  "id": 1,
  "title": "Заголовок",
  "body": "Текст поста"
}
"""

val post = Json.decodeFromString<Post>(jsonString)
println(post.title) // "Заголовок"

Библиотека автоматически обрабатывает null-поля. Если в JSON поле будет отсутствовать, а в data class оно не nullable — вы получите исключение. Если поле nullable (val title: String?), то при отсутствии значения будет null.

2. Альтернатива: Gson с обработкой null

Если вы хотите использовать Gson, нужно явно обработать nullable результат:

import com.google.gson.Gson

val gson = Gson()
val jsonString = """{"userId": 1, "id": 1, "title": "Заголовок", "body": "Текст поста"}"""

// Вариант 1: с оператором ?:
val post: Post = gson.fromJson(jsonString, Post::class.java) 
    ?: throw IllegalArgumentException("JSON не может быть null")

// Вариант 2: с использованием let
gson.fromJson(jsonString, Post::class.java)?.let { post ->
    println(post.title)
}

// Вариант 3: если уверены, что JSON корректен (не рекомендуется)
val post = gson.fromJson(jsonString, Post::class.java)!!

3. Работа со списками JSON

Часто API возвращает массив объектов:

val jsonArray = """
[
  {"userId": 1, "id": 1, "title": "Пост 1"},
  {"userId": 1, "id": 2, "title": "Пост 2"}
]
"""

// kotlinx.serialization
val posts = Json.decodeFromString<List<Post>>(jsonArray)

// Gson
val postsList = gson.fromJson(jsonArray, Array<Post>::class.java).toList()

Лучшие практики

• Используйте kotlinx.serialization для новых проектов — это официальная библиотека, которая лучше интегрируется с языком
• Всегда обрабатывайте исключения при парсинге: используйте try-catch или runCatching
• Для полей, которые могут отсутствовать в JSON, используйте nullable типы (val title: String? = null) или значения по умолчанию
• Избегайте оператора !! — он может привести к NPE в рантайме

Пример с обработкой ошибок:

fun parsePost(jsonString: String): Post? {
    return try {
        Json.decodeFromString<Post>(jsonString)
    } catch (e: Exception) {
        println("Ошибка парсинга: ${e.message}")
        null
    }
}

Теперь вы знаете, как правильно парсить JSON в Kotlin. Начните с kotlinx.serialization — это сэкономит вам время и нервы!

implementation("com.fasterxml.jackson.module:jackson-module-kotlin:2.15.2")

import com.fasterxml.jackson.module.kotlin.jacksonObjectMapper
import com.fasterxml.jackson.module.kotlin.readValue

val mapper = jacksonObjectMapper()
val jsonString = """{"userId": 1, "id": 1, "title": "Заголовок", "body": "Текст"}"""

val post: Post = mapper.readValue(jsonString)
// Jackson сам обработает null-безопасность