Android 应用内部网络请求管理：实现应用专属数据使用限制策略

// SharedPreferences 键定义
const val PREFS_NAME = "app_network_prefs"
const val KEY_OFFLINE_MODE = "offline_mode_enabled"

// 帮助类或工具函数来管理网络模式状态
object NetworkModeManager {

    private fun getSharedPreferences(context: Context): SharedPreferences {
        return context.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE)
    }

    /**
     * 设置应用是否处于离线模式
     * @param context Context
     * @param isOfflineMode true 表示离线模式，false 表示在线模式
     */
    fun setOfflineMode(context: Context, isOfflineMode: Boolean) {
        getSharedPreferences(context).edit().putBoolean(KEY_OFFLINE_MODE, isOfflineMode).apply()
    }

    /**
     * 获取应用当前是否处于离线模式
     * @param context Context
     * @return true 如果处于离线模式，否则为 false
     */
    fun isOfflineModeEnabled(context: Context): Boolean {
        return getSharedPreferences(context).getBoolean(KEY_OFFLINE_MODE, false) // 默认在线模式
    }
}

// 假设你的 Retrofit 接口
interface MyApiService {
    @GET("data")
    suspend fun fetchData(): Response<MyData>
}

// 在 ViewModel 或 Repository 中使用
class MyRepository(private val apiService: MyApiService, private val context: Context) {

    suspend fun loadData(): Result<MyData> {
        if (NetworkModeManager.isOfflineModeEnabled(context)) {
            // 如果处于离线模式，直接返回一个表示离线的本地数据或错误
            return Result.failure(OfflineModeException("App is in offline mode."))
        }

        return try {
            val response = apiService.fetchData()
            if (response.isSuccessful) {
                response.body()?.let { Result.success(it) }
                    ?: Result.failure(Exception("Empty response body"))
            } else {
                Result.failure(HttpException(response))
            }
        } catch (e: Exception) {
            Result.failure(e)
        }
    }
}

// 自定义异常（可选）
class OfflineModeException(message: String) : IOException(message)

import okhttp3.Interceptor
import okhttp3.MediaType.Companion.toMediaTypeOrNull
import okhttp3.Protocol
import okhttp3.Response
import okhttp3.ResponseBody.Companion.toResponseBody
import java.io.IOException

class OfflineModeInterceptor(private val context: Context) : Interceptor {

    override fun intercept(chain: Interceptor.Chain): Response {
        if (NetworkModeManager.isOfflineModeEnabled(context)) {
            // 如果处于离线模式，则拦截请求并返回一个模拟的“离线”响应
            return Response.Builder()
                .request(chain.request())
                .protocol(Protocol.HTTP_1_1)
                .code(503) // Service Unavailable, 或自定义一个状态码
                .message("App is in offline mode")
                .body("{\"message\":\"App is in offline mode\"}".toResponseBody("application/json".toMediaTypeOrNull()))
                .sentRequestAtMillis(System.currentTimeMillis())
                .receivedResponseAtMillis(System.currentTimeMillis())
                .build()
        }
        // 否则，正常执行请求
        return chain.proceed(chain.request())
    }
}

import okhttp3.OkHttpClient
import retrofit2.Retrofit
import retrofit2.converter.gson.GsonConverterFactory
import java.util.concurrent.TimeUnit

object RetrofitClient {

    fun getApiService(context: Context): MyApiService {
        val okHttpClient = OkHttpClient.Builder()
            .addInterceptor(OfflineModeInterceptor(context)) // 添加离线模式拦截器
            .connectTimeout(30, TimeUnit.SECONDS)
            .readTimeout(30, TimeUnit.SECONDS)
            .build()

        val retrofit = Retrofit.Builder()
            .baseUrl("https://api.example.com/") // 替换为你的 API 基地址
            .client(okHttpClient)
            .addConverterFactory(GsonConverterFactory.create())
            .build()

        return retrofit.create(MyApiService::class.java)
    }
}

<!-- activity_settings.xml -->
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="16dp">

    <Switch
        android:id="@+id/offlineModeSwitch"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="启用离线模式"
        android:textSize="18sp"
        android:paddingVertical="8dp"/>

</LinearLayout>

// SettingsActivity.kt
class SettingsActivity : AppCompatActivity() {

    private lateinit var offlineModeSwitch: Switch

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_settings)

        offlineModeSwitch = findViewById(R.id.offlineModeSwitch)

        // 初始化开关状态
        offlineModeSwitch.isChecked = NetworkModeManager.isOfflineModeEnabled(this)

        // 监听开关变化
        offlineModeSwitch.setOnCheckedChangeListener { _, isChecked ->
            NetworkModeManager.setOfflineMode(this, isChecked)
            // 可以根据需要显示 Toast 提示用户
            val message = if (isChecked) "已启用离线模式" else "已禁用离线模式"
            Toast.makeText(this, message, Toast.LENGTH_SHORT).show()
        }
    }
}