LiveData
LiveData
是一個用于持有數據并支持數據可被監聽(觀察)。和傳統的觀察者模式中的被觀察者不一樣,LiveData是一個生命周期感知
組件,因此觀察者可以指定某一個LifeCycle
給LiveData,并對數據進行監聽。
如果觀察者指定LifeCycle
處于Started
或者RESUMED
狀態,LiveData會將觀察者視為活動狀態,并通知其數據的變化。
我們看一段代碼:
public class LocationLiveData extends LiveData<Location> {
private LocationManager locationManager;
private SimpleLocationListener listener = new SimpleLocationListener() {
@Override
public void onLocationChanged(Location location) {
setValue(location);
}
};
public LocationLiveData(Context context) {
locationManager = (LocationManager) context.getSystemService(
Context.LOCATION_SERVICE);
}
@Override
protected void onActive() {
locationManager.requestLocationUpdates(LocationManager.GPS_PROVIDER, 0, 0, listener);
}
@Override
protected void onInactive() {
locationManager.removeUpdates(listener);
}
}
上面有三個值得注意的地方:
- onActive()
當這個方法被調用時,表示LiveData的觀察者數量從0變為了1,這時就我們的位置監聽來說,就應該注冊我們的時間監聽了。
- onInactive()
這個方法被調用時,表示LiveData的觀察者數量變為了0,既然沒有了觀察者,也就沒有理由再做監聽,此時我們就應該將位置監聽移除。
- setValue()
通過調用這個方法來更新LiveData的數據,并通知處于活動狀態的觀察者。
接著我們就能像下面這樣使用LocationLiveData了。
public class MyFragment extends LifecycleFragment {
public void onActivityCreated (Bundle savedInstanceState) {
LiveData<Location> myLocationListener = ...;
Util.checkUserStatus(result -> {
if (result) {
myLocationListener.addObserver(this, location -> {
// update UI
});
}
});
}
}
注意上面的addObserver
方法,我們將LifeCycleOwner
作為第一個參數傳遞了進去,這表示我們的LocationLiveData將遵照這個Fragment所持有的LifeCycle辦事。
- 如果LifeCycle不在Started或者RESUMED這兩個狀態,那么觀察者將無法接受到數據更新的回調,即使數據發生了變化。
- 如果LifeCycle銷毀了,即生命周期結束,觀察者將被自動從LiveData中移除。
既然LocationLiveData是生命周期感知的,那么我們就可以稍微改動一下它的代碼,讓它可以被多個Activity或者Fragment公用:
public class LocationLiveData extends LiveData<Location> {
private static LocationLiveData sInstance;
private LocationManager locationManager;
@MainThread
public static LocationLiveData get(Context context) {
if (sInstance == null) {
sInstance = new LocationLiveData(context.getApplicationContext());
}
return sInstance;
}
private SimpleLocationListener listener = new SimpleLocationListener() {
@Override
public void onLocationChanged(Location location) {
setValue(location);
}
};
private LocationLiveData(Context context) {
locationManager = (LocationManager) context.getSystemService(
Context.LOCATION_SERVICE);
}
@Override
protected void onActive() {
locationManager.requestLocationUpdates(LocationManager.GPS_PROVIDER, 0, 0, listener);
}
@Override
protected void onInactive() {
locationManager.removeUpdates(listener);
}
}
這里使用單例的原因就是讓多個Activity或者Fragment共享一個LocationLiveData實例。
然后我們可以這么使用:
public class MyFragment extends LifecycleFragment {
public void onActivityCreated (Bundle savedInstanceState) {
Util.checkUserStatus(result -> {
if (result) {
MyLocationListener.get(getActivity()).addObserver(this, location -> {
// update UI
});
}
});
}
}
通過這么一改,現在即使有多個Activity或者Fragment在使用LocationLiveData,它也能對其進行優雅的管理。不必理會頁面銷毀帶來的諸多麻煩。
總結幾點LiveData的有點:
- 沒有內存溢出
當觀察者被綁定他們對應的LifeCycle以后,當頁面銷毀時他們會自動被溢出,不會導致內存溢出。
- 不會因為Activity的不可見導致Crash
當Activity不可見時,即使有數據變化,LiveData也不會通知觀察者。因為此時觀察者的LifeCyele并不處于Started或者RESUMED狀態。
- 配置的改變
當當前Activity配置改變(如屏幕方向),導致重新從onCreate走一遍,這是觀察者們會立刻收到配置變化前的最新數據。
- 資源共享
我們只需要一個LocationLivaData,連接系統服務一次,就能支持所有的觀察者。
- 不再有人為生命周期處理
通過上面的代碼可以知道,我們的Activity或者Fragment只要在需要觀察數據的時候觀察數據即可,不需要理會生命周期變化了。這一切都交給LiveData來自動管理。
LiveData的轉換
有時候有這樣的需求,需要在LiveData將變化的數據通知給觀察者前,改變數據的類型;或者是返回一個不一樣的LiveData。
這里介紹一個類Transformations
,它可以幫助完成上面的這些操作。
- Transformations.map()
在LiveData數據的改變傳遞到觀察者之前,在數據上應用一個方法:
LiveData<User> userLiveData = ...;
LiveData<String> userName = Transformations.map(userLiveData, user -> {
user.name + " " + user.lastName
});
這里我們如果只需要知道變化用戶的名字,那么只要觀察userName這個LiveData對象即可。它會從userLiveData數據中提取用戶名并傳遞給它自己的觀察者。
- Transformations.switchMap()
與Transformations.map()類似,只不過這里傳遞個switchMap()的方法必須返回一個LiveData對象。
private LiveData<User> getUser(String id) {
...;
}
LiveData<String> userId = ...;
LiveData<User> user = Transformations.switchMap(userId, id -> getUser(id) );
當你考慮在ViewModel中使用LifeCycle對象時,這種轉換就是一個可選的解決方案。
假如有一下需求,用戶輸入一個地址,我們在屏幕上更新這個地址對應的郵編,簡單的寫法如下:
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);
}
}
這樣寫問題顯然很嚴重,當每次調用getPostalCode方法后,UI代碼中都需要對getPostalCode的返回值做注冊觀察者操作,并且還要移除上一個觀察者,這樣顯然是低效率的。此外,如果這時UI因為配置的變化(屏幕旋轉)重建了,那么它會觸發再次調用getPostalCode,而不是使用之前的調用結果。
因此我們可以做如下轉換:
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訪問限制符寫成public final,因為它將始終不變,UI只要在需要用的時候將觀察者注冊到postalCode中就行。這是當用戶調用setInput后,如果postalCode上有可活動的觀察者,那么repository.getPostCode(address)就會被調用,如果此時沒有可活動的觀察者,則repository.getPostCode(address)不會被調用。
自定義轉換
在你的應用中可能需要除了上面兩種以外更多的LiveData的轉換,為了實現這些轉換,你可以使用MediatorLiveData
類,它可以用來正確的處理其他多個LiveData的事件變化,并處理這些事件。MediatorLiveData會將自身的active/inactive
狀態變化正確的傳遞給它所處理的LiveData,例如MediatorLiveData沒有觀察者的話,