コーダーと Codeable モデルを操作する

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：1分

    • Mobile SDKのiOS実装は、コーダーとCodableモデルの追加機能を提供します。

    コーダー列挙

    Coder列挙体は、JSONEncoderと付随するJSONDecoderをラップして、両方が同じコーディング戦略を提供するようにします。Codable モデルを処理する NowData フレームワーク API の多くは、JSON からのコーディングとデコードに依存しているため、 Coder はエンコーダーとデコーダーを指定する方法を簡略化および標準化します。通常、ISO8601UTC 以外の日付形式を使用して日付をエンコードおよびデコードする既定の Coder (.default) を使用するだけで十分です。DateFormatter.nonISO8601UTC は、NowData フレームワークによって提供される静的な日付フォーマッターです。デバイスのロケールとタイムゾーンを考慮して、 ServiceNow プラットフォームによって UTC (GMT + 0) タイムゾーンで保存された日付のエンコードとデコードを担当し、 テーブルの API によって yyyy-MM-dd HH:MM:SS 形式で使用されます。

    特定の日付形式を処理する場合など、カスタム JSON コーディングが必要な場合は、カスタム JSONEncoder と JSONDecoder をカスタム Coder の関連型として指定することで、カスタム Coder を作成できます。エンコーダーとデコーダーの両方で同じコーディング戦略を使用する必要があります。

    例：

    let myEncoder = JSONEncoder()
myEncoder.dateEncodingStrategy = .formatted(.nonISO8601UTC)
let myDecoder = JSONDecoder()
myDecoder.dateDecodingStrategy = .formatted(.nonISO8601UTC)

let myCoder: Coder = .custom(myEncoder, myDecoder)

    ネストされた構造のコード可能な拡張

    NowData フレームワークには、ドット区切りのパスでネストされた構造をデコードする機能があります。この機能により、ラッパー構造とネストされた JSON デコードを使用する必要がなくなるため、ネストされたデータを簡単に使用できます。