com.kunminx.architecture.ui.callback

类 ProtectedUnPeekLiveDataV3<T>

java.lang.Object

androidx.lifecycle.LiveData<T>

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

直接已知子类:

UnPeekLiveDataV3

已过时。

@Deprecated
public class ProtectedUnPeekLiveDataV3<T>
extends androidx.lifecycle.LiveData<T>

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 19/9/23

字段概要

字段

限定符和类型	字段和说明
protected int	DELAY_TO_CLEAR_EVENT 已过时。
protected boolean	isAllowNullValue 已过时。
protected boolean	isAllowToClear 已过时。

构造器概要

构造器

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

方法概要

限定符和类型	方法和说明
void	observe(androidx.lifecycle.LifecycleOwner owner, androidx.lifecycle.Observer<? super T> observer) 已过时。
void	observeForever(androidx.lifecycle.Observer<? super T> observer) 已过时。 UnPeekLiveData 主要用于表现层的 页面转场 和 页面间通信 场景下的非粘性消息分发， 出于生命周期安全等因素的考虑，不建议使用 observeForever 方法， 对于数据层的工作，如有需要，可结合实际场景使用 MutableLiveData 或 kotlin flow。
protected 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

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

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

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

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

字段详细资料

DELAY_TO_CLEAR_EVENT

protected int DELAY_TO_CLEAR_EVENT

已过时。

isAllowNullValue

protected boolean isAllowNullValue

已过时。

isAllowToClear

protected boolean isAllowToClear

已过时。

构造器详细资料

ProtectedUnPeekLiveDataV3

public ProtectedUnPeekLiveDataV3()

已过时。

方法详细资料

observe

public void observe(@NonNull
                    androidx.lifecycle.LifecycleOwner owner,
                    @NonNull
                    androidx.lifecycle.Observer<? super T> observer)

已过时。

覆盖:

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

observeForever

public void observeForever(@NonNull
                           androidx.lifecycle.Observer<? super T> observer)

已过时。

UnPeekLiveData 主要用于表现层的 页面转场 和 页面间通信 场景下的非粘性消息分发， 出于生命周期安全等因素的考虑，不建议使用 observeForever 方法，

对于数据层的工作，如有需要，可结合实际场景使用 MutableLiveData 或 kotlin flow。

覆盖:

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

参数:

observer -

setValue

protected 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

覆盖:

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

参数:

value -