谷歌官方Android應用架構庫——LiveData

架構庫版本：1.0.0 Alpha 2 – June 2, 2017

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 類。