android-data-layer

Android データレイヤーとオフラインファースト

手順

データレイヤーは複数のソースからのデータを調整します。

1. リポジトリパターン

• 役割：信頼できる唯一の情報源（SSOT）です。
• ロジック：リポジトリは、キャッシュデータを返すか、新しいデータを取得するかを判断します。
• 実装：

  class NewsRepository @Inject constructor(
      private val newsDao: NewsDao,
      private val newsApi: NewsApi
  ) {
      // ローカル DB のデータを信頼できる唯一の情報源として公開します
      val newsStream: Flow<List<News>> = newsDao.getAllNews()
  
      // 同期処理
      suspend fun refreshNews() {
          val remoteNews = newsApi.fetchLatest()
          newsDao.insertAll(remoteNews)
      }
  }
  

2. ローカル永続化（Room）

• 用途：プライマリーキャッシュとオフラインストレージです。
• エンティティ：@Entity データクラスを定義します。
• DAO：監視可能なデータを返すには、Flow<T> を使用します。

3. リモートデータ（Retrofit）

• 用途：バックエンドからデータを取得します。
• レスポンス：インターフェースでは suspend 関数を使用します。
• エラー処理：ネットワーク呼び出しを try-catch ブロックまたは Result ラッパーで囲み、例外（インターネット接続なし、404 など）を適切に処理します。

4. 同期

• 読み取り：「Stale-While-Revalidate」。ローカルデータをすぐに表示し、バックグラウンドで更新を開始します。
• 書き込み：「Outbox パターン」（高度な手法）。ローカルの変更をすぐに保存して「未同期」とマークし、WorkManager を使用してサーバーに変更を送信します。

5. 依存性注入

• Hilt モジュールでリポジトリのインターフェースと実装をバインドします。

  @Binds
  abstract fun bindNewsRepository(impl: OfflineFirstNewsRepository): NewsRepository