用途
该技能用于指导 Android 应用中数据层（Data Layer）的实现。数据层的职责是协调来自多个数据源的数据，本技能围绕 Repository 模式、Room（本地持久化）、Retrofit（远程数据）以及离线优先（Offline-First）同步展开。
主要能力
1. Repository 模式
- 角色：单一数据源（Single Source of Truth，SSOT）。
- 逻辑：由 Repository 决定返回缓存数据还是获取新数据。
- 实现示例：
class NewsRepository @Inject constructor(
private val newsDao: NewsDao,
private val newsApi: NewsApi
) {
// Expose data from Local DB as the source of truth
val newsStream: Flow<List<News>> = newsDao.getAllNews()
// Sync operation
suspend fun refreshNews() {
val remoteNews = newsApi.fetchLatest()
newsDao.insertAll(remoteNews)
}
}
2. 本地持久化（Room）
- 用途：作为主要缓存与离线存储。
- 实体（Entities）：定义 @Entity 数据类。
- DAO：返回 Flow<T> 以提供可观察的数据。
3. 远程数据（Retrofit）
- 用途：从后端获取数据。
- 响应：在接口中使用 suspend 函数。
- 错误处理：将网络调用包裹在 try-catch 块或 Result 包装器中，以优雅地处理异常（如 NoInternet、404 等）。
4. 同步（Synchronization）
- 读取：采用“Stale-While-Revalidate”策略。立即展示本地数据，并触发后台刷新。
- 写入：采用“Outbox 模式”（进阶）。立即保存本地更改，标记为“未同步”，使用 WorkManager 将更改推送到服务器。
5. 依赖注入
在 Hilt 模块中将 Repository 接口绑定到实现：
@Binds
abstract fun bindNewsRepository(impl: OfflineFirstNewsRepository): NewsRepository
使用方式
该技能以指导说明与代码示例的形式提供，供开发者在实现 Android 数据层时参考。具体调用方式、安装命令或集成步骤暂未提供。
适用场景
适用于需要构建离线优先、可维护的 Android 应用数据层架构的场景，尤其是需要统一本地缓存与远程数据源、并处理数据同步的 Android 项目。
限制
资料未提供该技能的收费、价格、支持平台、实际效果或完整使用步骤等信息，这些内容暂未提供。