MutableLiveData

Kotlin |Java

public class MutableLiveData<T> extends LiveData

Known direct subclasses

MediatorLiveData

LiveData subclass which may observe other LiveData objects and react on OnChanged events from them.

LiveData which publicly exposes setValue and postValue method.

Parameters
`<T>`	The type of data hold by this instance

Summary

Public constructors
`MutableLiveData()` Creates a MutableLiveData with no value assigned to it.
`MutableLiveData(T value)` Creates a MutableLiveData initialized with the given `value`.

Public methods
`@Override void`	`postValue(T value)` Posts a task to a main thread to set the given value.
`@Override void`	`setValue(T value)` Sets the value.

From class LiveData

`@Nullable T`	`getValue()` Returns the current value.
`boolean`	`hasActiveObservers()` Returns true if this LiveData has active observers.
`boolean`	`hasObservers()` Returns true if this LiveData has observers.
`@MainThread void`	`observe(@NonNull LifecycleOwner owner, @NonNull Observer<Object> observer)` Adds the given observer to the observers list within the lifespan of the given owner.
`@MainThread void`	`observeForever(@NonNull Observer<Object> observer)` Adds the given observer to the observers list.
`void`	`onActive()` Called when the number of active observers change from 0 to 1.
`void`	`onInactive()` Called when the number of active observers change from 1 to 0.
`@MainThread void`	`removeObserver(@NonNull Observer<Object> observer)` Removes the given observer from the observers list.
`@MainThread void`	`removeObservers(@NonNull LifecycleOwner owner)` Removes all observers that are tied to the given `LifecycleOwner`.

public MutableLiveData()

Creates a MutableLiveData with no value assigned to it.

public MutableLiveData(T value)

Creates a MutableLiveData initialized with the given value.

Parameters
`T value`	initial value

@Override
public void postValue(T value)

Posts a task to a main thread to set the given value. So if you have a following code executed in the main thread:

liveData.postValue("a");
liveData.setValue("b");

The value "b" would be set at first and later the main thread would override it with the value "a".

If you called this method multiple times before a main thread executed a posted task, only the last value would be dispatched.

Parameters
`T value`	The new value

@Override
public void setValue(T value)

Sets the value. If there are active observers, the value will be dispatched to them.

This method must be called from the main thread. If you need set a value from a background thread, you can use postValue

Parameters
`T value`	The new value