Android应用内数据使用管理：Kotlin与Retrofit的离线模式实现

import android.content.Context
import android.content.SharedPreferences

object AppNetworkManager {

    private const val PREFS_NAME = "app_network_prefs"
    private const val KEY_OFFLINE_MODE = "offline_mode_enabled"

    private lateinit var sharedPreferences: SharedPreferences

    fun initialize(context: Context) {
        sharedPreferences = context.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE)
    }

    /**
     * 设置应用的离线模式状态。
     * @param isOffline true 表示启用离线模式，false 表示禁用。
     */
    fun setOfflineMode(isOffline: Boolean) {
        sharedPreferences.edit().putBoolean(KEY_OFFLINE_MODE, isOffline).apply()
    }

    /**
     * 获取当前应用的离线模式状态。
     * @return true 如果离线模式已启用，否则为 false。
     */
    fun isOfflineModeEnabled(): Boolean {
        return sharedPreferences.getBoolean(KEY_OFFLINE_MODE, false) // 默认不启用离线模式
    }
}

interface ApiService {
    @GET("users")
    suspend fun getUsers(): List<User>
}

// ... 在某个ViewModel或Repository中
class UserRepository(private val apiService: ApiService) {

    suspend fun fetchUsers(): List<User> {
        // 在发起网络请求前检查离线模式
        if (AppNetworkManager.isOfflineModeEnabled()) {
            // 如果处于离线模式，可以返回缓存数据、空列表或抛出特定异常
            // 例如：
            println("App is in offline mode, cannot fetch users from network.")
            throw OfflineModeException("Cannot fetch data in offline mode.")
            // 或者返回一个空列表
            // return emptyList()
        }

        // 如果不是离线模式，则正常发起网络请求
        return apiService.getUsers()
    }
}

// 定义一个自定义异常，以便在离线模式下更容易处理
class OfflineModeException(message: String) : Exception(message)

import okhttp3.Interceptor
import okhttp3.Response
import java.io.IOException

class OfflineModeInterceptor : Interceptor {
    override fun intercept(chain: Interceptor.Chain): Response {
        if (AppNetworkManager.isOfflineModeEnabled()) {
            // 如果处于离线模式，阻止请求并抛出异常
            throw IOException("Network request blocked: App is in offline mode.")
        }
        // 否则，继续执行请求
        return chain.proceed(chain.request())
    }
}

import okhttp3.OkHttpClient
import retrofit2.Retrofit
import retrofit2.converter.gson.GsonConverterFactory

// ...

val okHttpClient = OkHttpClient.Builder()
    .addInterceptor(OfflineModeInterceptor()) // 添加离线模式拦截器
    // ... 其他拦截器或配置
    .build()

val retrofit = Retrofit.Builder()
    .baseUrl("https://api.example.com/")
    .client(okHttpClient)
    .addConverterFactory(GsonConverterFactory.create())
    .build()

val apiService = retrofit.create(ApiService::class.java)