4. 保存自定义对象——Serializable方式

4.1 原理概述

当 ViewModel 需要保存比基本类型更复杂的自定义数据模型（如用户信息、订单详情等）时，Android 的 SavedStateHandle 提供了一套基于序列化的存储机制。最简洁的方式是让自定义类实现 java.io.Serializable 接口，利用 Java 原生的序列化能力将对象转换为字节流，存储在 SavedStateHandle 中，并在进程重建时反序列化恢复。

其核心流程包含三个步骤：

• 实现接口：自定义类实现 Serializable，并确保所有字段均可序列化。
• 存储：通过 SavedStateHandle.set(key, value) 写入序列化对象。
• 恢复与空安全处理：在 ViewModel 初始化或恢复时，通过 SavedStateHandle.get<T>(key) 获取，并处理可能为 null 的情况。

4.2 实现步骤与代码

4.2.1 自定义类实现 Serializable

import java.io.Serializable

data class UserProfile(
    val id: Long,
    val name: String,
    val email: String?,
    val age: Int
) : Serializable

注意事项：

• 所有非静态内部类也必须实现 Serializable。
• 字段类型推荐使用基本类型、String、或其它已实现 Serializable 的类。
• 使用 @Transient 注解可标记不需要序列化的字段。

4.2.2 在 ViewModel 中存储和恢复

class ProfileViewModel(private val savedStateHandle: SavedStateHandle) : ViewModel() {

    companion object {
        private const val KEY_USER_PROFILE = "user_profile"
    }

    // 通过 Flow 暴露恢复后的数据（空安全处理）
    val userProfile: StateFlow<UserProfile?> = savedStateHandle
        .getStateFlow<UserProfile?>(KEY_USER_PROFILE, null)

    /**
     * 保存用户信息（每次更新时调用）
     */
    fun saveProfile(profile: UserProfile) {
        savedStateHandle[KEY_USER_PROFILE] = profile
    }

    /**
     * 获取当前保存的对象（可能为 null）
     */
    fun getSavedProfile(): UserProfile? {
        return savedStateHandle.get<UserProfile?>(KEY_USER_PROFILE)
    }
}

4.2.3 在 Fragment/Activity 中使用

class ProfileFragment : Fragment() {

    private val viewModel: ProfileViewModel by viewModels()

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)

        // 观察数据变化，安全处理空值
        viewModel.userProfile.observe(viewLifecycleOwner) { profile ->
            if (profile != null) {
                // 显示用户信息
                binding.nameTextView.text = profile.name
                binding.emailTextView.text = profile.email ?: "未设置"
            } else {
                // 显示默认状态
                binding.nameTextView.text = "未登录"
            }
        }

        // 模拟保存数据
        val testProfile = UserProfile(1L, "张三", "zhangsan@example.com", 28)
        viewModel.saveProfile(testProfile)
    }
}

4.3 Serializable 序列化与恢复流程图