原生移动开发 / 系统课时

加载、空数据与错误状态

加载、空数据与错误状态

异步页面最容易出问题的地方不是请求本身,而是把“加载中、成功但为空、成功有内容、请求失败”混成一个布尔值。本课把四种状态建模为互斥的 UiState,再用一次失败后重试成功的完整示例验证页面切换。

学习目标

  • 能把加载、空数据、内容和错误建模为互斥状态
  • 能让重试操作重新进入 Loading,而不是叠加旧错误界面
  • 能用同一套渲染函数保证页面同一时刻只显示一种主状态

用状态模型约束页面

如果只维护 isLoading 和 hasError 两个布尔值,就可能出现“既在加载又显示错误”的非法组合。更稳妥的做法是定义一个封闭状态集合:页面任一时刻只能属于其中一种状态。

异步页面四状态与重试流转

这个模型还解决了一个常见误区:空数据不是错误。请求成功但列表长度为 0 时,应进入 Empty;只有超时、断网、服务端错误或解析失败才进入 Error。

用一个 render 函数切换界面

下面先准备一个最小布局。四个区域放在同一个 FrameLayout 中,Activity 每次渲染前先全部隐藏,再只显示当前状态对应的 View。

xml
<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <ProgressBar
        android:id="@+id/progress"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center" />

    <TextView
        android:id="@+id/content_text"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_gravity="center"
        android:gravity="center"
        android:textSize="18sp" />

    <TextView
        android:id="@+id/empty_text"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_gravity="center"
        android:gravity="center"
        android:text="暂无数据"
        android:textSize="18sp" />

    <LinearLayout
        android:id="@+id/error_group"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_gravity="center"
        android:gravity="center"
        android:orientation="vertical">

        <TextView
            android:id="@+id/error_text"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="加载失败" />

        <Button
            android:id="@+id/retry_button"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="重试" />
    </LinearLayout>
</FrameLayout>

这是布局配置,不产生控制台输出。运行时的可见区域由下面的状态渲染代码决定。

kotlin
package com.example.pagestate

import android.os.Bundle
import android.view.View
import android.widget.Button
import android.widget.LinearLayout
import android.widget.ProgressBar
import android.widget.TextView
import androidx.appcompat.app.AppCompatActivity
import java.util.concurrent.Executors

sealed interface UiState {
    data object Loading : UiState
    data object Empty : UiState
    data class Content(val items: List<String>) : UiState
    data class Error(val message: String) : UiState
}

class MainActivity : AppCompatActivity() {
    private val executor = Executors.newSingleThreadExecutor()
    private var attempt = 0

    private lateinit var progress: ProgressBar
    private lateinit var contentText: TextView
    private lateinit var emptyText: TextView
    private lateinit var errorGroup: LinearLayout
    private lateinit var errorText: TextView
    private lateinit var retryButton: Button

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

        progress = findViewById(R.id.progress)
        contentText = findViewById(R.id.content_text)
        emptyText = findViewById(R.id.empty_text)
        errorGroup = findViewById(R.id.error_group)
        errorText = findViewById(R.id.error_text)
        retryButton = findViewById(R.id.retry_button)

        retryButton.setOnClickListener { loadItems() }
        loadItems()
    }

    private fun loadItems() {
        render(UiState.Loading)

        executor.execute {
            Thread.sleep(800)

            // 第一次模拟失败,点击重试后返回三条内容。
            val result = runCatching {
                attempt++
                if (attempt == 1) error("模拟网络错误")
                listOf("Kotlin", "RecyclerView", "ImageView")
            }

            val state = result.fold(
                onSuccess = { items ->
                    if (items.isEmpty()) UiState.Empty
                    else UiState.Content(items)
                },
                onFailure = { throwable ->
                    UiState.Error(throwable.message ?: "未知错误")
                }
            )

            runOnUiThread {
                if (!isFinishing && !isDestroyed) {
                    render(state)
                }
            }
        }
    }

    private fun render(state: UiState) {
        progress.visibility = View.GONE
        contentText.visibility = View.GONE
        emptyText.visibility = View.GONE
        errorGroup.visibility = View.GONE

        when (state) {
            UiState.Loading -> progress.visibility = View.VISIBLE
            UiState.Empty -> emptyText.visibility = View.VISIBLE
            is UiState.Content -> {
                contentText.text = state.items.joinToString("\n")
                contentText.visibility = View.VISIBLE
            }
            is UiState.Error -> {
                errorText.text = state.message
                errorGroup.visibility = View.VISIBLE
            }
        }
    }

    override fun onDestroy() {
        executor.shutdownNow()
        super.onDestroy()
    }
}

预期结果

text
首次进入页面:显示 ProgressBar。
约 800 ms 后:显示“模拟网络错误”和“重试”按钮。
点击“重试”:再次显示 ProgressBar,随后显示 Kotlin、RecyclerView、ImageView 三行内容。
如果把成功结果改为 emptyList():页面显示“暂无数据”,不会显示错误区域。

重试必须重新走完整状态链

重试按钮不应直接隐藏错误提示并显示旧内容,而应重新触发数据加载:先进入 Loading,再根据新结果转到 Content、Empty 或 Error。这样用户能明确知道请求已经重新发起,页面也不会残留上一次失败的视觉状态。

真实接口接入时,只需要把示例中的模拟 runCatching 替换为仓库层请求,并继续把“成功空列表”映射到 Empty、异常映射到 Error。只要所有界面变化都经过 render(state),四种状态就能保持互斥,后续加入刷新、分页或缓存时也更容易扩展。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

加载、空数据与错误状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通