[Android] MVVM (Model-View-ViewModel) 패턴이란? 예제 포함

MVVM (Model-View-ViewModel) 이란?

MVVM은 애플리케이션의 책임을 세 부분으로 분리하여 코드를 더 쉽게 테스트하고, 유지보수하고, 확장할 수 있도록 돕는 디자인 패턴입니다.

• Model (모델):
  • 역할: 데이터와 비즈니스 로직을 담당합니다. 데이터베이스, 네트워크 API, 데이터 조작 등 데이터 관련된 모든것이 여기에 포함됩니다.
  • 안드로이드 구현: Repository 클래스와 Data Class (Kotlin)를 사용하여 구현합니다.
• View (뷰): 
  • 역할: 사용자에게 보이는 UI (화면)를 담당하여, 사용자의 입력을 받고 ViewModel에 전달합니다. Model이나 비즈니스 로직에 대해 알지 못하고, 단순히 ViewModel이 제공하는데이터를 표시합니다.
  • 안드로이드 구현: Activity 또는 Fragment (XML 레이아웃 포함) 입니다. 
• ViewModel (뷰모델):
  • 역할: View와 Model 사이의 중개자(Mediator) 역할을합니다. View가 표시할 데이터를 준비하고, View의 수명 주기(Lifecycle)를 고려하지 않고 데이터를 안전하게 보존합니다.
  • 안드로이드 구현: JetPack ViewModel 클래스를 사용합니다.

 

MVVM을 사용하는 이유와 시점

1. MVVM을 사용해야 하는 이유

장점	설명
관심사의 분리	UI 코드(`View`)와비즈니스 로직/데이터 처리(Model, ViewModel)가 명확하게 분리되어 코드의 가독성이 높아지고 특정 부분을 변경할 때 다른 부분에 미치는 영향이 최소화됩니다.
테스트 용이성	`ViewModel`은 Android Framework에 의존하지 않으므로, UI나 `Activity`없이 순수Kotlin/Java 코드로 로직을 단위 테스트하기가 매우 쉽습니다
수명 주기 안전성	ViewModel은 `Activity`가 화면 회전 등으로 재생되더라도 데이터를 안전하게 유지하며, 사용자 경험을 저해하는 데이터 손실을 방지합니다.

 

2. MVVM을 사용해야 하는 시점

• 중규모 이상의 앱 개발 시: 단순한 'Hello World' 앱을 넘어 데이터 처리, 네트워크 통신, 사용자 입력 처리 등 복잡한 로직이 필요한 경우, MVVM은 필수적입니다.
• 협업 프로젝트 시: 명확한 역할 분담으로 여러 개발자가 동시에 작업하기 용이합니다.
• 장기적으로 유지보수가 필요한 앱: 앱의 규모가 커지거나 요구사항이 계속 변경될 때, MVVM 구조는 확장에 유리합니다.

 

핵심 라이브러리 및 구현

안드로이드에서 MVVM을 구현할 때 사용하는 Jetpack 라이브러입니다.

1. ViewModel (핵심)

• 기능: `Activity`나 `Fragment`의 수명 주기를 인식하여, UI가 파괴되고 다시 생성될 때 (예: 화면 회전) 데이터가 손실되지 않도록 UI 관련 데이터를 저장하고 관리합니다.
• 의존성 추가 (build.gradle.kts - app 모듈):

implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:2.6.2") // 최신 버전 사용 권장

 

2. LiveData / SataeFlow (데이터 관찰)

• 기능: `ViewModel`의 데이터가 변경될 때 `View`에 자동으로 알림을 보내 UI를 업데이트하도록 돕는 관찰 가능한 데이터 홀더입니다. `View`의 수명 주기(Lifecycle)을 인식하여 메모리 누수를 방지합니다.
• 의존성 추가: 보통 `ViewModel` 의존성에 함께 포함됩니다.

 

3. Hilt / Koin (의존성 주입 - DI)

• 기능: Repository나 다른 클래스들을 ViewModel에 간편하게 제공하고 관리합니다. 이는 대규모 앱에서 객체 생성을깔끔하게 처리하는데 필수적입니다. 

 

MVVM 예제: 간단한 카운터 앱

사용자가 버튼을 누를 때 마다 숫자가 증가하고, 화면 회전 시에도 숫자가 유지되는 카운터 앱을 MVVM으로 구현해 보겠습니다.

 

1. Model (Data Class & Repository)

이 예시에서는 간단한 숫자 데이터만 다루므로 `Repository`는 생략하고 `ViewModel`에서 직접 처리합니다.

 

2. ViewModel (kotlin)

`CounterViewModel.kt`

import androidx.lifecycle.LiveData
import androidx.lifecycle.MutableLiveData
import androidx.lifecycle.ViewModel

class CounterViewModel : ViewModel() {
    // 1. MutableLiveData: ViewModel 내부에서 데이터를 변경(write)할 수 있도록 합니다.
    private val _count = MutableLiveData<Int>()
    
    // 2. LiveData: View(Activity/Fragment)에서 데이터를 관찰(read)만 할 수 있도록 노출합니다.
    // 이는 외부에서의 임의적인 데이터 변경을 막아줍니다.
    val count: LiveData<Int>
        get() = _count

    init {
        // ViewModel이 처음 생성될 때 초기값을 설정합니다.
        _count.value = 0 
    }

    // 3. 비즈니스 로직: 숫자를 증가시키는 메서드를 제공합니다.
    fun incrementCount() {
        // value 속성을 통해 LiveData의 값을 변경합니다.
        _count.value = (_count.value ?: 0) + 1 
    }
}

 

3. View (Activity - Kotlin + XML)

`MainActivity.kt`

import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import androidx.activity.viewModels // by viewModels() 델리게이트를 사용하기 위한 확장 함수
import com.example.myapplication.databinding.ActivityMainBinding

class MainActivity : AppCompatActivity() {

    // View Binding 설정
    private lateinit var binding: ActivityMainBinding

    // ViewModel 초기화: Android Jetpack의 'by viewModels()'를 사용하여 ViewModel을 가져옵니다.
    // 화면 회전 시에도 동일한 인스턴스를 유지합니다.
    private val viewModel: CounterViewModel by viewModels()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        
        binding = ActivityMainBinding.inflate(layoutInflater)
        setContentView(binding.root)

        // 1. LiveData 관찰 (Observing):
        // viewModel.count의 변화를 관찰합니다. 변화가 생길 때마다 { it: Int -> ... } 코드가 실행됩니다.
        viewModel.count.observe(this) { newCount ->
            // UI 업데이트 로직 (View의 역할)
            binding.textViewCounter.text = "Count: $newCount"
        }

        // 2. 사용자 입력 처리 (View의 역할)
        binding.buttonIncrement.setOnClickListener {
            // 사용자 액션을 ViewModel에 전달합니다. (ViewModel의 로직 호출)
            viewModel.incrementCount()
        }
    }
}

 

`activity_main.xml`

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

    <TextView
        android:id="@+id/textView_counter"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textSize="32sp"
        android:text="Count: 0"/>

    <Button
        android:id="@+id/button_increment"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Increment"/>

</LinearLayout>