[Swift 4]SwiftのCodableのチュートリアルについてまとめました [翻訳]

# Codableのページの翻訳

勉強がてらでやりました。
今回はSwift4で導入されたCodableについてのチュートリアルがありましたので下記のページを翻訳しました。  
QiitaでもCodableがとても人気なので情報のまとめとしてはいいかと思いました。

[Encoding, Decoding and Serialization in Swift 4](https://www.raywenderlich.com/172145/encoding-decoding-and-serialization-in-swift-4)

以下、翻訳内容です。

翻訳が芳しくなかったりプログラミング的な表現がおかしい箇所があるかもしれませんので、
お気軽にご指摘ください。翻訳の許可自体は頂いてます。

(個人的にはrepresentation(=表現)が合ってるかわかりませんでした。)

## Swift 4でのエンコーディング、デコード、シリアル化について

これはSwift 4のために完全に更新されたいくつかの新しい章を含むベストセラーのSwift Apprenticeからまとめた章です。 このチュートリアルは、[iOS 11 Launch Party](https://www.raywenderlich.com/171242/introducing-the-ios-11-launch-party)の一部として提供されています。楽しんでください！

データをファイルに保存するか、またはネットワーク経由で送信する必要があるいくつかのシナリオがあります。 このチュートリアルでは、インスタンスを文字列やバイトのストリームなどと言った別の表現に変換することで、これらのタスクを達成する方法を学習します。 このプロセスは**エンコーディング**としても知られるし、**シリアライゼーション**として知られています。

データをインスタンスに変換する逆のプロセスは、**デコード**または**デシリアライゼーション**と呼ばれます。

ファイルに書き込むインスタンスがあるとします。 インスタンス自体はそのままファイルに書き込むことができないので、バイトのストリームのように別の表現にエンコードする必要があります。

![encode.png](https://qiita-image-store.s3.amazonaws.com/0/44392/58f48f1b-47b5-a6db-9997-ce5799cd6e89.png)

データがエンコードされてファイルに保存されたら、デコーダを使用していつでもインスタンスに戻すことができます。

![decode.png](https://qiita-image-store.s3.amazonaws.com/0/44392/c7b2bdf9-f17e-3194-2931-98ced7846733.png)

## Encodable and Decodable Protocols (エンコードやデコードができるプロトコル)

**Encodable**プロトコルは、別の表現にエンコードできる型によって使用されます。 それは単一のメソッドを宣言します：

```sample.swift
func encode(to: Encoder) throws
```

その型のすべてのストアドプロパティが**Encodable**にも準拠する場合、コンパイラによって生成されます。 これについては後ほどチュートリアルで学習します。

**Decodable**プロトコルは、デコード可能な型によって使用されます。 それはただ一つの初期化を宣言します：

```sample.swift
init(from decoder: Decoder) throws
```

このチュートリアルの最後で、これらのメソッドを実装するタイミングと方法がわかります。

## What is Codable? (Codableとは何か)

**Codable**とは、エンコードやデコードが可能であることを宣言するために型が準拠することができるプロトコルです。これは、基本的にエンコード可能なプロトコルとデコード可能なプロトコルの別名(=alias)です。

```sample.swift
typealias Codable = Encodable & Decodable
```

## Automatic Encoding and Decoding(エンコードとデコードの自動化)

Swiftには、標準ライブラリとFoundationフレームワークからInt、String、Date、Arrayや他にも数多くの型が用意されています。 型をcodable(コード化)にするには、**Codable**に準拠させ、すべての格納プロパティもcodable(コード化)であることを確認するのが最も簡単な方法です。

たとえば、おもちゃ工場を所有していて、従業員(Employee)データを格納するこの構造体があるとします。

```sample.swift
struct Employee {
    var name: String
    var id: Int
}
```
この型をエンコードしたりデコードできるようにするために必要なのは、以下のように**Codable**プロトコルに従うことだけです。

```sample.swift
struct Employee: Codable {
    var name: String
    var id: Int
}
```

うわー、それは簡単でした！ name（String）とid（Int）の両方がコード可能であるため、これを実行できました。

既にCodableな型のみを使用している場合は、これがうまく動作します。 しかし、あなたの型に、プロパティとして他のカスタムな型が含まれている場合はどうでしょうか？ たとえば、**Employee**構造体を見て、それには**favoriteToy**プロパティもあるとします。

```sample.swift
struct Employee: Codable {
    var name: String
    var id: Int
    var favoriteToy: Toy
}

struct Toy: Codable {
    var name: String
}
```
**Toy**が*Codable**にも準拠していることを確認することで、**Employee**の**Codable**もまた全体的な適合性を維持します。

**Array**や**Dictionary**などのすべてのコレクション型には、codableな型が含まれている場合はcodableです。

## Encoding and Decoding Custom Types (カスタムな型のエンコードとデコード処理)

XMLやプロパティリストなど、エンコードまたはデコードできる表現がいくつかあります。このセクションでは、Swiftの**JSONEncoder**クラスと**JSONDecoder**クラスを使用して、JSONのエンコードとデコードの方法を学習します。

JSONはJavaScript Object Notationの略で、データをシリアライズする最も一般的な方法の1つです。 これは人間が簡単に読むことができ、コンピュータが解析して生成することが容易です。

たとえば、**Employee**型のインスタンスをJSONにエンコードする場合、次のようになります。

```sample.json
{ "name": "John Appleseed", "id": 7 }
```

```shaping.json
{
    "name": "John Appleseed",
    "id": 7
}
```

**Employee**インスタンスがJSONにシリアライズされる前の様子を簡単に理解できます。

## JSONEncoder and JSONDecoder

コード化可能な型を取得したら、**JSONEncoder**を使用して型を、ファイルに書き込むかまたはネットワーク経由で送ることができる、データに変換します。 このEmployeeのインスタンスがあるとします。

```sample.swift
let toy1 = Toy(name: "Teddy Bear");
let employee1 = Employee(name: "John Appleseed", id: 7, favoriteToy: toy1)
```
ジョンの誕生日が近づいてきて、あなたは彼に彼のお気に入りのおもちゃを贈り物として与えたいと思っています。 このデータをGifts部門に送信する必要があります。 これを行う前に、次のようにエンコードする必要があります。

```sample.swift
let jsonEncoder = JSONEncoder()
let jsonData = try jsonEncoder.encode(employee1)
```

**encode（_ :)**が失敗してエラーが出る可能性があるので、**try**を使用する必要があることがわかります。

このように**jsonData**を印刷しようとすると：

```sample.swift
print(jsonData)
```

Xcodeがデータを省略し、**jsonData**のバイト数のみを提供することがわかります。 **jsonData**には**employee1**の解読不能な表現が含まれているので、これは問題ありません。 このJSONの読み取り可能なバージョンを文字列(String)として作成する場合は、**String**で初期化処理をします。

```sample.swift
let jsonString = String(data: jsonData, encoding: .utf8)
print(jsonString)
// {"name":"John Appleseed","id":7,"favoriteToy":{"name":"Teddy Bear"}}
```

これで特別なギフトAPIを使用して**jsonData**または**jsonString**をギフト部門に送ることができます。

JSONデータをデコードしてインスタンスに戻したい場合は、**JSONDecoder**を使用する必要があります。

```sample.swift
let jsonDecoder = JSONDecoder()
let employee2 = try jsonDecoder.decode(Employee.self, from: jsonData)
```

コンパイラはこれを自ら把握することができないため、JSONをどの型でデコードするのかをデコーダに知らせる必要があることに注意してください。

## Renaming Properties With CodingKeys (CodingKeysを使ったプロパティのリネーム)

ギフト部門のAPIでは、employeeのIDが**id**の代わりに**employeeId**として表示される必要があることが判明しました。 幸運なことに、Swiftはこの種の問題の解決方法を提供します。

### CodingKey Protocol, CodingKeys Enum

シリアル化された形式がAPIの要件と一致しない場合に備えて、**CodingKey**プロトコルに準拠する**CodingKeys**の列挙型を使用すると、特定のプロパティの名前を変更できます。

**CodingKeys**を次のようにネストした列挙型に追加します。

```sample.swift
struct Employee: Codable {
  var name: String
  var id: Int
  var favoriteToy: Toy

  enum CodingKeys: String, CodingKey {
    case id = "employeeId"
    case name
    case favoriteToy
  }
}
```
ここで注意すべき点がいくつかあります。

1. **CodingKeys**は、あなたの型のネストした列挙型です。
2. **CodingKey**に準拠している必要があります。
3. キーは常に文字列なので、生の型として**String**も必要です。
4. 名前を変更する予定がない場合でも、すべてのプロパティをenumに含める必要があります。
5. デフォルトでは、このenumはコンパイラによって作成されますが、キーの名前を変更する必要がある場合は自分で実装する必要があります。

JSONをプリントすると、保存されたプロパティ**id**のキーが**employeeId**に変更されたことがわかります。

```Sample.json
{ "employeeId": 7, "name": "John Appleseed", "favoriteToy": {"name":"Teddy Bear"}}
```

```Shaping.json
{
    "employeeId": 7,
    "name": "John Appleseed",
    "favoriteToy": {
        "name": "Teddy Bear"
    }
}
```

### Manual Encoding and Decoding(手動でのエンコードとデコード)

ギフト部門にデータを送信しようとすると、データが拒否されます。 今回は、employeeに送るギフトの情報がネストされた型の内部にあるべきではなく、**gift**と呼ばれるプロパティーとして存在すべきだと主張しています。 JSONは実際には次のようになります。

```Sample.json
{ "employeeId": 7, "name": "John Appleseed", "gift": "Teddy Bear" }
```

```Shaping.json
{
    "employeeId": 7,
    "name": "John Appleseed",
    "gift": "Teddy Bear"
}
```

この場合、プロパティの名前を変更するだけでなく、JSONの構造を変更する必要があるため、**CodingKeys**を使用することはできません。 独自のエンコードおよびデコードのロジックを作成する必要があります。

## The encode Function (エンコードの関数)

前述のチュートリアルで説明したように、**Codable**は実際には**Encodable**なプロトコルと**Decodable**なプロトコルのtypealias(タイプエイリアス)です。 **encode（to：Encoder）**を実装し、各プロパティをエンコードする方法を記述する必要があります。

それは複雑に聞こえるかもしれませんが、とてもシンプルです。 まず、**favoriteToy**の代わりに**gift**のキーを使用するために**CodingKeys**を更新します。

```sample.swift
enum CodingKeys: String, CodingKey {
  case id = "employeeId"
  case name
  case gift
}
```
次に、**Employee**の**Codable**への適合性を削除し、次にこのextentionを追加する必要があります。

```sample.swift
extension Employee: Encodable {
  func encode(to encoder: Encoder) throws {
    var container = encoder.container(keyedBy: CodingKeys.self)
    try container.encode(name, forKey: .name)
    try container.encode(id, forKey: .id)
    try container.encode(favoriteToy.name, forKey: .gift) //　<- ココ
  }
}
```

まず、エンコーダの**container**を返します。 これは、キーを使用してアクセスできるエンコーダの格納領域のviewです。 どのkeysをエンコードするかを選択する方法に注意してください。 重要なことは、**favoriteToy.name**を**.gift**のキーに展開します。

今すぐ停止すると、次のようなエラーが表示されます。

```
'Employee' does not conform to expected type 'Decodable'
```

これは、**Codable**への適合性を削除し、**Encodable**への適合性のみを追加したためです。 今のところ、**jsonString**を**employee2**にデコードするコードをコメントアウトできます。

もう一度**jsonString**をprintすると、次のようになります。

```
{"name":"John Appleseed","gift":"Teddy Bear","employeeId":7}
```

成功しました。

## The decode Function (デコードの関数)

データがギフト部門に届くと、システム内でこのJSONをインスタンスに変換する必要があります。 このためにはデコーダが必要です。

以下のコードをplaygroundに追加して、**Employee**を**Decodable**（したがって**Codable**にも）に準拠させます。

```sample.swift
extension Employee: Decodable {
  init(from decoder: Decoder) throws {
    let values = try decoder.container(keyedBy: CodingKeys.self)
    name = try values.decode(String.self, forKey: .name)
    id = try values.decode(Int.self, forKey: .id)
    let gift = try values.decode(String.self, forKey: .gift)
    favoriteToy = Toy(name: gift)
  }
}
```
ここでは、デコーダのキー付きストレージコンテナを使用して**encode**メソッドで行ったこととはかなり逆のことをしています。

## Key Points

- インスタンスをファイルに保存するかウェブに送る前にインスタンスをエンコードする（または**シリアル化**）必要があります。
- 型はコーディング可能にするために**Codable**なプロトコルに準拠する必要があります。 すべてのプロパティがコード化可能である場合、その型は自動的にコード化可能です。
- JSONは、最新のアプリケーションやWebサービスで最も一般的なエンコーディングです。**JSONEncoder**と**JSONDecoder**を使用して、JSONから型のエンコードとデコードを行うことができます。