Как сделать enum Decodable в Swift 4?

157
enum PostType: Decodable {

    init(from decoder: Decoder) throws {

        // What do i put here?
    }

    case Image
    enum CodingKeys: String, CodingKey {
        case image
    }
}

Что я положу, чтобы завершить это? Кроме того, допустим, я изменил на caseэто:

case image(value: Int)

Как мне сделать это соответствует Decodable?

EDit Вот мой полный код (который не работает)

let jsonData = """
{
    "count": 4
}
""".data(using: .utf8)!

        do {
            let decoder = JSONDecoder()
            let response = try decoder.decode(PostType.self, from: jsonData)

            print(response)
        } catch {
            print(error)
        }
    }
}

enum PostType: Int, Codable {
    case count = 4
}

Final Edit Кроме того, как он будет обрабатывать перечисление, как это?

enum PostType: Decodable {
    case count(number: Int)
}
быстрый нуб
источник

Ответы:

262

Это довольно просто, просто используйте Stringили Intнеобработанные значения, которые присваиваются неявно.

enum PostType: Int, Codable {
    case image, blob
}

imageкодируется , чтобы 0и blobв1

Или

enum PostType: String, Codable {
    case image, blob
}

imageкодируется , чтобы "image"и blobв"blob"


Это простой пример того, как его использовать:

enum PostType : Int, Codable {
    case count = 4
}

struct Post : Codable {
    var type : PostType
}

let jsonString = "{\"type\": 4}"

let jsonData = Data(jsonString.utf8)

do {
    let decoded = try JSONDecoder().decode(Post.self, from: jsonData)
    print("decoded:", decoded.type)
} catch {
    print(error)
}
vadian
источник
1
Я попробовал код, который вы предложили, но он не работает. Я отредактировал свой код, чтобы показать JSON, который я пытаюсь декодировать
swift nub
8
Перечисление не может быть только расшифровано / декодировано. Он должен быть встроен в структуру. Я добавил пример.
vadian
Я отмечу это как правильное. Но была одна последняя часть в вопросе выше, на которую не было ответа. Что если мой enum выглядит так? (отредактировано выше)
быстрый nub
Если вы используете перечисления со связанными типами, вы должны написать собственные методы кодирования и декодирования. Пожалуйста, прочитайте Кодирование и декодирование пользовательских типов
vadian
1
О «enum не может быть расшифрован / декодирован исключительно.», Это, кажется, решено в iOS 13.3. Я проверяю iOS 13.3и iOS 12.4.3они ведут себя по-разному. Под iOS 13.3enum можно только расшифровать / расшифровать.
AechoLiu
111

Как сделать перечисления со связанными типами соответствующими Codable

Этот ответ похож на @Howard Lovatt, но избегает создания PostTypeCodableFormструктуры и вместо этого использует KeyedEncodingContainerтип, предоставленный Apple, в качестве свойства для Encoderи Decoder, что уменьшает шаблон.

enum PostType: Codable {
    case count(number: Int)
    case title(String)
}

extension PostType {

    private enum CodingKeys: String, CodingKey {
        case count
        case title
    }

    enum PostTypeCodingError: Error {
        case decoding(String)
    }

    init(from decoder: Decoder) throws {
        let values = try decoder.container(keyedBy: CodingKeys.self)
        if let value = try? values.decode(Int.self, forKey: .count) {
            self = .count(number: value)
            return
        }
        if let value = try? values.decode(String.self, forKey: .title) {
            self = .title(value)
            return
        }
        throw PostTypeCodingError.decoding("Whoops! \(dump(values))")
    }

    func encode(to encoder: Encoder) throws {
        var container = encoder.container(keyedBy: CodingKeys.self)
        switch self {
        case .count(let number):
            try container.encode(number, forKey: .count)
        case .title(let value):
            try container.encode(value, forKey: .title)
        }
    }
}

Этот код работает для меня на Xcode 9b3.

import Foundation // Needed for JSONEncoder/JSONDecoder

let encoder = JSONEncoder()
encoder.outputFormatting = .prettyPrinted
let decoder = JSONDecoder()

let count = PostType.count(number: 42)
let countData = try encoder.encode(count)
let countJSON = String.init(data: countData, encoding: .utf8)!
print(countJSON)
//    {
//      "count" : 42
//    }

let decodedCount = try decoder.decode(PostType.self, from: countData)

let title = PostType.title("Hello, World!")
let titleData = try encoder.encode(title)
let titleJSON = String.init(data: titleData, encoding: .utf8)!
print(titleJSON)
//    {
//        "title": "Hello, World!"
//    }
let decodedTitle = try decoder.decode(PostType.self, from: titleData)
proxpero
источник
Мне нравится этот ответ! Как примечание, этот пример также отражен в сообщении на objc.io о том, как сделать Eitherкодируемый
Бен Легжеро,
Лучший ответ
Питер Сувара
38

Swift выдаст .dataCorruptedошибку, если встретит неизвестное значение перечисления. Если ваши данные поступают с сервера, он может отправить вам неизвестное значение перечисления в любое время (ошибка сервера, новый тип, добавленный в версию API, и вы хотите, чтобы предыдущие версии вашего приложения корректно обрабатывали этот случай, и т. Д.), Вы должны быть готовы и кодировать «оборонительный стиль», чтобы безопасно расшифровать ваши перечисления.

Вот пример того, как это сделать, с или без связанного значения

    enum MediaType: Decodable {
       case audio
       case multipleChoice
       case other
       // case other(String) -> we could also parametrise the enum like that

       init(from decoder: Decoder) throws {
          let label = try decoder.singleValueContainer().decode(String.self)
          switch label {
             case "AUDIO": self = .audio
             case "MULTIPLE_CHOICES": self = .multipleChoice
             default: self = .other
             // default: self = .other(label)
          }
       }
    }

И как использовать это во вложенной структуре:

    struct Question {
       [...]
       let type: MediaType

       enum CodingKeys: String, CodingKey {
          [...]
          case type = "type"
       }


   extension Question: Decodable {
      init(from decoder: Decoder) throws {
         let container = try decoder.container(keyedBy: CodingKeys.self)
         [...]
         type = try container.decode(MediaType.self, forKey: .type)
      }
   }
Тока
источник
1
Спасибо, ваш ответ гораздо проще понять.
DazChong
1
Этот ответ мне тоже помог, спасибо. Это может быть улучшено, если ваш enum наследуется от String, тогда вам не нужно переключать строки
Gobe
27

Чтобы расширить ответ @ Toka, вы также можете добавить в перечисление необработанное представимое значение и использовать необязательный конструктор по умолчанию для создания перечисления без switch:

enum MediaType: String, Decodable {
  case audio = "AUDIO"
  case multipleChoice = "MULTIPLE_CHOICES"
  case other

  init(from decoder: Decoder) throws {
    let label = try decoder.singleValueContainer().decode(String.self)
    self = MediaType(rawValue: label) ?? .other
  }
}

Он может быть расширен с помощью пользовательского протокола, который позволяет реорганизовать конструктор:

protocol EnumDecodable: RawRepresentable, Decodable {
  static var defaultDecoderValue: Self { get }
}

extension EnumDecodable where RawValue: Decodable {
  init(from decoder: Decoder) throws {
    let value = try decoder.singleValueContainer().decode(RawValue.self)
    self = Self(rawValue: value) ?? Self.defaultDecoderValue
  }
}

enum MediaType: String, EnumDecodable {
  static let defaultDecoderValue: MediaType = .other

  case audio = "AUDIO"
  case multipleChoices = "MULTIPLE_CHOICES"
  case other
}

Это также может быть легко расширено для выдачи ошибки, если было указано недопустимое значение перечисления, вместо значения по умолчанию для значения. С этим изменением можно ознакомиться здесь: https://gist.github.com/stephanecopin/4283175fabf6f0cdaf87fef2a00c8128 .
Код был скомпилирован и протестирован с использованием Swift 4.1 / Xcode 9.3.

Стефан Копен
источник
1
Это ответ, который я искал.
Натан Хосселтон
7

Вариант ответа @ proxpero, который является более кратким, состоит в том, чтобы сформулировать декодер как:

public init(from decoder: Decoder) throws {
    let values = try decoder.container(keyedBy: CodingKeys.self)
    guard let key = values.allKeys.first else { throw err("No valid keys in: \(values)") }
    func dec<T: Decodable>() throws -> T { return try values.decode(T.self, forKey: key) }

    switch key {
    case .count: self = try .count(dec())
    case .title: self = try .title(dec())
    }
}

func encode(to encoder: Encoder) throws {
    var container = encoder.container(keyedBy: CodingKeys.self)
    switch self {
    case .count(let x): try container.encode(x, forKey: .count)
    case .title(let x): try container.encode(x, forKey: .title)
    }
}

Это позволяет компилятору исчерпывающе проверять случаи, а также не подавляет сообщение об ошибке для случая, когда закодированное значение не соответствует ожидаемому значению ключа.

marcprux
источник
Я согласен, что это лучше.
proxpero
6

На самом деле ответы выше действительно хороши, но в них отсутствуют некоторые детали того, что нужно многим людям в постоянно развивающемся проекте клиент / сервер. Мы разрабатываем приложение, в то время как наш бэкэнд постоянно развивается с течением времени, что означает, что некоторые перечисленные случаи изменят эту эволюцию. Поэтому нам нужна стратегия декодирования перечислений, которая способна декодировать массивы перечислений, которые содержат неизвестные регистры. В противном случае декодирование объекта, содержащего массив, просто не удастся.

То, что я сделал, довольно просто:

enum Direction: String, Decodable {
    case north, south, east, west
}

struct DirectionList {
   let directions: [Direction]
}

extension DirectionList: Decodable {

    public init(from decoder: Decoder) throws {

        var container = try decoder.unkeyedContainer()

        var directions: [Direction] = []

        while !container.isAtEnd {

            // Here we just decode the string from the JSON which always works as long as the array element is a string
            let rawValue = try container.decode(String.self)

            guard let direction = Direction(rawValue: rawValue) else {
                // Unknown enum value found - ignore, print error to console or log error to analytics service so you'll always know that there are apps out which cannot decode enum cases!
                continue
            }
            // Add all known enum cases to the list of directions
            directions.append(direction)
        }
        self.directions = directions
    }
}

Бонус: Скрыть реализацию> Сделать коллекцию

Скрывать детали реализации всегда хорошая идея. Для этого вам понадобится немного больше кода. Хитрость заключается в том, чтобы соответствовать , DirectionsListчтобы Collectionи сделать свой внутренний listмассив частным:

struct DirectionList {

    typealias ArrayType = [Direction]

    private let directions: ArrayType
}

extension DirectionList: Collection {

    typealias Index = ArrayType.Index
    typealias Element = ArrayType.Element

    // The upper and lower bounds of the collection, used in iterations
    var startIndex: Index { return directions.startIndex }
    var endIndex: Index { return directions.endIndex }

    // Required subscript, based on a dictionary index
    subscript(index: Index) -> Element {
        get { return directions[index] }
    }

    // Method that returns the next index when iterating
    func index(after i: Index) -> Index {
        return directions.index(after: i)
    }
}

Вы можете прочитать больше о соответствии пользовательских коллекций в этом сообщении в блоге Джона Санделла: https://medium.com/@johnsundell/creating-custom-collections-in-swift-a344e25d0bb0

blackjacx
источник
5

Вы можете делать то, что вы хотите, но это немного связано :(

import Foundation

enum PostType: Codable {
    case count(number: Int)
    case comment(text: String)

    init(from decoder: Decoder) throws {
        self = try PostTypeCodableForm(from: decoder).enumForm()
    }

    func encode(to encoder: Encoder) throws {
        try PostTypeCodableForm(self).encode(to: encoder)
    }
}

struct PostTypeCodableForm: Codable {
    // All fields must be optional!
    var countNumber: Int?
    var commentText: String?

    init(_ enumForm: PostType) {
        switch enumForm {
        case .count(let number):
            countNumber = number
        case .comment(let text):
            commentText = text
        }
    }

    func enumForm() throws -> PostType {
        if let number = countNumber {
            guard commentText == nil else {
                throw DecodeError.moreThanOneEnumCase
            }
            return .count(number: number)
        }
        if let text = commentText {
            guard countNumber == nil else {
                throw DecodeError.moreThanOneEnumCase
            }
            return .comment(text: text)
        }
        throw DecodeError.noRecognizedContent
    }

    enum DecodeError: Error {
        case noRecognizedContent
        case moreThanOneEnumCase
    }
}

let test = PostType.count(number: 3)
let data = try JSONEncoder().encode(test)
let string = String(data: data, encoding: .utf8)!
print(string) // {"countNumber":3}
let result = try JSONDecoder().decode(PostType.self, from: data)
print(result) // count(3)
Говард Ловатт
источник
интересный хак
Роман Филиппов