What is LiveData?

LiveData is part of Android Architecture Components released by Google. It is an Observable(it follows observer pattern) class that holds data of type that you specify. If you have worked with RxJava, it is similar to an Observable. In case of Observables you have to dispose them off manually but LiveData is lifecycle aware and will do all the cleanup on its own(If you are new to Architecture Components then read about Lifecycle before reading this article any further).

LiveData takes in an observer and notifies it about data changes only when it is in STARTED or RESUMED state. (Again, if you don’t understand what these states mean and please read the article on Lifecycle). After reading this article you must go through the official docs on LiveData.

Adding LiveData to your project

In your app level gradle file, add the following dependency.

In your project level gradle file, make sure you have google() in the repositories section.

Creating LiveData

In my experience LiveData are best suited with ViewModel(another architecture component) which we will learn about in next tutorial.

LiveData holds a value which you provide it and you can get the value by observing the LiveData. To manually set the value of a LiveData  object, you will have to use a different class called MutableLiveData . MutableLiveData inherits LiveData, here is the class from SDK.

It provides you with two functions, setValue  and postValue , you should call setValue  if you are updating the value from MainThread, if you are updating the value from a different thread, then you must use postValue .

Now code with me! In your MainActivity layout file, create a TextView and a Button.

Get a reference to the TextView and Button in your Java file.

Create a new MutableLiveData that holds data of type String .

Now lets observe the  MutableLiveData we created for changes, whenever the value contained by this MutableLiveData changes, we will set the contained value to our TextView.

We call the method observe  on our MutableLiveData which takes two parameters, LifecycleOwner and a Observer. We passed our activity in the first parameter as we already know that our activity implements LifecycleOwner interface.

Now lets change the value of MutableLiveData manually. We will assign a new random string to MutableLiveData whenever the Button is clicked.

Whenever you press the Button you will see that the value in TextView changes.

Why would I do that?

Now I can suppose you might be thinking that we could have assigned the value directly to TextView rather than doing all this hopping with LiveData. The advantage with LiveData is that when your activity goes into any state other than STARTED or RESUMED it will not call the onChanged  method on the observer. Suppose that the String that LiveData got was from a network call, now if your activity gets destroyed before the result from network call is received LiveData will not dispatch the result and would prevent any crashes. Sweet!

Never miss a post


Extending LiveData

You can also create LiveData by extending the LiveData  class. By doing this you will be able to change the value only from within the class and not from outside of it.

Lets say we have a  RealtimeDataSource that dispatches an Integer value after random intervals and we want to observe this emitted value. We will wrap our  RealtimeDataSource class in a LiveData class.

We add a listener to the  RealtimeDataSource and use the setValue method provided by LiveData to update the value.

As you can see we have overridden two functions  onActive() and  onInactive() . onActive is called when the LiveData has an active observer. onInactive is called when the LiveData has no active observers. Obviously to save network resources we only want to listen to the Realtime data when we have some active observer listening for it. So we register the listener in onActive and remove it in onInactive.

Merging result from different LiveData into one

You can merge results from different LiveData into one using MediatorLiveData . Suppose we have two LiveData objects emitting the value of a certain stock. One LiveData objects emits values from a particular source and the other from a different source. Now we want listen to the result from both of them and also want to neglect the result from second LiveData if it is less than 10.

MediatorLiveData takes in two parameters, first is the LiveData which you want MediatorLiveData to observe, second is the callback that will be triggered when the data in LiveData(passed in the first parameter) changes. You can see above we are listening changes to two different LiveData objects.

We also need to set the data to MediatorLiveData so that the Observers listening to it can be notified. Observing MediatorLiveData is same as LiveData.

By doing this you will receive results from different LiveData in the same callback. You can also use MediatorLiveData for the purpose of intercepting results from LiveData.

Transformations

Transformations class provide you with functions with which you can change the value in your LiveData object. Currently only 2 functions are provided in this class,  map and  switchMap .

map() allows you to apply changes to each value as they are emitted by the LiveData. Here is an example from the docs where a User  object is mapped to get the compete name.

swithMap  returns a new LiveData object rather than a value, i.e. it switches the actual LiveData for a new one. Here is an example from official docs, where a userId is switched to get the User object corresponding to the ID.

That is it for LiveData, now I would urge you to go and read the official docs.

Understanding Lifecycle in Android Architecture Components

How to use Room in Android – All you need to know to get started

How to make Bottom Sheet in Android

Adding 360 photo viewer in you Android App


Gurleen Sethi

How can I tell you about myself in just a few lines, to get to know me you can reach out to me, email, text, call, or any other method of communication you like. I am always there for you!

5 Comments

SANYAM jain · July 15, 2018 at 6:16 am

Great work…..precise and to the point
It always feel good to read your blogs and learn something new

Kashish · August 11, 2018 at 5:28 am

If we are using view model along with live data, do we still need to observe changes or view model will handle it ??

    Kashish · August 11, 2018 at 5:31 am

    Oh got it, sorry

How to use WorkManager in Android - TheTechnoCafe · July 23, 2018 at 4:49 pm

[…] It returns a LiveData object to listen to work status. (If you don’t know about LiveData read this […]

Leave a Reply

Your email address will not be published. Required fields are marked *

eighteen + eighteen =