原生移动开发 / 系统课时
加载、空数据与错误状态
加载、空数据与错误状态
异步页面最容易出问题的地方不是请求本身,而是把“加载中、成功但为空、成功有内容、请求失败”混成一个布尔值。本课把四种状态建模为互斥的 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),四种状态就能保持互斥,后续加入刷新、分页或缓存时也更容易扩展。
按自己的节奏,确认真正理解。