Как обрабатывать ситуацию, когда ключи JSON не совпадают с названиями свойств модели?

На практике почти всегда JSON от сервера не идеально совпадает с неймингом в Swift, поэтому важно уметь корректно настраивать маппинг.

Базовый механизм — CodingKeys

CodingKeys — это перечисление, которое определяет соответствие между ключами JSON и свойствами модели.

Простой пример

JSON:

{
  "user_id": 10,
  "user_name": "Alex"
}

Модель:

struct User: Decodable {
    let id: Int
    let name: String

    enum CodingKeys: String, CodingKey {
        case id = "user_id"
        case name = "user_name"
    }
}

Что здесь важно:

1. Имена свойств остаются id и name.

2. JSON-ключи инкапсулированы внутри модели.

3. Внешний код не знает о формате JSON.

Когда CodingKeys недостаточно

Иногда формат данных сложнее стандартного сопоставления.

Типичные случаи:

1. Вложенные объекты.

2. Опциональные или условные поля.

3. Разные типы данных (строка вместо числа).

Кастомный init(from:)

init(from decoder: Decoder) throws {
    let container = try decoder.container(keyedBy: CodingKeys.self)
    id = try container.decode(Int.self, forKey: .id)
    name = try container.decodeIfPresent(String.self, forKey: .name) ?? "Unknown"
}

Альтернативные подходы

Иногда используют:

1. keyDecodingStrategy = .convertFromSnakeCase для простых случаев.

2. DTO-модели, которые маппятся в domain-модели вручную.

Практический вывод

CodingKeys — основной и рекомендуемый способ работы с несовпадающими ключами JSON. Кастомное декодирование стоит применять только тогда, когда стандартного механизма недостаточно.