谷歌官方Android應用架構庫――LiveData
LiveData 是一個數據持有者類,它持有一個值并允許觀察該值。不同于普通的可觀察者,LiveData 遵守應用程序組件的生命周期,以便 Observer 可以指定一個其應該遵守的 Lifecycle。
如果 Observer 的 Lifecycle 處于 STARTED 或 RESUMED 狀態,LiveData 會認為 Observer 處于活動狀態。
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);
}
}
Location 監聽的實現有 3 個重要部分:
- onActive():當 LiveData 有一個處于活動狀態的觀察者時該方法被調用,這意味著需要開始從設備觀察位置更新。
- vonInactive():當 LiveData 沒有任何處于活動狀態的觀察者時該方法被調用。由于沒有觀察者在監聽,所以沒有理由保持與 LocationManager 的連接。這是非常重要的,因為保持連接會顯著消耗電量并且沒有任何好處。
- 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 作為第一個參數傳遞。這樣做表示該觀察者應該綁定到 Lifecycle,意思是:
- 如果 Lifecycle 不處于活動狀態(STARTED 或 RESUMED),即使該值發生變化也不會調用觀察者。
- 如果 Lifecycle 被銷毀,那么自動移除觀察者。
LiveData 是生命周期感知的事實給我們提供了一個新的可能:可以在多個 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);
}
}
現在 fragment 可以像下面這樣使用它:
public class MyFragment extends LifecycleFragment {
public void onActivityCreated (Bundle savedInstanceState) {
Util.checkUserStatus(result -> {
if (result) {
LocationLiveData.get(getActivity()).observe(this, location -> {
// update UI
});
}
});
}
}
可能會有多個 fragment 和 activity 在觀察 MyLocationListener 實例,LiveData 可以規范的管理它們,以便只有當它們中的任何一個可見(即處于活動狀態)時才連接到系統服務。
LiveData 有以下優點:
- 沒有內存泄漏:因為 Observer 被綁定到它們自己的 Lifecycle 對象上,所以,當它們的 Lifecycle 被銷毀時,它們能自動的被清理。
- 不會因為 activity 停止而崩潰:如果 Observer 的 Lifecycle 處于閑置狀態(例如:activity 在后臺時),它們不會收到變更事件。
- 始終保持數據最新:如果 Lifecycle 重新啟動(例如:activity 從后臺返回到啟動狀態)將會收到最新的位置數據(除非還沒有)。
- 正確處理配置更改:如果 activity 或 fragment 由于配置更改(如:設備旋轉)重新創建,將會立即收到最新的有效位置數據。
- 資源共享:可以只保留一個 MyLocationListener 實例,只連接系統服務一次,并且能夠正確的支持應用程序中的所有觀察者。
- 不再手動管理生命周期:fragment 只是在需要的時候觀察數據,不用擔心被停止或者在停止之后啟動觀察。由于 fragment 在觀察數據時提供了其 Lifecycle,所以 LiveData 會自動管理這一切。
LiveData 的轉換
有時候可能會需要在將 LiveData 發送到觀察者之前改變它的值,或者需要更具另一個 LiveData 返回一個不同的 LiveData 實例。
Lifecycle 包提供了一個 Transformations 類包含對這些操作的幫助方法。
,%20android.arch.core.util.Function
LiveData<User> userLiveData = ...;
LiveData<String> userName = Transformations.map(userLiveData, user -> {
user.name + " " + user.lastName
});
,%20android.arch.core.util.Function
private LiveData<User> getUser(String id) {
...;
}
LiveData<String> userId = ...;
LiveData<User> user = Transformations.switchMap(userId, id -> getUser(id) );
使用這些轉換允許在整個調用鏈中攜帶觀察者的 Lifecycle 信息,以便只有在觀察者觀察到 LiveData 的返回時才運算這些轉換。轉換的這種惰性運算性質允許隱式的傳遞生命周期相關行為,而不必添加顯式的調用或依賴。
每當你認為在 ViewModel 中需要一個 Lifecycle 類時,轉換可能是解決方案。
例如:假設有一個 UI,用戶輸入一個地址然后會收到該地址的郵政編碼。該 UI 簡單的 ViewModel 可能像這樣:
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 需要先從之前的 LiveData 注銷并且在每次調用 getPostalCode() 時重新注冊到新的實例。此外,如果 UI 被重新創建,它將會觸發新的 repository.getPostCode() 調用,而不是使用之前的調用結果。
不能使用那種方式,而應該實現將地址輸入轉換為郵政編碼信息。
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,因為它永遠不會改變。postalCode 被定義為 addressInput 的轉換,所以當 addressInput 改變時,如果有處于活動狀態的觀察者,repository.getPostCode() 將會被調用。如果在調用時沒有處于活動狀態的觀察者,在添加觀察者之前不會進行任何運算。
該機制允許以較少的資源根據需要惰性運算來創建 LiveData。ViewModel 可以輕松獲取到 LiveData 并在它們上面定義轉換規則。
創建新的轉換
在應用程序中可能會用到十幾種不同的特定轉換,但是默認是不提供的。可以使用 MediatorLiveData 實現自己的轉換,MediatorLiveData 是為了用來正確的監聽其它 LiveData 實例并處理它們發出的事件而特別創建的。MediatorLiveData 需要特別注意正確的向源 LiveData 傳遞其處于活動/閑置狀態。有關詳細信息,請參閱 Transformations 類。
來自:http://mobile.51cto.com/android-545063.htm