[Android] SavedStateHandle란?

📌 SavedStateHandle란?

SavedStateHandle은 Android 개발에서 ViewModel의 상태를 저장하고 복원하는데 사용되는 중요한 컴포넌트입니다. 시스템에 의한 프로세스 종료나 설정 변경과 같은 상황에서도 데이터를 안전하게 보존할 수 있게 해줍니다.

📌 번들

단, SavedStateHandle은 local이나 remote 저장소와는 다른 개념입니다.
SavedStateHandle은 안드로이드 시스템의 "saved instance state" 메커니즘을 사용합니다. 이는 메모리에 임시로 저장되는 번들(Bundle) 형태로, 다음과 같은 특징이 있습니다:

1. 저장 위치와 수명

   • 메모리상에 임시로 저장됩니다
   • 앱이 완전히 종료되면 데이터는 삭제됩니다
   • 시스템에 의한 프로세스 종료나 설정 변경 시에만 데이터가 보존됩니다

2. 적합한 사용 사례

   • 현재 화면의 UI 상태 (스크롤 위치, 입력 중인 텍스트 등)
   • 일시적으로 필요한 데이터
   • 작은 크기의 데이터 (Bundle 크기 제한이 있음)

3. 부적합한 사용 사례

   • 영구적으로 보존해야 하는 데이터
   • 큰 크기의 데이터
   • 앱이 종료되어도 유지해야 하는 데이터

영구적인 데이터 저장이 필요한 경우에는 다음과 같은 방법을 사용해야 합니다:

• SharedPreferences
• Room Database
• DataStore
• 서버 저장소

📌 주요 특징

1. 자동 상태 저장

   • 시스템에 의한 프로세스 종료 시에도 데이터가 자동으로 저장됩니다.
   • Configuration changes (화면 회전 등) 발생 시에도 데이터가 유지됩니다.

2. 다양한 데이터 타입 지원

   • 기본 타입 (Int, String, Boolean 등)
   • Parcelable 인터페이스를 구현한 커스텀 객체
   • ArrayList와 같은 컬렉션

📌 기본 사용법

ViewModel에서의 사용

kotlinCopyclass MyViewModel(
    private val savedStateHandle: SavedStateHandle
) : ViewModel() {
    
    var username: String
        get() = savedStateHandle.get<String>(KEY_USERNAME) ?: ""
        set(value) {
            savedStateHandle[KEY_USERNAME] = value
        }

    companion object {
        private const val KEY_USERNAME = "username"
    }
}

Compose에서의 사용 예시

kotlinCopy@Composable
fun UserScreen(
    viewModel: MyViewModel = viewModel()
) {
    var username by remember { mutableStateOf(viewModel.username) }
    
    Column(
        modifier = Modifier
            .fillMaxWidth()
            .padding(16.dp)
    ) {
        OutlinedTextField(
            value = username,
            onValueChange = { 
                username = it
                viewModel.username = it
            },
            label = { Text("사용자 이름") }
        )
    }
}

StateFlow와 함께 사용하기
StateFlow를 사용하면 더욱 효율적인 상태 관리가 가능합니다:

kotlinCopyclass MyViewModel(
    private val savedStateHandle: SavedStateHandle
) : ViewModel() {
    
    private val _username = savedStateHandle.getStateFlow("username", "")
    val username = _username.asStateFlow()
    
    fun updateUsername(newName: String) {
        savedStateHandle["username"] = newName
    }
}

Compose에서 StateFlow 활용

kotlinCopy@Composable
fun UserProfileScreen(
    viewModel: MyViewModel = viewModel()
) {
    val username by viewModel.username.collectAsState()
    
    Column {
        Text("현재 사용자: $username")
        
        OutlinedTextField(
            value = username,
            onValueChange = { viewModel.updateUsername(it) },
            label = { Text("사용자 이름 변경") }
        )
    }
}

📌 주의사항

1. 키 관리

   • 키 값은 상수로 관리하는 것이 좋습니다.
   • 중복되지 않는 고유한 키를 사용해야 합니다.

2. 저장 용량

   • SavedStateHandle은 메모리 제한이 있으므로 대용량 데이터는 다른 저장소를 고려해야 합니다.

3. Parcelable 구현

   • 커스텀 객체를 저장할 때는 반드시 Parcelable을 구현해야 합니다.

실제 활용 사례
복잡한 폼 데이터 관리:

class FormViewModel(
    private val savedStateHandle: SavedStateHandle
) : ViewModel() {
    
    private val _formData = savedStateHandle.getStateFlow("form_data", FormData())
    val formData = _formData.asStateFlow()
    
    fun updateField(field: String, value: String) {
        val currentData = _formData.value
        val updatedData = when(field) {
            "name" -> currentData.copy(name = value)
            "email" -> currentData.copy(email = value)
            else -> currentData
        }
        savedStateHandle["form_data"] = updatedData
    }
    
    @Parcelize
    data class FormData(
        val name: String = "",
        val email: String = ""
    ) : Parcelable
}

📌 결론

SavedStateHandle은 Android 앱에서 상태 관리를 위한 강력한 도구입니다. ViewModel과 함께 사용하면 설정 변경이나 프로세스 종료 같은 상황에서도 안정적으로 상태를 관리할 수 있습니다.