Android架构组件官方文档02——LiveData
LiveData概述
LiveData是一个可观察的数据持有者类。
与常规可观察性不一样，LiveData具备生命周期感知能力，这意味着它尊重其余应用程序组件（例如活动，片断或服务）的生命周期。
这种感知确保LiveData只更新处于活动生命周期状态的应用程序组件观察者。
注意：要将LiveData组件导入到Android项目中，请参阅向项目添加组件。
若是观察者的生命周期处于STARTED或RESUMED状态，则LiveData会将Observer类表示的观察者视为活动状态。
LiveData仅通知处于活跃状态的观察者更新。
未注册观看LiveData对象的非活跃期的观察者不会收到有关更改的通知。html
您能够注册与实现LifecycleOwner接口的对象配对的观察者。此关系容许在相应生命周期对象的状态更改成DESTROYED时删除观察者。
这对于活动和片断尤为有用，由于它们能够安全地观察LiveData对象，而没必要担忧泄漏 - 在其生命周期被破坏时，活动和片断会当即取消订阅。android
有关如何使用LiveData的更多信息，请参阅使用LiveData对象数据库
使用LiveData的优势
使用LiveData提供如下优势：
确保您的UI界面符合您UI数据状态安全
LiveData遵循观察者模式。
当生命周期状态改变时，LiveData会通知Observer对象。
您能够合并代码以更新这些Observer对象中的UI。
每次应用程序数据更改时，您的观察者均可以在每次更改时更新UI，而不是每次更新UI。
没有内存泄漏
观察者绑定到 Lifecycle对象，并在其相关生命周期被破坏后自行清理。
不会由于活动中止而崩溃网络
若是观察者的生命周期处于非活动状态，例如在后退堆栈中的活动，则它不会收到任何LiveData事件。
没有更多的手动声明周期处理
UI组件只是观察相关数据，不中止或恢复观察。
LiveData自动管理全部这些，由于它在观察时意识到相关的生命周期状态更改。
始终保持最新的数据
若是生命周期变为非活动状态，它将在再次变为活动状态时收到最新数据。例如，后台活动在返回到前台后当即收到最新数据。
正确的配置更改
若是因为配置更改（如设备旋转）而从新建立活动或片断，它会当即收到最新的可用数据。
共享资源
您可使用单例模式扩展LiveData对象以包装系统服务，以便它们能够在应用程序中共享。
LiveData对象链接到系统服务一次，而后任何须要该资源的观察者均可以观看LiveData对象。
有关更多信息，请参阅扩展LiveData。异步
使用LiveData对象
按照如下步骤操做LiveData对象：ide
- 建立一个LiveData实例来保存某种类型的数据。这一般在您的ViewModel类中完成。
- 建立一个Observer对象，该对象定义onChanged()方法，该方法控制LiveData对象保存的数据更改时发生的状况。您一般在UI控制器中建立Observer对象，如活动或片断。
- 使用observe()方法将Observer对象附加到LiveData对象。observe()方法使用LifecycleOwner对象。这将Observer对象订阅到LiveData对象，以便通知其更改。您一般将Observer对象附加到UI控制器中，例如Activity或Fragment。
注意：您可使用observeForever（Observer）方法注册一个没有关联的LifecycleOwner对象的观察器。在这种状况下，观察者被认为始终处于活动状态，所以老是通知修改。您能够删除这些观察者调用removeObserver（Observer）方法。
当您更新存储在LiveData对象中的值时，只要附加的LifecycleOwner处于活动状态，它就会触发全部已注册的观察者。
LiveData容许UI控制器观察者订阅更新。当LiveData对象持有的数据更改时，UI会自动更新以做为响应。函数
建立LiveData对象
LiveData是一个可用于任何数据的包装器，包括实现集合的对象（如List）。LiveData对象一般存储在ViewModel对象中，并经过getter方法访问，如如下示例所示：post
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对象中的数据未设置。ui
注意：因为如下缘由，请确保存储更新 ViewModel对象中的UI的 LiveData对象，而不是活动或片断：
- 避免臃肿的活动和碎片。如今这些UI控制器负责显示数据但不保存数据状态。
- 将LiveData实例与特定活动或片断实例分离，并容许LiveData对象保留配置更改。
您能够在ViewModel指南中了解更多关于ViewModel类的好处和用法。
观察LiveData对象
在大多数状况下，出于如下缘由，应用程序组件的onCreate()方法是开始观察LiveData对象的正确位置：
- 确保系统不会从Activity或fragment的onResume（）方法进行多余的调用。
- 确保Activity或Fragment具备一旦它变为活动状态便可显示的数据。只要应用程序组件处于STARTED状态，它就会从它所观察的LiveData对象中接收最新的值。这只会在设置要观察的LiveData对象时才会发生。
一般，LiveData仅在数据更改时传递更新，而且仅传递给活动观察者。此行为的一个例外是，观察者在从非活动状态变为活动状态时也会收到更新。此外，若是观察者第二次从非激活状态变为激活状态，则只有在自上一次变为活动状态以来该值发生变化时才会收到更新。
如下示例代码说明了如何开始观察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只向观察者公开不可变的LiveData对象。
在创建观察者关系后，能够更新LiveData对象的值，如如下示例所示，当用户点击按钮时触发全部观察者：
mButton.setOnClickListener(new OnClickListener() {
@Override
public void onClick(View v) {
String anotherName = "John Doe";
mModel.getCurrentName().setValue(anotherName);
}
});
在示例中调用setValue（T）会致使观察者用值John Doe调用它们的onChanged（）方法。该示例显示按钮按下，但setValue（）或postValue（）可能因多种缘由被调用来更新mName，包括响应网络请求或数据库加载完成;在全部状况下，调用setValue（）或postValue（）都会触发观察者并更新UI。
注意：您必须调用setValue（T）方法来更新主线程中的LiveData对象。若是代码在工做线程中执行，则可使用postValue（T）方法更新LiveData对象。
与Room一块儿使用LiveData
Room持久性库支持返回LiveData对象的可观察查询。可观察查询是做为数据库访问对象（DAO）的一部分写入的。
当更新数据库时，会生成全部必要的代码以更新LiveData对象。生成的代码在须要时在后台线程上异步运行查询。这种模式对于保持UI中显示的数据与存储在数据库中的数据保持同步颇有用。您能够在Room持久库指南中阅读关于Room和DAO的更多信息。
扩展LiveData
若是观察者的生命周期处于STARTED或RESUMED状态，则LiveData将认为观察者处于活动状态。如下示例代码说明了如何扩展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);
}
}
本示例中的价格监听器的实现包括如下重要方法：
- 当LiveData对象具备处于活跃期的观察者时，将调用onActive（）方法。这意味着您须要开始观察此方法的价格更新。
- 当LiveData对象没有任何active期间的观察者时，将调用onInactive（）方法。因为没有观察员在监听，所以没有理由保持链接到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做为第一个参数传递。这样作表示此观察者被绑定到与全部者关联的生命周期对象，这意味着：
- 若是生命周期对象不处于活跃状态，则即便值发生更改，也不会调用观察者。
- 生命周期对象被销毁后，观察者被自动删除。t
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.
});
}
}
多个Fragment和Activity能够观察MyPriceListener实例。若是LiveData只有一个或多个可见并处于活动状态，则LiveData仅链接到系统服务。
转换LiveData
您可能但愿在LiveData更改成观察者以前更改存储在LiveData对象中的，或者您可能须要基于另外一个LiveData实例的值返回不一样的LiveData实例。Lifecycle软件包提供Transformations类，其中包括支持这些场景的帮助方法。
Transformations.map()
在存储在LiveData对象中的值上使用函数，并向下游传播结果。
LiveData<User> userLiveData = ...;
LiveData<String> userName = Transformations.map(userLiveData, user -> {
user.name + " " + user.lastName
});
与map（）相似，将函数应用于存储在LiveData对象中的值，并展开并向下游分派结果。传递给switchMap（）的函数必须返回一个LiveData对象，以下例所示：
private LiveData<User> getUser(String id) {
...;
}
LiveData<String> userId = ...;
LiveData<User> user = Transformations.switchMap(userId, id -> getUser(id) );
您可使用转换方法在观察者的生命周期中传递信息。除非观察者正在观察返回的LiveData对象，不然不会计算转换。因为转换是懒加载的，所以与生命周期相关的行为会隐式传递，而不须要额外的显式调用或依赖关系。
若是您认为您须要ViewModel对象中的Lifecycle对象，则转换多是更好的解决方案。例如，假设您有一个接受地址并返回该地址的邮政编码的UI组件。您能够为此组件实现native的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);
}
}
在这种状况下，postalCode是public的和fina的，由于该字段永远不会改变。postalCode字段定义为addressInput的转换，这意味着addressInput发生更改时将调用repository.getPostCode（）方法。若是存在活动观察者，那么这是真实的，若是在repository.getPostCode（）被调用时没有活跃的观察者，则在添加观察者以前不进行计算。
该机制容许版本较低的应用程序建立按需延迟计算的LiveData对象。ViewModel对象能够轻松得到对LiveData对象的引用，而后在其上定义转换规则。
建立新的转换
有十几种不一样的特定转换可能在您的应用中颇有用，但它们不是默认提供的。要实现本身的转换，您可使用MediatorLiveData类，它监听其余LiveData对象并处理它们发出的事件。MediatorLiveData将其状态正确传播到源LiveData对象。要了解有关此模式的更多信息，请参阅Transformations类的参考文档。
合并多个LiveData源
MediatorLiveData是LiveData的一个子类，容许您合并多个LiveData源。MediatorLiveData对象的观察者随后会在任何原始LiveData源对象更改时触发。
例如，若是您的UI中有一个可从本地数据库或网络更新的LiveData对象，则能够将如下资源添加到MediatorLiveData对象：
- 与存储在数据库中的数据关联的LiveData对象。
- 与从网络访问的数据关联的LiveData对象。
您的活动只需观察MediatorLiveData对象便可从两个来源接收更新。有关详细示例，请参阅应用程序体系结构指南的附录：展现网络状态部分。
其余资源
- 1. Android 官方架构组件（二）——LiveData
- 2. Android架构组件之LiveData
- 3. Android官方架构组件ViewModel+LiveData+DataBinding架构属于本身的MVVM
- 4. Android架构组件官方文档03——ViewModel
- 5. Android 架构组件官方文档01——LifeCycle
- 6. Android官方文档—APP组件（Activities）（Fragments）
- 7. Android 官方架构组件（一）——Lifecycle
- 8. 改造 Android 官方架构组件 ViewModel
- 9. Android 官方架构组件（三）——ViewModel
- 10. Android 官方架构组件之 Lifecycle
- 更多相关文章...
- • WSDL 文档 - WSDL 教程
- • XSL-FO 文档 - XSL-FO 教程
- • SpringBoot中properties文件不能自动提示解决方法
- • Docker容器实战(七) - 容器眼光下的文件系统
-
每一个你不满意的现在，都有一个你没有努力的曾经。
- 1. js中 charCodeAt
- 2. Android中通过ViewHelper.setTranslationY实现View移动控制（NineOldAndroids开源项目）
- 3. 【Android】日常记录：BottomNavigationView自定义样式，修改点击后图片
- 4. maya 文件检查 ui和数据分离 （一）
- 5. eclipse 修改项目的jdk版本
- 6. Android InputMethod设置
- 7. Simulink中Bus Selector出现很多? ? ?
- 8. 【Openfire笔记】启动Mac版Openfire时提示“系统偏好设置错误”
- 9. AutoPLP在偏好标签中的生产与应用
- 10. 数据库关闭的四种方式
- 1. Android 官方架构组件（二）——LiveData
- 2. Android架构组件之LiveData
- 3. Android官方架构组件ViewModel+LiveData+DataBinding架构属于本身的MVVM
- 4. Android架构组件官方文档03——ViewModel
- 5. Android 架构组件官方文档01——LifeCycle
- 6. Android官方文档—APP组件（Activities）（Fragments）
- 7. Android 官方架构组件（一）——Lifecycle
- 8. 改造 Android 官方架构组件 ViewModel
- 9. Android 官方架构组件（三）——ViewModel
- 10. Android 官方架构组件之 Lifecycle