JSONからSwiftへ
JSONのサンプルから、Codableに準拠したSwift構造体を生成します。プロパティ名はcamelCaseになり、キーと異なる場合はCodingKeys enumが追加されます。省略可能な値とnull許容値はオプショナルになり、型が混在する値には、ツールが出力に追加する小さなJSONValue enumが使われます。結果はJSONDecoderでデコードできます。
よくある質問
ネストされたオブジェクトにはどのような名前が付けられますか?
ネストされた各オブジェクトは、それを保持するキーをもとにPascalCaseで命名された独自のSwift型になります。そのため、addressはAddressになります。配列内のオブジェクトには、配列キーの単数形が使われるため、usersはUserになります。フィールドが完全に同じオブジェクトは、同じ型を共有します。
フィールドがオプションになるのはどのような場合ですか?
配列に複数のオブジェクトがあり、一部のオブジェクトでキーが欠けている場合、そのフィールドは省略可能です。型はオプショナルになり、Codableはキーが欠けているとnilとしてデコードします。すべてのサンプルに存在するキーは必須です。単一のオブジェクトには比較対象がないため、そのすべてのキーが必須になります。
null値はどのように扱われますか?
一部のサンプルでnull、ほかのサンプルで値が設定されているキーは、String?のようなオプショナルになります。常にnullのキーでは実際の型を判別できないため、JSONValue?になります。正確な型を得るには、実際の値を含むサンプルを貼り付けてください。
どの数値型が使われますか?
整数はInt、小数を含む数値はDoubleになります。両方の値を持つフィールドはDoubleになります。
有効な名前ではないキーはどうなりますか?
プロパティ名はcamelCaseに変換されます。キーと異なる名前が1つでもある場合、すべてのプロパティを対応するJSONキーにマッピングするCodingKeys enumが構造体に追加されます。defaultなどSwiftのキーワードはバッククォートで囲まれます。
JSONはアップロードまたは保存されますか?
JSONはこのリクエストのコード生成にのみ使用するためサーバーに送信され、保存されません。ジェネレーターが読み取るのはサンプルの構造と値の型だけなので、貼り付ける前に、機密性の高い値を同じ型のプレースホルダーに置き換えることができます。