Как парсить JSON в Kotlin: лучшие библиотеки и примеры кода

Лучший способ: Kotlinx Serialization

Самое современное и идиоматичное решение для Kotlin — это kotlinx.serialization. Эта библиотека разрабатывается JetBrains специально для Kotlin, поддерживает мультиплатформенность и не требует рефлексии, что даёт отличную производительность.

Шаг 1: Подключение библиотеки

Добавьте в build.gradle.kts (или build.gradle):

// В секции plugins
plugins {
    kotlin("plugin.serialization") version "1.9.22"
}

// В секции dependencies
dependencies {
    implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.6.2")
}

Шаг 2: Определите data class

Создайте класс, соответствующий структуре JSON, и добавьте аннотацию @Serializable:

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

@Serializable
data class Todo(
    val userId: Int,
    val id: Int,
    val title: String,
    val completed: Boolean
)

Шаг 3: Парсинг одной строки

fun main() {
    val jsonString = """{"userId":1,"id":1,"title":"delectus aut autem","completed":false}"""
    
    val todo = Json.decodeFromString<Todo>(jsonString)
    
    println(todo.title) // delectus aut autem
    println(todo.completed) // false
}

Работа с массивами и вложенными объектами

Допустим, у вас есть такой JSON:

[
  {"userId":1, "id":1, "title":"Task 1", "completed":false},
  {"userId":1, "id":2, "title":"Task 2", "completed":true}
]

Парсинг массива:

val jsonArray = """[{"userId":1,...}, {"userId":2,...}]"""
val todos: List<Todo> = Json.decodeFromString<List<Todo>>(jsonArray)

Настройка парсера

Вы можете настроить поведение парсера через объект Json:

val json = Json {
    prettyPrint = true
    ignoreUnknownKeys = true  // игнорировать лишние поля
    isLenient = true          // допускать неточности в формате
    coerceInputValues = true  // приводить типы автоматически
}

// Использование:
val todo = json.decodeFromString<Todo>(jsonString)

Сериализация (обратный процесс)

Чтобы превратить объект обратно в JSON:

val todo = Todo(1, 1, "My task", false)
val jsonString = Json.encodeToString(todo)
println(jsonString) // {"userId":1,"id":1,"title":"My task","completed":false}

Почему это лучший выбор?

• Типобезопасность — компилятор проверяет типы полей
• Минимум кода — одна аннотация и один вызов функции
• Производительность — без рефлексии, код генерируется на этапе компиляции
• Мультиплатформенность — работает на JVM, JS, Native
• Поддержка Kotlin — использует возможности языка: data class, sealed class, null safety

Альтернативы (если проект уже использует другую библиотеку)

Gson — если вы мигрируете с Java:

implementation("com.google.code.gson:gson:2.10.1")
// Использование:
val gson = Gson()
val todo = gson.fromJson(jsonString, Todo::class.java)

Jackson — мощный, но более тяжёлый:

implementation("com.fasterxml.jackson.module:jackson-module-kotlin:2.16.1")
// Использование:
val mapper = jacksonObjectMapper()
val todo = mapper.readValue<Todo>(jsonString)

Но для чистого Kotlin-проекта я настоятельно рекомендую kotlinx.serialization — это современный стандарт.

import org.json.JSONObject

fun JSONObject.toTodo(): Todo {
    return Todo(
        userId = getInt("userId"),
        id = getInt("id"),
        title = getString("title"),
        completed = getBoolean("completed")
    )
}

// Использование:
val jsonString = """{"userId":1,"id":1,"title":"delectus aut autem","completed":false}"""
val todo = JSONObject(jsonString).toTodo()

import org.json.JSONArray

fun JSONArray.toTodoList(): List<Todo> {
    val list = mutableListOf<Todo>()
    for (i in 0 until length()) {
        list.add(getJSONObject(i).toTodo())
    }
    return list
}