Archives and Serialization アーカイブとシリアライゼーション

Convert objects and values to and from property list, JSON, and other flat binary representations. オブジェクトと値をプロパティリスト、JSON、そして平坦なバイナリ表現へとおよびそれから変換します。

Overview 概要

Use these APIs to convert your app’s in-memory types to representations suitable for serialization over I/O and network interfaces or to long-term storage.

In Swift, the standard library defines the Encodable, Decodable, and Codable types, along with Encoder and Decoder APIs to perform encoding and decoding, as described in Encoding, Decoding, and Serialization. Foundation extends this with the EncodableWithConfiguration and DecodableWithConfiguration protocols, used for types that require additional static information to encode and decode, such as AttributedString.

In Objective-C, NSCoding defines a protocol for encoding and decoding objects. When adding serialization to your own types, you should also adopt NSSecureCoding. This protocol adds protection against security vulnerabilities introduced by instantiating arbitrary objects as part of the decoding process.

Many system frameworks use these types. When working with external systems, such as URL endpoints, use the JSON and XML APIs to serialize your app’s types to standard formats.

Topics 話題

Adopting Codability

NSCoding

A protocol that enables an object to be encoded and decoded for archiving and distribution. あるオブジェクトにアーカイブと配布のためにエンコードおよびデコードされることを可能にするプロトコル。

NSSecureCoding

A protocol that enables encoding and decoding in a manner that is robust against object substitution attacks. エンコーディングとデコーディングを、オブジェクト置き換え攻撃に対して堅牢なある流儀で可能にするプロトコル。

JSON

Using JSON with Custom Types JSONをあつらえの型で使う

Encode and decode JSON data, regardless of its structure, using Swift’s JSON support. JSONデータをエンコードおよびデコードします、それの構造に関係なく、SwiftのJSONサポートを使います。

NSJSONSerialization

An object that converts between JSON and the equivalent Foundation objects. JSONと同等のFoundationオブジェクト間で変換するオブジェクト。

Property Lists プロパティ・リスト

NSPropertyListSerialization

An object that converts between a property list and one of several serialized representations. あるプロパティリストといくつかのシリアライズされた表現のうちの１つの間で変換をするオブジェクト。

XML

XML Processing and Modeling XMLの処理とモデリング

Parse XML documents. XML文書の構文解析。

Keyed Archivers キー付きアーカイバ

NSKeyedArchiver

An encoder that stores an object’s data to an archive referenced by keys. あるオブジェクトのもつデータをキーそれらによって参照されるアーカイブに格納するエンコーダ。

NSKeyedArchiverDelegate

The optional methods implemented by the delegate of a keyed archiver. キー付きアーカイバの委任先によって実装される随意のメソッド。

NSKeyedUnarchiver

A decoder that restores data from an archive referenced by keys. キーそれらによって参照をつけられるあるアーカイブからデータを復元するデコーダ。

NSKeyedUnarchiverDelegate

The optional methods implemented by the delegate of a keyed unarchiver. キー付きアンアーカイバの委任先によって実装される随意のメソッド。

NSCoder

An abstract class that serves as the basis for objects that enable archiving and distribution of other objects. 他のオブジェクトのアーカイブと配布を可能にするオブジェクトの基礎として奉仕する抽象クラス。

NSSecureUnarchiveFromDataTransformer

A value transformer that converts data to and from classes that support secure coding. ある値トランスフォーマ、それはデータを保安コード化をサポートするクラスへとそしてそれから変換します。