com.kunminx.architecture.ui.callback

类 UnPeekLiveDataV3<T>

java.lang.Object

androidx.lifecycle.LiveData<T>

com.kunminx.architecture.ui.callback.ProtectedUnPeekLiveDataV3<T>

com.kunminx.architecture.ui.callback.UnPeekLiveDataV3<T>

已过时。

@Deprecated
public class UnPeekLiveDataV3<T>
extends ProtectedUnPeekLiveDataV3<T>

TODO：Note 2020.10.15: 这是第 3 代 UnPeekLiveData 设计，目前最新版本为更少隐患的第 4 代。 TODO：UnPeekLiveData 的存在是为了在 "重回二级页面" 的场景下，解决 "数据倒灌" 的问题。 对 "数据倒灌" 的状况不理解的小伙伴，可参考《jetpack MVVM 精讲》的解析

https://juejin.im/post/5dafc49b6fb9a04e17209922

本类参考了官方 SingleEventLive 的非入侵设计，

TODO：并创新性地引入了 "延迟清空消息" 的设计， 如此可确保： 1.一条消息能被多个观察者消费 2.延迟期结束，不再能够收到旧消息的推送 3.并且旧消息在延迟期结束时能从内存中释放，避免内存溢出等问题 4.让非入侵设计成为可能，遵循开闭原则

TODO：增加一层 ProtectedUnPeekLiveData， 用于限制从 Activity/Fragment 篡改来自 "数据层" 的数据，数据层的数据务必通过唯一可信源来分发， 如果这样说还不理解，详见： https://xiaozhuanlan.com/topic/6719328450 和 https://xiaozhuanlan.com/topic/0168753249

Create by KunMinX at 2020/7/21

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	UnPeekLiveDataV3.Builder<T> 已过时。

字段概要

从类继承的字段 com.kunminx.architecture.ui.callback.ProtectedUnPeekLiveDataV3

DELAY_TO_CLEAR_EVENT, isAllowNullValue, isAllowToClear

构造器概要

构造器

构造器和说明
UnPeekLiveDataV3() 已过时。

方法概要

限定符和类型	方法和说明
void	postValue(T value) 已过时。
void	setValue(T value) 已过时。 重写的 setValue 方法，默认不接收 null 可通过 Builder 配置允许接收 可通过 Builder 配置消息延时清理的时间 override setValue, do not receive null by default You can configure to allow receiving through Builder And also, You can configure the delay time of message clearing through Builder

从类继承的方法 com.kunminx.architecture.ui.callback.ProtectedUnPeekLiveDataV3

observe, observeForever

从类继承的方法 androidx.lifecycle.LiveData

getValue, hasActiveObservers, hasObservers, onActive, onInactive, removeObserver, removeObservers

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

UnPeekLiveDataV3

public UnPeekLiveDataV3()

已过时。

方法详细资料

setValue

public void setValue(T value)

已过时。

从类复制的说明: ProtectedUnPeekLiveDataV3

重写的 setValue 方法，默认不接收 null 可通过 Builder 配置允许接收 可通过 Builder 配置消息延时清理的时间

override setValue, do not receive null by default You can configure to allow receiving through Builder And also, You can configure the delay time of message clearing through Builder

覆盖:

setValue 在类中 ProtectedUnPeekLiveDataV3<T>

postValue

public void postValue(T value)

已过时。

覆盖:

postValue 在类中 androidx.lifecycle.LiveData<T>