6월 3일의 ⁠#Android11: 베타 버전 출시 행사에 참여하세요.

LiveData 개요  Android Jetpack의 구성요소

LiveData는 식별 가능한 데이터 홀더 클래스입니다. 식별 가능한 일반 클래스와 달리 LiveData는 수명 주기를 인식합니다. 즉 활동, 프래그먼트 또는 서비스와 같은 다른 앱 구성요소의 수명 주기를 고려합니다. 이러한 수명 주기 인식을 통해 LiveData는 활성 수명 주기 상태에 있는 앱 구성요소 관찰자만 업데이트합니다.

Observer 클래스로 표현되는 관찰자의 수명 주기가 STARTED 또는 RESUMED 상태이면 LiveData는 관찰자를 활성 상태로 간주합니다. LiveData는 활성 관찰자에게만 업데이트 정보를 알립니다. LiveData 객체를 보기 위해 등록된 비활성 관찰자는 변경사항에 관한 알림을 받지 않습니다.

LifecycleOwner 인터페이스를 구현하는 객체와 페어링된 관찰자를 등록할 수 있습니다. 이 관계를 사용하면 관찰자에 대응되는 Lifecycle 객체의 상태가 DESTROYED로 변경될 때 관찰자를 삭제할 수 있습니다. 특히, 활동과 프래그먼트가 LiveData 객체를 안전하게 관찰할 수 있고 활동과 프래그먼트의 수명 주기가 끝나는 즉시 수신 거부되어 누출을 걱정하지 않아도 되므로 유용합니다.

LiveData 사용 방법에 관한 자세한 내용은 LiveData 객체 사용을 참조하세요.

LiveData 사용의 이점

LiveData를 사용하면 다음의 이점이 있습니다.

UI와 데이터 상태의 일치 보장
LiveData는 관찰자 패턴을 따릅니다. LiveData는 수명 주기 상태가 변경될 때 Observer 객체에 알립니다. 코드를 통합하여 이러한 Observer 객체에 UI를 업데이트할 수 있습니다. 앱 데이터가 변경될 때마다 UI를 업데이트하는 대신, 변경이 발생할 때마다 관찰자가 UI를 업데이트할 수 있습니다.
메모리 누출 없음
관찰자는 Lifecycle 객체에 결합되어 있으며 연결된 수명 주기가 끝나면 자동으로 삭제됩니다.
중지된 활동으로 인한 비정상 종료 없음
관찰자의 수명 주기가 비활성 상태(예: 활동이 백 스택에 있음)이면 관찰자는 어떤 LiveData 이벤트도 수신하지 않습니다.
수명 주기를 더 이상 수동으로 처리하지 않음
UI 구성요소는 관련 데이터를 관찰하기만 할 뿐 관찰을 중지하거나 다시 시작하지 않습니다. LiveData는 관찰하는 동안 관련 수명 주기 상태의 변경을 인식하므로 이 모든 것을 자동으로 관리합니다.
최신 데이터 유지
수명 주기가 비활성화되면 다시 활성화될 때 최신 데이터를 수신합니다. 예를 들어 백그라운드에 있었던 활동은 포그라운드로 돌아온 직후 최신 데이터를 받습니다.
적절한 구성 변경
구성 변경(예: 기기 회전)으로 인해 활동이나 프래그먼트가 다시 생성되면 사용할 수 있는 최신 정보를 즉시 수신합니다.
리소스 공유
앱에서 시스템 서비스를 공유할 수 있도록 싱글톤 패턴을 사용하는 LiveData 객체를 확장하여 시스템 서비스를 래핑할 수 있습니다. LiveData 객체가 시스템 서비스에 한 번 연결되면 리소스가 필요한 모든 관찰자가 LiveData 객체를 볼 수 있습니다. 자세한 내용은 LiveData 확장을 참조하세요.

LiveData 객체로 작업

LiveData 객체로 작업하려면 다음 단계를 따르세요.

  1. 특정 유형의 데이터를 보유할 LiveData의 인스턴스를 생성합니다. 이 작업은 일반적으로 ViewModel 클래스 내에서 이루어집니다.
  2. onChanged() 메서드를 정의하는 Observer 객체를 생성합니다. 이 메서드는 LiveData 객체가 보유한 데이터 변경 시 발생하는 작업을 제어합니다. 일반적으로 활동이나 프래그먼트 같은 UI 컨트롤러에 Observer 객체를 생성합니다.
  3. observe() 메서드를 사용하여 LiveData 객체에 Observer 객체를 연결합니다. observe() 메서드는 LifecycleOwner 객체를 사용합니다. 이렇게 하면 Observer 객체가 LiveData 객체를 구독하여 변경사항에 관한 알림을 받습니다. 일반적으로 활동이나 프래그먼트와 같은 UI 컨트롤러에 Observer 객체를 연결합니다.

LiveData 객체에 저장된 값을 업데이트하면 연결된 LifecycleOwner가 활성 상태에 있는 한 등록된 모든 관찰자가 트리거됩니다.

LiveData를 사용하면 UI 컨트롤러 관찰자가 업데이트를 구독할 수 있습니다. LiveData 객체에서 보유한 데이터가 변경되면 응답으로 UI가 자동 업데이트됩니다.

LiveData 객체 만들기

LiveData는 List와 같은 Collections를 구현하는 객체를 비롯하여 모든 데이터와 함께 사용할 수 있는 래퍼입니다. LiveData 객체는 일반적으로 ViewModel 객체 내에 저장되며 다음 예에서 보는 것과 같이 getter 메서드를 통해 액세스됩니다.

Kotlin

    class NameViewModel : ViewModel() {

        // Create a LiveData with a String
        val currentName: MutableLiveData<String> by lazy {
            MutableLiveData<String>()
        }

        // Rest of the ViewModel...
    }
    

자바

    public class NameViewModel extends ViewModel {

    // Create a LiveData with a String
    private MutableLiveData<String> currentName;

        public MutableLiveData<String> getCurrentName() {
            if (currentName == null) {
                currentName = new MutableLiveData<String>();
            }
            return currentName;
        }

    // Rest of the ViewModel...
    }
    

처음에는 LiveData 객체의 데이터가 설정되지 않습니다.

ViewModel 클래스의 이점과 사용법에 관한 자세한 내용은 ViewModel 가이드를 참조하세요.

LiveData 객체 관찰

대부분의 경우 앱 구성요소의 onCreate() 메서드는 LiveData 객체 관찰을 시작하기 적합한 장소이며 그 이유는 다음과 같습니다.

  • 시스템이 활동이나 프래그먼트의 onResume() 메서드에서 중복 호출을 하지 않도록 하기 위해서입니다.
  • 활동 또는 프래그먼트가 활성 상태가 되는 즉시 표시할 수 있는 데이터를 보유하도록 하기 위해서입니다. 앱 구성요소는 STARTED 상태가 되는 즉시 관찰하고 있던 LiveData 객체에서 가장 최신 값을 수신합니다. 이는 관찰할 LiveData 객체가 설정된 경우에만 발생합니다.

일반적으로 LiveData는 데이터가 변경될 때만, 그리고 활성 관찰자에게만 업데이트를 전달합니다. 이 동작의 예외로, 관찰자가 비활성 상태에서 활성 상태로 변경될 때에도 관찰자는 업데이트를 받습니다. 또한 관찰자가 비활성 상태에서 활성 상태로 다시 변경되면 마지막으로 활성 상태가 된 이후 값이 변경된 경우에만 업데이트를 받습니다.

다음 샘플 코드는 LiveData 객체 관찰을 시작하는 방법을 보여줍니다.

Kotlin

    class NameActivity : AppCompatActivity() {

        // Use the 'by viewModels()' Kotlin property delegate
        // from the activity-ktx artifact
        private val model: NameViewModel by viewModels()

        override fun onCreate(savedInstanceState: Bundle?) {
            super.onCreate(savedInstanceState)

            // Other code to setup the activity...

            // Create the observer which updates the UI.
            val nameObserver = Observer<String> { newName ->
                // Update the UI, in this case, a TextView.
                nameTextView.text = newName
            }

            // Observe the LiveData, passing in this activity as the LifecycleOwner and the observer.
            model.currentName.observe(this, nameObserver)
        }
    }
    

자바

    public class NameActivity extends AppCompatActivity {

        private NameViewModel model;

        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);

            // Other code to setup the activity...

            // Get the ViewModel.
            model = new ViewModelProvider(this).get(NameViewModel.class);

            // Create the observer which updates the UI.
            final Observer<String> nameObserver = new Observer<String>() {
                @Override
                public void onChanged(@Nullable final String newName) {
                    // Update the UI, in this case, a TextView.
                    nameTextView.setText(newName);
                }
            };

            // Observe the LiveData, passing in this activity as the LifecycleOwner and the observer.
            model.getCurrentName().observe(this, nameObserver);
        }
    }
    

nameObserver를 매개변수로 전달하여 observe()를 호출하면 onChanged()가 즉시 호출되어 mCurrentName에 저장된 가장 최신 값을 제공합니다. LiveData 객체가 mCurrentName에 값을 설정하지 않았다면 onChanged()는 호출되지 않습니다.

LiveData 객체 업데이트

LiveData에는 저장된 데이터를 업데이트하는 데 공개적으로 사용할 수 있는 메서드가 없습니다. MutableLiveData 클래스는 setValue(T)postValue(T) 메서드를 공개 메서드로 노출하며 LiveData 객체에 저장된 값을 수정하려면 이러한 메서드를 사용해야 합니다. 일반적으로 MutableLiveDataViewModel에서 사용되며 ViewModel은 변경이 불가능한 LiveData 객체만 관찰자에게 노출합니다.

관찰자 관계를 설정한 후에는 아래 예와 같이 사용자가 버튼을 탭할 때 모든 관찰자를 트리거하는 LiveData 객체의 값을 업데이트할 수 있습니다.

Kotlin

    button.setOnClickListener {
        val anotherName = "John Doe"
        model.currentName.setValue(anotherName)
    }
    

자바

    button.setOnClickListener(new OnClickListener() {
        @Override
        public void onClick(View v) {
            String anotherName = "John Doe";
            model.getCurrentName().setValue(anotherName);
        }
    });
    

위의 예에서 setValue(T)를 호출하면 관찰자는 John Doe 값과 함께 onChanged() 메서드를 호출합니다. 이 예에서는 버튼이 눌렸을 때를 보여주지만, setValue() 또는 postValue()는 네트워크 요청 또는 데이터베이스 로드 완료의 응답과 같은 다양한 이유로 mName을 업데이트하기 위해 호출될 수 있습니다. 모든 경우에 setValue() 또는 postValue()의 호출은 관찰자를 트리거하고 UI를 업데이트합니다.

Room으로 LiveData 사용

Room 지속성 라이브러리는 관찰 가능한 쿼리를 지원하며 이 쿼리는 LiveData 객체를 반환합니다. 식별 가능한 쿼리는 DAO(Database Access Object)의 일부로 작성됩니다.

데이터베이스가 업데이트될 때 Room에서는 LiveData 객체를 업데이트하는 데 필요한 모든 코드를 생성합니다. 생성된 코드는 필요 시 백그라운드 스레드에서 비동기적으로 쿼리를 실행합니다. 이 패턴은 UI에 표시된 데이터와 데이터베이스에 저장된 데이터의 동기화를 유지하는 데 유용합니다. Room 및 DAO에 관한 자세한 내용은 Room 지속성 라이브러리 가이드를 참조하세요.

LiveData와 함께 코루틴 사용

LiveData에는 Kotlin 코루틴 지원이 포함됩니다. 자세한 내용은 Android 아키텍처 구성요소와 함께 Kotlin 코루틴 사용을 참조하세요.

LiveData 확장

관찰자의 수명 주기가 STARTED 또는 RESUMED 상태이면 LiveData는 관찰자를 활성 상태로 간주합니다. 다음 샘플 코드는 LiveData 클래스의 확장 방법을 보여줍니다.

Kotlin

    class StockLiveData(symbol: String) : LiveData<BigDecimal>() {
        private val stockManager = StockManager(symbol)

        private val listener = { price: BigDecimal ->
            value = price
        }

        override fun onActive() {
            stockManager.requestPriceUpdates(listener)
        }

        override fun onInactive() {
            stockManager.removeUpdates(listener)
        }
    }
    

자바

    public class StockLiveData extends LiveData<BigDecimal> {
        private StockManager stockManager;

        private SimplePriceListener listener = new SimplePriceListener() {
            @Override
            public void onPriceChanged(BigDecimal price) {
                setValue(price);
            }
        };

        public StockLiveData(String symbol) {
            stockManager = new StockManager(symbol);
        }

        @Override
        protected void onActive() {
            stockManager.requestPriceUpdates(listener);
        }

        @Override
        protected void onInactive() {
            stockManager.removeUpdates(listener);
        }
    }
    

이 예에서 가격 리스너 구현에는 다음과 같은 중요한 메서드가 포함되어 있습니다.

  • onActive() 메서드는 LiveData 객체에 활성 상태의 관찰자가 있을 때 호출됩니다. 즉, 이 메서드에서 주가 업데이트 관찰을 시작해야 합니다.
  • onInactive() 메서드는 LiveData 객체에 활성 상태의 관찰자가 없을 때 호출됩니다. 수신 대기 중인 관찰자가 없으므로 StockManager 서비스에 연결된 상태를 유지할 필요가 없습니다.
  • setValue(T) 메서드는 LiveData 인스턴스의 값을 업데이트하고 모든 활성 상태의 관찰자에게 변경사항을 알립니다.

다음과 같이 StockLiveData 클래스를 사용할 수 있습니다.

Kotlin

    public class MyFragment : Fragment() {
        override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
            super.onViewCreated(view, savedInstanceState)
            val myPriceListener: LiveData<BigDecimal> = ...
            myPriceListener.observe(viewLifecycleOwner, Observer<BigDecimal> { price: BigDecimal? ->
                // Update the UI.
            })
        }
    }
    

자바

    public class MyFragment extends Fragment {
        @Override
        public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
            super.onViewCreated(view, savedInstanceState);
            LiveData<BigDecimal> myPriceListener = ...;
            myPriceListener.observe(getViewLifeycleOwner(), price -> {
                // Update the UI.
            });
        }
    }
    

observe() 메서드는 프래그먼트 뷰와 연결된 LifecycleOwner를 첫 번째 인수로 전달합니다. 이렇게 하면 이 관찰자는 소유자와 연결된 Lifecycle 객체에 결합하는 것이며 그 의미는 다음과 같습니다.

  • Lifecycle 객체가 활성 상태가 아니면 값이 변경되더라도 관찰자가 호출되지 않습니다.
  • Lifecycle 객체가 제거된 후 관찰자는 자동으로 삭제됩니다.

LiveData 객체가 수명 주기를 인식한다는 것은 여러 활동, 프래그먼트 및 서비스 간에 객체를 공유할 수 있다는 의미입니다. 예를 간단하게 유지하려면 다음과 같이 LiveData 클래스를 싱글톤으로 구현하면 됩니다.

Kotlin

    class StockLiveData(symbol: String) : LiveData<BigDecimal>() {
        private val stockManager: StockManager = StockManager(symbol)

        private val listener = { price: BigDecimal ->
            value = price
        }

        override fun onActive() {
            stockManager.requestPriceUpdates(listener)
        }

        override fun onInactive() {
            stockManager.removeUpdates(listener)
        }

        companion object {
            private lateinit var sInstance: StockLiveData

            @MainThread
            fun get(symbol: String): StockLiveData {
                sInstance = if (::sInstance.isInitialized) sInstance else StockLiveData(symbol)
                return sInstance
            }
        }
    }
    

자바

    public class StockLiveData extends LiveData<BigDecimal> {
        private static StockLiveData sInstance;
        private StockManager stockManager;

        private SimplePriceListener listener = new SimplePriceListener() {
            @Override
            public void onPriceChanged(BigDecimal price) {
                setValue(price);
            }
        };

        @MainThread
        public static StockLiveData get(String symbol) {
            if (sInstance == null) {
                sInstance = new StockLiveData(symbol);
            }
            return sInstance;
        }

        private StockLiveData(String symbol) {
            stockManager = new StockManager(symbol);
        }

        @Override
        protected void onActive() {
            stockManager.requestPriceUpdates(listener);
        }

        @Override
        protected void onInactive() {
            stockManager.removeUpdates(listener);
        }
    }
    

그리고 다음과 같이 프래그먼트에서 클래스를 사용할 수 있습니다.

Kotlin

    class MyFragment : Fragment() {

        override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
            super.onViewCreated(view, savedInstanceState)
            StockLiveData.get(symbol).observe(viewLifecycleOwner, Observer<BigDecimal> { price: BigDecimal? ->
                // Update the UI.
            })

        }
    

자바

    public class MyFragment extends Fragment {
        @Override
        public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
            super.onViewCreated(view, savedInstanceState);
            StockLiveData.get(symbol).observe(getViewLifecycleOwner(), price -> {
                // Update the UI.
            });
        }
    }
    

여러 프래그먼트 및 활동은 MyPriceListener 인스턴스를 관찰할 수 있습니다. LiveData는 하나 이상의 프래그먼트 및 활동이 공개되고 활성 상태일 때에만 시스템 서비스에 연결됩니다.

LiveData 변환

관찰자에게 LiveData 객체를 전달하기 전에 객체에 저장된 값을 변경하고 싶거나 다른 객체의 값에 따라 다른 LiveData 인스턴스를 반환해야 하는 경우가 있습니다. Lifecycle 패키지는 이러한 시나리오를 지원하는 도우미 메서드가 포함된 Transformations 클래스를 제공합니다.

Transformations.map()
LiveData 객체에 저장된 값에 함수를 적용하고 결과를 다운스트림으로 전파합니다.

Kotlin

    val userLiveData: LiveData<User> = UserLiveData()
    val userName: LiveData<String> = Transformations.map(userLiveData) {
        user -> "${user.name} ${user.lastName}"
    }
    

자바

    LiveData<User> userLiveData = ...;
    LiveData<String> userName = Transformations.map(userLiveData, user -> {
        user.name + " " + user.lastName
    });
    
Transformations.switchMap()
map()과 마찬가지로 LiveData 객체에 저장된 값에 함수를 적용하고 결과를 래핑 해제하여 다운스트림으로 전달합니다. switchMap()에 전달된 함수는 다음 예와 같이 LiveData 객체를 반환해야 합니다.

Kotlin

    private fun getUser(id: String): LiveData<User> {
      ...
    }
    val userId: LiveData<String> = ...
    val user = Transformations.switchMap(userId) { id -> getUser(id) }
    

자바

    private LiveData<User> getUser(String id) {
      ...;
    }

    LiveData<String> userId = ...;
    LiveData<User> user = Transformations.switchMap(userId, id -> getUser(id) );
    

변환 메서드를 사용하여 관찰자의 수명 주기 전반에 걸쳐 정보를 전달할 수 있습니다. 관찰자가 반환된 LiveData 객체를 관찰하고 있지 않다면 변환은 계산되지 않습니다. 변환은 느리게 계산되기 때문에 수명 주기 관련 동작은 추가적인 명시적 호출이나 종속성 없이도 암시적으로 전달됩니다.

ViewModel 객체 내에 Lifecycle 객체가 필요한 경우라면 변환은 더 나은 해결 방법이 될 수 있습니다. 예를 들어 주소를 받아서 주소의 우편번호를 반환하는 UI 구성요소가 있다고 가정해 보세요. 다음 샘플 코드와 같이 이 구성요소를 위한 기본 ViewModel을 구현할 수 있습니다.

Kotlin

    class MyViewModel(private val repository: PostalCodeRepository) : ViewModel() {

        private fun getPostalCode(address: String): LiveData<String> {
            // DON'T DO THIS
            return repository.getPostCode(address)
        }
    }
    

자바

    class MyViewModel extends ViewModel {
        private final PostalCodeRepository repository;
        public MyViewModel(PostalCodeRepository repository) {
           this.repository = repository;
        }

        private LiveData<String> getPostalCode(String address) {
           // DON'T DO THIS
           return repository.getPostCode(address);
        }
    }
    

그런 다음, UI 구성요소는 getPostalCode()를 호출할 때마다 이전 LiveData 객체에서 등록을 취소하고 새 인스턴스에 등록해야 합니다. 또한 UI 구성요소가 다시 생성되면 이전 호출의 결과를 사용하지 않고 또 다른 repository.getPostCode() 메서드 호출을 트리거합니다.

대신 다음 예에서와 같이 주소 입력의 변환으로 우편번호 조회를 구현할 수도 있습니다.

Kotlin

    class MyViewModel(private val repository: PostalCodeRepository) : ViewModel() {
        private val addressInput = MutableLiveData<String>()
        val postalCode: LiveData<String> = Transformations.switchMap(addressInput) {
                address -> repository.getPostCode(address) }

        private fun setInput(address: String) {
            addressInput.value = address
        }
    }
    

자바

    class MyViewModel extends ViewModel {
        private final PostalCodeRepository repository;
        private final MutableLiveData<String> addressInput = new MutableLiveData();
        public final LiveData<String> postalCode =
                Transformations.switchMap(addressInput, (address) -> {
                    return repository.getPostCode(address);
                 });

      public MyViewModel(PostalCodeRepository repository) {
          this.repository = repository
      }

      private void setInput(String address) {
          addressInput.setValue(address);
      }
    }
    

이 경우 postalCode 필드는 addressInput의 변환으로 정의됩니다. 앱에 postalCode 필드와 연결된 활성 상태의 관찰자가 있는 한 addressInput이 변경될 때마다 필드 값은 다시 계산되고 회수됩니다.

이 메커니즘을 사용하면 앱의 하위 수준에서 요청이 있을 때 늦게 계산되는 LiveData 객체를 생성할 수 있습니다. ViewModel 객체는 LiveData 객체의 참조를 쉽게 가져와서 그 위에 변환 규칙을 정의할 수 있습니다.

새 변환 만들기

앱에 유용할 수 있는 다양한 관련 변환이 있지만 이러한 변환은 기본적으로 제공되지 않습니다. 자체 변환을 구현하려면 다른 LiveData 객체를 수신하고 해당 객체에서 내보낸 이벤트를 처리하는 MediatorLiveData 클래스를 사용하면 됩니다. MediatorLiveData는 자신의 상태를 LiveData 소스 객체에 올바르게 전파합니다. 이 패턴에 관한 자세한 내용은 Transformations 클래스의 참조 문서를 확인하세요.

여러 LiveData 소스 병합

MediatorLiveDataLiveData의 서브클래스로, 이 클래스를 사용하여 여러 LiveData 소스를 병합할 수 있습니다. 그런 다음 MediatorLiveData 객체의 관찰자는 원본 LiveData 소스 객체가 변경될 때마다 트리거됩니다.

예를 들어, 로컬 데이터베이스나 네트워크에서 업데이트할 수 있는 LiveData 객체가 UI에 있다면 다음 소스를 MediatorLiveData 객체에 추가하면 됩니다.

  • 데이터베이스에 저장된 데이터와 연결된 LiveData 객체
  • 네트워크에서 액세스하는 데이터와 연결된 LiveData 객체

활동은 양쪽 소스에서 업데이트를 받기 위해 MediatorLiveData 객체만 관찰하면 됩니다. 자세한 예는 앱 아키텍처 가이드부록: 네트워크 상태 노출 섹션을 참조하세요.

참고 자료

LiveData 클래스에 관해 자세히 알아보려면 다음 리소스를 참조하세요.

샘플

코드랩

블로그

동영상