感谢大家和我一起,在Android世界打怪升级!
Jetpack系列的第一篇文章,以Lifecycle作为起点,其重要性不言而喻。本篇文章会从使用到原理依次进阶,由浅入深的剖析Lifecycle。
一、Jetpack是什么
安卓开发者官网对Jetpack的介绍:
Jetpack 是一个由多个库组成的套件,可帮助开发者遵循最佳做法、减少样板代码并编写可在各种 Android版本和设备中一致运行的代码,让开发者可将精力集中于真正重要的编码工作。
简单来说就是很多官方封装的提升开发效率的库。从官网摆放的位置足以看出对Jetpack的重视程度。
二、Lifecycle是什么
构建生命周期感知型组件,这些组件可以根据 Activity 或 Fragment 的当前生命周期状态调整行为。
简单叙述下原理:使用了观察者模式,Activity与Fragment拥有生命周期感知的能力,作为被观察者,可向其内部注册观察者,在生命周期变化时通知所有观察者。
三、Lifecycle的使用
使用分为两步:①创建观察者、②注册观察者。被观察者已经被Android源码实现了。
3.1 创建观察者
1、创建类实现LifecycleObserver接口。
2、在其内部创建方法(方法名随意),参数可填LifecycleOwner,也可不填。
3、给方法加注解 @OnLifecycleEvent(Lifecycle.Event.XXX) ,可以让该方法监听到注解生命周期的变化。
4、下面代码罗列了所有Lifecycle.Event枚举,Lifecycle.Event.ON_ANY 可以监听所有其他生命周期变化。
public class TestLifecycleObserver implements LifecycleObserver {
private static final String TAG = "TestLifecycleObserver";
@OnLifecycleEvent(Lifecycle.Event.ON_CREATE)
void onCreate(LifecycleOwner owner) {
Log.e(TAG, "========onCreate====" + owner);
}
@OnLifecycleEvent(Lifecycle.Event.ON_START)
void onStart() {
Log.e(TAG, "========onStart");
}
@OnLifecycleEvent(Lifecycle.Event.ON_RESUME)
void onResume(LifecycleOwner owner) {
Log.e(TAG, "========onResume");
}
@OnLifecycleEvent(Lifecycle.Event.ON_PAUSE)
void onPause(LifecycleOwner owner) {
Log.e(TAG, "========onPause");
}
@OnLifecycleEvent(Lifecycle.Event.ON_STOP)
void onStop(LifecycleOwner owner) {
Log.e(TAG, "========onStop");
}
@OnLifecycleEvent(Lifecycle.Event.ON_DESTROY)
void onDestroy(LifecycleOwner owner) {
Log.e(TAG, "========onDestroy");
}
@OnLifecycleEvent(Lifecycle.Event.ON_ANY)
void onAny(LifecycleOwner owner) {
Log.e(TAG, "========onAny");
}
}
3.2 注册观察者
AppCompatActivity与Fragment是默认的被观察者,在其内部通过调用getLifecycle().addObserver(观察者)注册定义好的观察者即可。
public class TestLifecycleActivity extends AppCompatActivity {
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_lifecycle);
getLifecycle().addObserver(new TestLifecycleObserver());
}
}
public class TestLifecycleFragment extends Fragment {
@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
getLifecycle().addObserver(new TestLifecycleObserver());
}
}
四、Lifecycle原理
如上所述,Lifecycle的原理是观察者模式。
4.1 两个接口
观察者模式涉及到被观察者和观察者,所以先介绍两个接口,LifecycleOwner与LifecycleObserver。
1、 LifecycleOwner对应被观察者
2、LifecycleObserver对应观察者
4.2 被观察者
在【3.1 创建观察者】章节,已经知道LifecycleObserver是我们创建的观察者类去实现该接口。那被观察者的LifecycleOwner是在哪里被实现的呢?
细心的朋友已经发现了,在【3.2 注册观察者】章节的第一句,提到了AppCompatActivity与Fragment是默认的被观察者,那就是说这两个类应该是被谷歌工程师实现了LifecycleOwner接口。
果不其然!上面两个类确实是实现了LifecycleOwner接口,作为默认的被观察者。
【阶段小结】 Activity与Fragment拥有生命周期感知的能力,所以将其设置为生命周期的被观察者更合适不过,在其内部默认实现了LifecycleOwner接口。
我们可以通过创建观察者类实现LifecycleObserver接口来注册到被观察者(Activity与Fragment)中。等待生命周期发生变化,被观察者回调所有注册在内部的观察者,通知相应的注解生命周期方法。
所以整个流程其实也分为两个阶段:①注册观察者 ②通知观察者
4.3 注册观察者
咱们以Activity的注册观察者方法为起点去梳理注册流程,源码阶段我会一行一行的和大家一起梳理,不重要会直接略过。
4.3.1 getLifecycle
首先咱们看看getLifecycle()方法返回了什么?
如上所示,getLifecycle()方法返回的是一个LifecycleRegistry对象,registry是注册处的意思,那咱们盲猜这个类是生命周期观察者的注册处,下面来验证一下。
一进入该类,可以看到LifecycleRegistry是继承自Lifecycle抽象类,Lifecycle抽象类里面定义了一些模版方法和生命周期状态。
另一方面,这个类里面的几个属性引起了我的注意
1、mObserverMap: 难道这就是保存观察者的地方?该Map还以观察者LifecycleObserver为key,难道这个Map不仅能保存观察者,还能让一个观察者对象只存在一个?
2、mState: 当前所处于的生命周期状态,这个State是一个枚举,在Lifecycle类中有定义,枚举如下,和生命周期onCreate()、onResume()有些类似,但是生命周期是一个点,而State代表的是达到这个生命周期之后的一种状态,所以英文以ED结尾表示完成式。
public enum State {
DESTROYED,
INITIALIZED,
CREATED,
STARTED,
RESUMED;
public boolean isAtLeast(@NonNull State state) {
return compareTo(state) >= 0;
}
}
3、mLifecycleOwner: 对Activity的弱引用包装了。
【阶段小结】 getLifecycle()方法返回的是LifecycleRegistry对象,目前猜想是一个生命周期观察者的注册处,里面使用Map将观察者进行,并且保存了当前生命周期的状态。
4.3.2 addObserver上半段
再回到这个注册方法,咱们继续看addObserver方法,看这个自定义观察者到底被注册到了哪里。
在LifecycleRegistry中我们找到了这个方法,因为太长咱们分段来看,文章以主要代码为主,不重要的一笔带过。
enforceMainThreadIfNeeded("addObserver");
State initialState = mState == DESTROYED ? DESTROYED : INITIALIZED;
ObserverWithState statefulObserver = new ObserverWithState(observer, initialState);
ObserverWithState previous = mObserverMap.putIfAbsent(observer, statefulObserver);
if (previous != null) {
return;
}
@Override
public V putIfAbsent(@NonNull K key, @NonNull V v) {
Entry<K, V> current = get(key);
if (current != null) {
return current.mValue;
}
mHashMap.put(key, put(key, v));
return null;
}
这段终于到我们想看的代码了!!!
这就是将观察者作为key,将上面封装了状态的观察者作为value保存到Map中啊!!咱们之前猜想的mObserverMap真的是保存所有监听者的地方!!
如果putIfAbsent方法返回不为null,就说明该Observer已经被注册过了,不能再次注册。
【阶段小结】 到这里,Observer已经成功被注册了,Observer作为key,ObserverWithState(被封装了状态的Observer)作为value,保存到了mObserverMap中,并且不能重复注册。
4.3.3 addObserver下半段
接下来挑重点看addObserver方法的下半段:
State targetState = calculateTargetState(observer);
while ((statefulObserver.mState.compareTo(targetState) < 0
&& mObserverMap.contains(observer))) {
final Event event = Event.upFrom(statefulObserver.mState);
if (event == null) {
throw new IllegalStateException("no event up from " + statefulObserver.mState);
}
statefulObserver.dispatchEvent(lifecycleOwner, event);
targetState = calculateTargetState(observer);
}
总体来说,这段代码就是将上半段状态为INITIALIZED的观察者同步到和被观察者相同的状态。
State targetState = calculateTargetState(observer);
private State calculateTargetState(LifecycleObserver observer) {
Map.Entry<LifecycleObserver, ObserverWithState> previous = mObserverMap.ceil(observer);
State siblingState = previous != null ? previous.getValue().mState : null;
State parentState = !mParentStates.isEmpty() ? mParentStates.get(mParentStates.size() - 1)
: null;
return min(min(mState, siblingState), parentState);
}
【小知识】枚举是谁放在前面谁小
while ((statefulObserver.mState.compareTo(targetState) < 0
&& mObserverMap.contains(observer))) {
...
}
循环的第一行又引出了一个Event类,这个类和State有些相似,State是用来表明一种状态,Event是用来描述一个事件。
public enum Event {
ON_CREATE,
ON_START,
ON_RESUME,
ON_PAUSE,
ON_STOP,
ON_DESTROY,
ON_ANY;
public static Event downFrom(@NonNull State state) {}
public static Event downTo(@NonNull State state) {}
public static Event upFrom(@NonNull State state) {}
public static Event upTo(@NonNull State state) {}
public State getTargetState() {}
}
通过Event事件到达State状态,比如通过ON_CREATE的Event,可以到达CREATED的State。
State和Event之间的相互转换关系如下图:
public static Event upFrom(@NonNull State state) {
switch (state) {
case INITIALIZED:
return ON_CREATE;
case CREATED:
return ON_START;
case STARTED:
return ON_RESUME;
default:
return null;
}
}
statefulObserver.dispatchEvent(lifecycleOwner, event);
static class ObserverWithState {
State mState;
LifecycleEventObserver mLifecycleObserver;
ObserverWithState(LifecycleObserver observer, State initialState) {
mLifecycleObserver = Lifecycling.lifecycleEventObserver(observer);
mState = initialState;
}
void dispatchEvent(LifecycleOwner owner, Event event) {
State newState = event.getTargetState();
mState = min(mState, newState);
mLifecycleObserver.onStateChanged(owner, event);
mState = newState;
}
}
【阶段小结】 到此,执行完了while循环,这个新的Observer的状态已经更新到与LifecyclerOwner完全一致了。
4.3.4 总结
1、通过getLifecycle()方法拿到LifecycleRegistry(生命周期注册处)。
2、将创建的观察者通过addObserver方法注册到LifecycleRegistry内部的Map中,key是观察者,value是封装了状态的观察者。且不能重复注册。
3、注册的观察者还会和LifecycleOwner的状态进行同步,并调用对应的观察者方法。
4.4 通知观察者
其实了解注册观察者流程后,我们大概可以猜想出被观察者如何通知观察者。咱们先来推论一下,Activity和Fragment应该是在感知到生命周期变化之后,从LifecycleRegistry(生命周期注册处)获取所有观察者并进行状态同步的。
4.4.1 Fragment通知观察者
Fragment中也有LifecycleRegistry,所以咱们看一下调用的位置,可以发现performCreate、performStart等方法都会有handleLifecycleEvent方法的调用!其实走到这一步就是开始通知观察者了,具体逻辑后面再看,以performStart为例看下:
void performStart() {
mChildFragmentManager.noteStateNotSaved();
mChildFragmentManager.execPendingActions(true);
mState = STARTED;
mCalled = false;
onStart();
if (!mCalled) {
throw new SuperNotCalledException("Fragment " + this
+ " did not call through to super.onStart()");
}
mLifecycleRegistry.handleLifecycleEvent(Lifecycle.Event.ON_START);
if (mView != null) {
mViewLifecycleOwner.handleLifecycleEvent(Lifecycle.Event.ON_START);
}
mChildFragmentManager.dispatchStart();
}
【阶段小结】 Fragment就是在自己能感知生命周期方法的内部去通知观察者变更状态的。
4.4.2 Activity通知观察者
在ComponentActivity的onCreate方法中可以找到一句ReportFragment.injectIfNeededIn(this),咱们看看里面做了什么
首先这个ReportFragment没有页面,会偷偷绑定到Activity上,能感知生命周期变化。另一方面通知观察者的方式在 SDK_INT >= 29 以后进行了变更,咱们分为两段看。
SDK_INT < 29
我们先来看下ReportFragment的生命周期方法
@Override
public void onActivityCreated(Bundle savedInstanceState) {
super.onActivityCreated(savedInstanceState);
dispatchCreate(mProcessListener);
dispatch(Lifecycle.Event.ON_CREATE);
}
@Override
public void onStart() {
super.onStart();
dispatchStart(mProcessListener);
dispatch(Lifecycle.Event.ON_START);
}
@Override
public void onResume() {
super.onResume();
dispatchResume(mProcessListener);
dispatch(Lifecycle.Event.ON_RESUME);
}
这里我们看到了熟悉的Lifecycle.Event身影,所以咱们继续看下dispatch方法做了什么
private void dispatch(@NonNull Lifecycle.Event event) {
if (Build.VERSION.SDK_INT < 29) {
dispatch(getActivity(), event);
}
}
static void dispatch(@NonNull Activity activity, @NonNull Lifecycle.Event event) {
if (activity instanceof LifecycleRegistryOwner) {
((LifecycleRegistryOwner) activity).getLifecycle().handleLifecycleEvent(event);
return;
}
if (activity instanceof LifecycleOwner) {
Lifecycle lifecycle = ((LifecycleOwner) activity).getLifecycle();
if (lifecycle instanceof LifecycleRegistry) {
((LifecycleRegistry) lifecycle).handleLifecycleEvent(event);
}
}
}
很明显这个方法只能在SDK_INT < 29的时候才能生效,最终我们都能看到handleLifecycleEvent方法的调用!和Fragment如出一辙。
【阶段小结】 Activity通知观察者会偷偷注册一个无布局ReportFragment,在SDK_INT < 29时ReportFragment直接根据生命周期方法去通知观察者变更状态。
SDK_INT >= 29
再看这个图,在SDK_INT >= 29时执行了一句代码,咱们看一下
看到这个LifecycleCallbacks类,一切都明朗了!!该类继承自Application.ActivityLifecycleCallbacks,注册到Activity中即可响应Activity的生命周期变化。registerIn方法直接将这个回调类注册到了Activity中,从最开始使用Fragment的生命周期转型为直接使用Activity的生命周期变化!
【阶段小结】 Activity通知观察者会偷偷注册一个无布局ReportFragment,在SDK_INT >= 29时ReportFragment会给Activity注册一个生命周期监听,直接监听Activity的生命周期变化,调用dispatch双参数方法,通知观察者变化状态。
4.4.3 handleLifecycleEvent
Activity和Fragment的分发我们只最后停留在handleLifecycleEvent方法上,现在进行一下简单的流程代码分析。
handleLifecycleEvent —— moveToState —— sync —— backwardPass / forwardPass —— observer.dispatchEvent
public void handleLifecycleEvent(@NonNull Lifecycle.Event event) {
enforceMainThreadIfNeeded("handleLifecycleEvent");
moveToState(event.getTargetState());
}
private void moveToState(State next) {
if (mState == next) {
return;
}
mState = next;
if (mHandlingEvent || mAddingObserverCounter != 0) {
mNewEventOccurred = true;
return;
}
mHandlingEvent = true;
sync();
mHandlingEvent = false;
}
private void sync() {
LifecycleOwner lifecycleOwner = mLifecycleOwner.get();
if (lifecycleOwner == null) {
throw new IllegalStateException("LifecycleOwner of this LifecycleRegistry is already"
+ "garbage collected. It is too late to change lifecycle state.");
}
while (!isSynced()) {
mNewEventOccurred = false;
if (mState.compareTo(mObserverMap.eldest().getValue().mState) < 0) {
backwardPass(lifecycleOwner);
}
Map.Entry<LifecycleObserver, ObserverWithState> newest = mObserverMap.newest();
if (!mNewEventOccurred && newest != null
&& mState.compareTo(newest.getValue().mState) > 0) {
forwardPass(lifecycleOwner);
}
}
mNewEventOccurred = false;
}
private void forwardPass(LifecycleOwner lifecycleOwner) {
Iterator<Map.Entry<LifecycleObserver, ObserverWithState>> ascendingIterator =
mObserverMap.iteratorWithAdditions();
while (ascendingIterator.hasNext() && !mNewEventOccurred) {
Map.Entry<LifecycleObserver, ObserverWithState> entry = ascendingIterator.next();
ObserverWithState observer = entry.getValue();
while ((observer.mState.compareTo(mState) < 0 && !mNewEventOccurred
&& mObserverMap.contains(entry.getKey()))) {
pushParentState(observer.mState);
final Event event = Event.upFrom(observer.mState);
if (event == null) {
throw new IllegalStateException("no event up from " + observer.mState);
}
observer.dispatchEvent(lifecycleOwner, event);
popParentState();
}
}
}
上面的流程就是通知观察者的逻辑,无非是判断状态向前走还是向后走,最终都调用了observer的dispatchEvent方法,里面会根据Event事件去调用观察者注册的事件。
总结
最后咱们再总结一下Lifecycle的原理:
- 观察者模式:LifecycleOwner(被观察者)、LifecycleObserver(观察者),AppCompatActivity与Fragment默认实现了LifecycleOwner接口。
- 注册观察者:AppCompatActivity与Fragment中都有LifecycleRegistry(生命周期注册处),创建的观察者通过addObserver方法注册到LifecycleRegistry内部的Map中,赋予初始State,不能重复注册,还会和LifecycleOwner的状态进行同步,并调用对应的观察者方法。
- 通知观察者:Fragment通过自己的生命周期变化通知观察者,Activity则偷偷注册了ReportFragment,在SDK_INT < 29 时使用ReportFragment的生命周期变化通知观察者,在SDK_INT >= 29时则在Activity中注册了生命周期监听回调通知观察者。
这样Lifecycle的介绍就结束了,希望大家读完这篇文章,会对Lifecycle有一个更深入的了解。如果我的文章能给大家带来一点点的福利,那在下就足够开心了。
下次再见!
公众号
下面是我的微信公众号【老匡话Android】,所有的系列文章都会在公众号同步更新,欢迎关注。
|