swift-actor-persistence

Topics in the source

• スレッドセーフな永続化のための Swift Actor
• 起動条件
• コアパターン
• Actorベースのリポジトリ
• 使い方
• @Observable ViewModel との組み合わせ
• 重要な設計上の決定
• ベストプラクティス

Swiftのactorを使用してスレッドセーフなデータ永続化レイヤーを構築するパターン。メモリキャッシュとファイルバックドストレージを組み合わせ、actorモデルを活用してコンパイル時にデータ競合を排除する。 Swift 5.5以降でデータ永続化レイヤーを構築する場合 共有可変状態へのスレッドセーフアクセスが必要な場合 手動の同期（ロック、DispatchQueue）を排除したい場合 ローカルストレージを持つオフラインファースとアプリを構築する場合 Actorモデルはシリアライズされたアクセスを保証する——コンパイラによって強制されるデータ競合なし。 Actorの分離により、すべての呼び出しは自動的に非同期になる： | 決定 | 理由 | |----------|-----------| | Actorを使用（クラス + ロックではなく） | コンパイラによって強制されるスレッド安全性、手動同期不要 | | メモリキャッシュ + ファイル永続化 | キャッシュからの高速読み取り、ディスクへの永続的な書き込み | | 初期化時の同期ロード | 非同期初期化の複雑さを回避 | | IDをキーとする辞書 | 識別子によるO(1)検索 | | ジェネリック Codable & Identifiable | あらゆるモデル型で再利用可能 | | アトミックなファイル書き込み（.atomic） | クラッシュ時の部分書き込みを防ぐ | Actorの境界を越えるすべてのデータに Sendable 型を使用する Actorのパブリックなアビリティを最小化する —— 永続化の詳細ではなく、ドメイン操作のみを公開する .atomic 書き込みを使用する —— 書き込み中のアプリクラッシュによるデータ破損を防ぐ init で同期的にロードする —— 非同期イニシャライザはローカルファイルに対するわずかな利点のために複雑さが増す @Observable ViewModelと組み合わせる —— リアクティブなUI更新を実現する Swiftの新しい並行処理コードでActorの代わりに DispatchQueue または NSLock を使用する 内部のキャッシュ辞書を外部の呼び出し元に公開する 初期化後にファイルURLを外部から変更可能にする（初期化時のみ設定を許可すること） すべてのActor メソッド呼び出しが await であることを忘れる——呼び出し元は非同期コンテキストを処理する必要がある Actor の分離をバイパスするために nonisolated を使用する（本末転倒） iOS/macOSアプリのローカルデータストレージ（ユーザーデータ、設定、キャッシュコンテンツ） 後でサーバーと同期するオフラインファーストアーキテクチャ アプリの複数の部分から並行アクセスされる共有可

This is an excerpt. Refer to the complete source and its current requirements.