Jak zrobić dekodowalną wyliczenie w Swift 4?

157
enum PostType: Decodable {

    init(from decoder: Decoder) throws {

        // What do i put here?
    }

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

Co mam zrobić, aby to zakończyć? Powiedzmy też, że zmieniłem na caseto:

case image(value: Int)

Jak dostosować to do Decodable?

EDYTUJ Oto mój pełny kod (który nie działa)

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
}

Ostateczna edycja Poza tym, jak to obsłuży takie wyliczenie?

enum PostType: Decodable {
    case count(number: Int)
}
swift nub
źródło

Odpowiedzi:

262

To całkiem proste, wystarczy użyć Stringlub Intsurowych wartości, które są domyślnie przypisane.

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

imagejest kodowany do 0i blobdo1

Lub

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

imagejest kodowany do "image"i blobdo"blob"


Oto prosty przykład, jak go używać:

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
źródło
1
Wypróbowałem sugerowany przez Ciebie kod, ale nie działa. Edytowałem mój kod, aby wyświetlić JSON, który próbuję zdekodować
Swift nub
8
Wyliczenie nie może być kodowane / dekodowane wyłącznie. Musi być osadzony w strukturze. Dodałem przykład.
vadian
Oznaczę to jako poprawne. Ale ostatnia część powyższego pytania, na którą nie ma odpowiedzi. A co by było, gdyby moja enum wyglądała tak? (redagowane powyżej)
swift nub
Jeśli używasz wyliczeń ze skojarzonymi typami, musisz napisać niestandardowe metody kodowania i dekodowania. Przeczytaj artykuł Kodowanie i dekodowanie niestandardowych typów
vadian
1
O „Wyliczeniu nie można wyłącznie kodować / dekodować.”, Wydaje się być rozwiązane w iOS 13.3. Testuję iOS 13.3i iOS 12.4.3zachowują się inaczej. Pod iOS 13.3, enum może być kodowane / dekodowane wyłącznie.
AechoLiu
111

Jak sprawić, by wyliczenia ze skojarzonymi typami były zgodne z Codable

Ta odpowiedź jest podobna do @Howard Lovatt's, ale unika tworzenia PostTypeCodableFormstruktury i zamiast tego używa KeyedEncodingContainertypu dostarczonego przez firmę Apple jako właściwości w Encoderi Decoder, co ogranicza szablonowość.

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)
        }
    }
}

Ten kod działa dla mnie na 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
źródło
Uwielbiam tę odpowiedź! Na marginesie, ten przykład jest również echem w poście na objc.io o co Eitherdo kodowania
Ben Leggiero
Najlepsza odpowiedź
Peter Suwara
38

Swift wyrzuci .dataCorruptedbłąd, jeśli napotka nieznaną wartość wyliczenia. Jeśli Twoje dane pochodzą z serwera, może wysłać Ci nieznaną wartość wyliczenia w dowolnym momencie (po stronie serwera błędów, nowy typ dodany w wersji API i chcesz, aby poprzednie wersje Twojej aplikacji radziły sobie z wdzięcznością itp.) lepiej być przygotowanym i zakodować „styl obronny”, aby bezpiecznie dekodować wyliczenia.

Oto przykład, jak to zrobić, z powiązaną wartością lub bez

    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)
          }
       }
    }

I jak to wykorzystać w otaczającej strukturze:

    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)
      }
   }
Toka
źródło
1
Dzięki, twoja odpowiedź jest dużo łatwiejsza do zrozumienia.
DazChong
1
Ta odpowiedź też mi pomogła, dzięki. Można to poprawić, ustawiając wyliczenie jako dziedziczenie po łańcuchu, a następnie nie trzeba przełączać łańcuchów
Gobe
27

Aby rozszerzyć odpowiedź @ Toka, możesz również dodać nieprzetworzoną reprezentowalną wartość do wyliczenia i użyć domyślnego opcjonalnego konstruktora do zbudowania wyliczenia bez 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
  }
}

Można go rozszerzyć za pomocą własnego protokołu, który pozwala na refaktoryzację konstruktora:

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
}

Można go również łatwo rozszerzyć w celu zgłaszania błędu, jeśli określono nieprawidłową wartość wyliczenia, zamiast domyślnej wartości. Streszczenie tej zmiany jest dostępne tutaj: https://gist.github.com/stephanecopin/4283175fabf6f0cdaf87fef2a00c8128 .
Kod został skompilowany i przetestowany przy użyciu Swift 4.1 / Xcode 9.3.

Stéphane Copin
źródło
1
To jest odpowiedź, której szukałem.
Nathan Hosselton
7

Wariantem odpowiedzi @ proxpero, czyli terser, byłoby sformułowanie dekodera jako:

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)
    }
}

Dzięki temu kompilator może wyczerpująco zweryfikować przypadki, a także nie pomija komunikatu o błędzie w przypadku, gdy zakodowana wartość nie jest zgodna z oczekiwaną wartością klucza.

marcprux
źródło
Zgadzam się, że tak jest lepiej.
proxpero
6

W rzeczywistości powyższe odpowiedzi są naprawdę świetne, ale brakuje w nich niektórych szczegółów potrzebnych wielu osobom w stale rozwijanym projekcie klient / serwer. Tworzymy aplikację, podczas gdy nasz backend nieustannie ewoluuje w czasie, co oznacza, że ​​niektóre przypadki wyliczenia zmienią tę ewolucję. Potrzebujemy więc strategii dekodowania wyliczeń, która jest w stanie dekodować tablice wyliczeń, które zawierają nieznane przypadki. W przeciwnym razie dekodowanie obiektu zawierającego tablicę po prostu się nie powiedzie.

To, co zrobiłem, jest dość proste:

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
    }
}

Bonus: Ukryj implementację> Uczyń z niej kolekcję

Ukrywanie szczegółów implementacji jest zawsze dobrym pomysłem. Do tego potrzebujesz trochę więcej kodu. Sztuczka polega na dostosowaniu DirectionsListsię Collectioni uczynieniu swojej wewnętrznej listtablicy prywatną:

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)
    }
}

Możesz przeczytać więcej o dostosowywaniu się do niestandardowych kolekcji w tym poście na blogu Johna Sundella: https://medium.com/@johnsundell/creating-custom-collections-in-swift-a344e25d0bb0

blackjacx
źródło
5

Możesz robić, co chcesz, ale jest to trochę skomplikowane :(

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)
Howard Lovatt
źródło
ciekawy hack
Roman Filippov