Android应用结构之LiveData

  LiveData是一个可被观察的数据持有者类。与常规的Observable不同，LiveData能意识到应用程序组件的生命周期变化，这意味着它能遵守Activity、Fragment、Service等组件的生命周期。这种意识确保LiveData只更新处于活跃状态的应用程序组件Observer。

Note: 如何在Android项目中引入LiveData组件， 请参阅 添加项目组件。

  如果一个Observer的生命周期处于STARTED或RESUMED状态，那么LiveData将认为这个Observer处于活跃状态。 LiveData仅通知活跃的Observer去更新UI。 非活跃状态的Observer，即使订阅了LiveData，也不会收到更新的通知。

  结合一个实现了LifecycleOwner接口的对象，你能注册一个Observer。这种结合关系使得当具有生命周期的对象的状态变为DESTROYED时，Observer将被取消订阅。 这对于Activity和Fragment尤其有用，因为它们可以安全地订阅LiveData对象，而不必担心内存泄漏 - 当Activity和Fragment生命周期为DESTROYED时，它们立即会被取消订阅。

  有关如何使用LiveData的更多信息，请参阅 使用LiveData对象。

LiveData的优点

在项目中使用LiveData，会有以下优点:

  • 确保UI符合数据状态
    LiveData遵循观察者模式。 当生命周期状态改变时，LiveData会向Observer发出通知。 您可以把更新UI的代码合并在这些Observer对象中。不必去考虑导致数据变化的各个时机，每次数据有变化，Observer都会去更新UI。
  • 没有内存泄漏
    Observer会绑定具有生命周期的对象，并在这个绑定的对象被销毁后自行清理。
  • 不会因停止Activity而发生崩溃
    如果Observer的生命周期处于非活跃状态，例如在后退堆栈中的Activity，就不会收到任何LiveData事件的通知。
  • 不需要手动处理生命周期
    UI组件只需要去观察相关数据，不需要手动去停止或恢复观察。LiveData会进行自动管理这些事情，因为在观察时，它会感知到相应组件的生命周期变化。
  • 始终保持最新的数据
    如果一个对象的生命周期变到非活跃状态，它将在再次变为活跃状态时接收最新的数据。 例如，后台Activity在返回到前台后立即收到最新数据。
  • 正确应对配置更改
    如果一个Activity或Fragment由于配置更改（如设备旋转）而重新创建，它会立即收到最新的可用数据。
  • 共享资源
    您可以使用单例模式扩展LiveData对象并包装成系统服务，以便在应用程序中进行共享。LiveData对象一旦连接到系统服务，任何需要该资源的Observer都只需观察这个LiveData对象。 有关更多信息，请参阅扩展LiveData。

使用LiveData对象

按照以下步骤使用LiveData对象：

  1. 创建一个LiveData的实例来保存特定类型的数据。 这通常在ViewModel类中完成。
  2. 创建一个定义了onChanged()方法的Observer对象，当LiveData对象保存的数据发生变化时，onChanged()方法可以进行相应的处理。 您通常在UI控制器（如Activity或Fragment）中创建Observer对象。
  3. 使用observe()方法将Observer对象注册到LiveData对象。 observe()方法还需要一个LifecycleOwner对象作为参数。 Observer对象订阅了LiveData对象，便会在数据发生变化时发出通知。 您通常需要UI控制器（如Activity或Fragment）中注册Observer对象。

Note:您可以使用observeForever(Observer)方法注册一个没有关联LifecycleOwner对象的Observer。 在这种情况下，Observer被认为始终处于活动状态，因此当有数据变化时总是会被通知。 您可以调用removeObserver(Observer)方法移除这些Observer。

  当你更新LiveData对象中存储的数据时，所有注册了的Observer，只要所绑定的LifecycleOwner处于活动状态，就会被触发通知。
  LiveData允许UI控制器Observer订阅更新。 当LiveData对象所保存的数据发生变化时，UI会在响应中自动更新。

创建LiveData对象

  LiveData是一个包装器，可用于任何数据，包括实现Collections的对象，如List。一个 LiveData对象通常存储在ViewModel对象中，并通过getter方法访问，如以下示例所示：

public class NameViewModel extends ViewModel {

    // Create a LiveData with a String
    private MutableLiveData<String> mCurrentName;

    public MutableLiveData<String> getCurrentName() {
        if (mCurrentName == null) {
            mCurrentName = new MutableLiveData<String>();
        }
        return mCurrentName;
    }

// Rest of the ViewModel...
}

起初，LiveData对象中的数据未设置。

Note:确保在ViewModel而不是Activity或Fragment中保存用来更新UI的LiveData对象，原因如下：

  • 避免臃肿的Activity和Fragment。 这些UI控制器负责显示数据而不是保存数据状态。
  • 将LiveData实例与特定Activity或Fragment实例分离，这将使得LiveData对象在配置更改后仍然存活。

有关ViewModel更多的用处和益处，请参阅Android应用结构之ViewModel。

观察LiveData对象

  在大多数情况下，出于以下原因，应用程序组件的onCreate()方法是开始观察LiveData对象的最佳位置：

  1. 确保系统不会从Activity或Fragment的onResume()方法中进行多余的调用。
  2. 确保Activity或Fragment一旦变为活动状态时，就有可展示的数据。 当应用程序组件处于STARTED状态，它就需从它所观察的LiveData对象中接收到最新的值。 所以我们需要在一开始就设置好观察。

  通常情况下，LiveData只在数据有变化时，给活跃的Observer进行通知。 此行为的一个例外是，Observer在从非活跃状态变为活跃状态时也会收到通知。 并且，如果Observer第二次从非活跃状态变为活跃状态，则只有在自上一次变为活跃状态以来该数据发生变化时才会接收到更新。

以下示例代码演示了如何开始观察LiveData对象：

public class NameActivity extends AppCompatActivity {

    private NameViewModel mModel;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        // Other code to setup the activity...

        // Get the ViewModel.
        mModel = ViewModelProviders.of(this).get(NameViewModel.class);

        // Create the observer which updates the UI.
        final Observer<String> nameObserver = new Observer<String>() {
            @Override
            public void onChanged(@Nullable final String newName) {
                // Update the UI, in this case, a TextView.
                mNameTextView.setText(newName);
            }
        };

        // Observe the LiveData, passing in this activity as the LifecycleOwner and the observer.
        mModel.getCurrentName().observe(this, nameObserver);
    }
}

  传递nameObserver作为参数,调用observe()之后，将立即回调onChanged()，提供存储在mCurrentName中的最新值。 如果LiveData对象mCurrentName的值并未设置，则不调用onChanged()。

更新LiveData对象

  LiveData没有公用的方法来更新存储的数据。 MutableLiveData类暴露公用的setValue(T)和postValue(T)方法，如果需要编辑存储在LiveData对象中的值，必须使用这两个方法。 通常在ViewModel中使用MutableLiveData，然后ViewModel仅向Observer公开不可变的LiveData对象。

  在建立观察者关系之后，可以更新LiveData对象的值，如以下示例所示，当用户点击按钮时向所有观察者发出通知：

mButton.setOnClickListener(new OnClickListener() {
    @Override
    public void onClick(View v) {
        String anotherName = "John Doe";
        mModel.getCurrentName().setValue(anotherName);
    }
});

  在示例中调用setValue(T)会导致Observer使用值"John Doe"调用onChanged()方法。 这个例子展示了点击按钮，setValue()或者postValue()被调用来更新mName，原因有多种，包括响应网络请求或数据库加载完成; 在所有情况下，调用setValue()或postValue()都会触发观察者并更新UI。

Note: 必须要从主线程调用setValue(T) 方法来更新LiveData 对象. 如果代码在工作线程中执行, 你可以使用postValue(T) 方法来更新LiveData对象.

LiveData配合Room使用

  Room持久性库支持Observable查询返回LiveData对象。 Observable查询成为数据库访问对象（DAO）的一项功能。
  当更新数据库时，会生成所有必要的代码来更新LiveData对象。 生成的代码在需要时在后台线程上异步运行查询。 这种模式对于保持用户界面中显示的数据与存储在数据库中的数据同步很有用。 您可以在Room持久性库指南中阅读关于Room和DAO的更多信息。

扩展LiveData

  如果Observer的生命周期处于STARTED或RESUMED状态，则LiveData将认为Observer处于活动状态。以下示例代码说明了如何扩展LiveData类：

public class StockLiveData extends LiveData<BigDecimal> {
    private StockManager mStockManager;

    private SimplePriceListener mListener = new SimplePriceListener() {
        @Override
        public void onPriceChanged(BigDecimal price) {
            setValue(price);
        }
    };

    public StockLiveData(String symbol) {
        mStockManager = new StockManager(symbol);
    }

    @Override
    protected void onActive() {
        mStockManager.requestPriceUpdates(mListener);
    }

    @Override
    protected void onInactive() {
        mStockManager.removeUpdates(mListener);
    }
}

本例中StockLiveData的实现包括以下重要的方法：

  • 当LiveData对象有一个活跃的Observer时，onActive()方法被调用。 这意味着你需要从这个方法开始观察股票价格的更新。
  • 当LiveData对象没有任何活跃的Observer时，onInactive()方法被调用。 由于没有Observer在监听，所以没有理由继续保持与StockManager服务的连接。
  • setValue(T)方法更新LiveData实例的值，并通知活动观察者有关更改。
    您可以这样使用StockLiveData类，如下所示：
public class MyFragment extends Fragment {
    @Override
    public void onActivityCreated(Bundle savedInstanceState) {
        super.onActivityCreated(savedInstanceState);
        LiveData<BigDecimal> myPriceListener = ...;
        myPriceListener.observe(this, price -> {
            // Update the UI.
        });
    }
}

  observe()方法第一个参数是作为LifecycleOwner实例的Fragment。 这样做表示此Observer绑定了Lifecycle对象的生命周期，即：

  • 如果Lifecycle对象不处于活动状态，则即使值发生更改，也不会调用Observer。
  • Lifecycle对象被销毁后，Observer被自动删除。
    LiveData对象具有感知生命周期的能力意味着您可以在多个Activity，Fragment和service之间共享它们。 为了保持简洁，你可以使用单例模式实现LiveData，如下所示：
public class StockLiveData extends LiveData<BigDecimal> {
    private static StockLiveData sInstance;
    private StockManager mStockManager;

    private SimplePriceListener mListener = new SimplePriceListener() {
        @Override
        public void onPriceChanged(BigDecimal price) {
            setValue(price);
        }
    };

    @MainThread
    public static StockLiveData get(String symbol) {
        if (sInstance == null) {
            sInstance = new StockLiveData(symbol);
        }
        return sInstance;
    }

    private StockLiveData(String symbol) {
        mStockManager = new StockManager(symbol);
    }

    @Override
    protected void onActive() {
        mStockManager.requestPriceUpdates(mListener);
    }

    @Override
    protected void onInactive() {
        mStockManager.removeUpdates(mListener);
    }
}

你可以在Fragment中使用它，如下所示：

public class MyFragment extends Fragment {
    @Override
    public void onActivityCreated(Bundle savedInstanceState) {
        StockLiveData.get(getActivity()).observe(this, price -> {
            // Update the UI.
        });
    }
}

  多个Activity和Fragment可以观察到MyPriceListener实例。 LiveData只在他们至少一个处于可见和活跃状态时才连接到系统服务。

转换LiveData

  您可能希望先转换存储在LiveData对象中的值，然后再将其分派给Observer，或者您可能需要根据一个LiveData实例的值返回不同的LiveData实例。Lifecycle包提供了 Transformations类，提供了支持这些使用场景的方法。

Transformations.map()
  使用一个函数来转换存储在LiveData对象中的值，并向下传递转换后的值。

LiveData<User> userLiveData = ...;
LiveData<String> userName = Transformations.map(userLiveData, user -> {
    user.name + " " + user.lastName
});

Transformations.switchMap()
  与map()类似，使用一个函数来转换存储在LiveData对象中的值，并向下传递结果。 传递给switchMap()的函数必须返回一个LiveData对象，如下例所示：

private LiveData<User> getUser(String id) {
  ...;
}

LiveData<String> userId = ...;
LiveData<User> user = Transformations.switchMap(userId, id -> getUser(id) );

  您可以使用转换方法在Observer的生命周期中传递信息。 除非Observer正在观看返回的LiveData对象，否则不会计算转换。 由于转换是延迟计算的，所以与生命周期相关的行为隐式传递，而不需要额外的显式调用或依赖关系。
  如果您认为在ViewModel对象中需要Lifecycle对象，则转换可能是更好的解决方案。 例如，假设您有一个接受地址并返回该地址的邮政编码的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字段是公开的和最终的，因为该字段永远不会改变。 postalCode字段定义为addressInput的转换，这意味着addressInput发生更改时,如果有一个活跃的Observer,将调用repository.getPostCode()方法,如果在repository.getPostCode()被调用时没有活跃的Observer，直到添加一个观察者才会进行计算。
  此机制允许较低级别的应用程序创建按需延迟计算的LiveData对象。 ViewModel对象可以很容易地获得对LiveData对象的引用，然后在其上定义转换规则。

创建新的Transformations

  我们有十几个不同的具体Transformations，它们可能在你的应用程序中很有用，但是它们并不是默认提供的。 要实现自己的转换，您可以使用MediatorLiveData类，该类监听其他LiveData对象并处理它们发出的事件。 MediatorLiveData将其状态正确地传播到源LiveData对象。 要了解有关此模式的更多信息，请参阅Transformations的参考文档。

合并多个LiveData源

  MediatorLiveData是LiveData的一个子类，帮助您合并多个LiveData源。 在任何原始LiveData源对象改变后，MediatorLiveData对象的Observer会被触发。
  例如，如果在UI中有一个从本地数据库或网络获取更新的LiveData对象，则可以将以下数据源添加到MediatorLiveData对象：

  • 与存储在数据库中的数据关联的LiveData对象。
  • 与从网络访问的数据关联的LiveData对象。
    您的Activity只需观察MediatorLiveData对象即可接收来自两个数据源的更新。 有关详细示例，请参阅应用程序体系结构指南的附录：Guide to App Architecture。
最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 206,013评论 6赞 481
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 88,205评论 2赞 382
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 152,370评论 0赞 342
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 55,168评论 1赞 278
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 64,153评论 5赞 371
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,954评论 1赞 283
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 38,271评论 3赞 399
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,916评论 0赞 259
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 43,382评论 1赞 300
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,877评论 2赞 323
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,989评论 1赞 333
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,624评论 4赞 322
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,209评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,199评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,418评论 1赞 260
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 45,401评论 2赞 352
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,700评论 2赞 345