本次推出 Android Architecture Components 系列文章,目前寫好了四篇,主要是關於 lifecycle,livedata 的使用和源碼分析,其他的 Navigation, Paging library,Room,WorkMannager 等春節結束以後會更新,歡迎關注個人公衆號,有更新的話會第一時間會在公衆號上面通知。javascript
Android LiveData 使用詳解android
Android livedata 源碼解剖github
github sample 地址: ArchiteComponentsSample設計模式
Android 技術人,一位不羈的碼農。緩存
前兩篇博客,咱們已經講解了 lifecycle ,liveData, ViewModel 的使用,這一篇博客,讓咱們一塊兒來看一下 lifecycle 的原理。bash
首先咱們先來複習一下,若是要自定義 lifecycle,咱們要這樣作。架構
public class CustomLifecycleActivity extends FragmentActivity implements LifecycleOwner {
private LifecycleRegistry mLifecycleRegistry;
private static final String TAG = "CustomLifecycleActivity";
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_custom_lifecycle);
mLifecycleRegistry = new LifecycleRegistry(this);
mLifecycleRegistry.markState(Lifecycle.State.CREATED);
getLifecycle().addObserver(new GenericLifecycleObserver() {
@Override
public void onStateChanged(LifecycleOwner source, Lifecycle.Event event) {
Log.d(TAG, "onStateChanged: event = " + event);
}
});
}
@Override
protected void onStart() {
super.onStart();
mLifecycleRegistry.markState(Lifecycle.State.STARTED);
}
@Override
protected void onResume() {
super.onResume();
mLifecycleRegistry.markState(Lifecycle.State.RESUMED);
}
@Override
protected void onDestroy() {
super.onDestroy();
mLifecycleRegistry.markState(Lifecycle.State.DESTROYED);
}
@NonNull
@Override
public Lifecycle getLifecycle() {
return mLifecycleRegistry;
}
}
複製代碼
咱們先來看一下 getLifecycle() 方法, getLifecycle() 它返回的是一個 Lifecycle 的實例,sdk 中默認的實現類爲 LifecycleRegistry。app
接下來,咱們一塊兒來看一下它的 observer 方法。
public void addObserver(@NonNull LifecycleObserver observer) {
// 判斷是不是 DESTROYED,若是是將初始狀態置爲 DESTROYED,不然爲 INITIALIZED
State initialState = mState == DESTROYED ? DESTROYED : INITIALIZED;
// ObserverWithState 包裝
ObserverWithState statefulObserver = new ObserverWithState(observer, initialState);
// 將 observer 做爲key,在緩存的 mObserverMap 中查找是否存在
ObserverWithState previous = mObserverMap.putIfAbsent(observer, statefulObserver);
// 存在,直接返回回去,證實該 observer 已經添加過了。不然,證實尚未添加過該 observer
if (previous != null) {
return;
}
LifecycleOwner lifecycleOwner = mLifecycleOwner.get();
if (lifecycleOwner == null) {
// it is null we should be destroyed. Fallback quickly
return;
}
// 這裏 mAddingObserverCounter 爲 0 ,mHandlingEvent 爲 false
boolean isReentrance = mAddingObserverCounter != 0 || mHandlingEvent;
State targetState = calculateTargetState(observer);
mAddingObserverCounter++;
while ((statefulObserver.mState.compareTo(targetState) < 0
&& mObserverMap.contains(observer))) {
pushParentState(statefulObserver.mState);
statefulObserver.dispatchEvent(lifecycleOwner, upEvent(statefulObserver.mState));
popParentState();
// mState / subling may have been changed recalculate
targetState = calculateTargetState(observer);
}
if (!isReentrance) {
// we do sync only on the top level.
sync();
}
mAddingObserverCounter--;
}
複製代碼
在 addObserver 方法中,它主要幹這幾件事情
接下來咱們先來看 calculateTargetState 方法。
private State calculateTargetState(LifecycleObserver observer) {
// 取出 mObserverMap 的上一個 entry,previous
Entry<LifecycleObserver, ObserverWithState> previous = mObserverMap.ceil(observer);
// 若是不爲空,獲取它的狀態
State siblingState = previous != null ? previous.getValue().mState : null;
// 判斷 mParentStates 是否爲 null,不爲 null,去最後的一個狀態,不然,爲 null
State parentState = !mParentStates.isEmpty() ? mParentStates.get(mParentStates.size() - 1)
: null;
// 取最小的狀態
return min(min(mState, siblingState), parentState);
}
複製代碼
public enum State {
DESTROYED,
INITIALIZED,
CREATED,
STARTED,
RESUMED;
public boolean isAtLeast(@NonNull State state) {
return compareTo(state) >= 0;
}
}
複製代碼
State 中,他們排序的順序是 DESTROYED < INITIALIZED < CREATED < STARTED < RESUMED。
咱們知道,咱們在 activity 的 onCreate 方法中初始化 LifecycleRegistry,並標記它的狀態爲 CREATED。當咱們第一次在 onCreate 方法調用 addObserver 的時候,在 calculateTargetState 方法中,如果首次調用 previous 爲 null,則 siblingState,parentState 爲 null, 而 mState 爲 CREATED,因此最終的狀態爲 CREATED,即 State targetState = calculateTargetState(observer); 中 targetState 爲 CREATED
// 取最小的狀態
return min(min(mState, siblingState), parentState);
複製代碼
看完 calculateTargetState 方法,咱們回過頭再來看一下 addObserver 方法。
public void addObserver(@NonNull LifecycleObserver observer) {
// 省略若干行
// 這裏 mAddingObserverCounter 爲 0 ,mHandlingEvent 爲 false
boolean isReentrance = mAddingObserverCounter != 0 || mHandlingEvent;
State targetState = calculateTargetState(observer);
mAddingObserverCounter++;
while ((statefulObserver.mState.compareTo(targetState) < 0
&& mObserverMap.contains(observer))) {
pushParentState(statefulObserver.mState);
statefulObserver.dispatchEvent(lifecycleOwner, upEvent(statefulObserver.mState));
popParentState();
// mState / subling may have been changed recalculate
targetState = calculateTargetState(observer);
}
if (!isReentrance) {
// we do sync only on the top level.
sync();
}
mAddingObserverCounter--;
}
複製代碼
這裏 statefulObserver.mState 爲 DESTROYED 或者 INITIALIZED,確定比 CREATED 小。而 mObserverMap.contains(observer) 一定爲 true,除非咱們手動移除掉 mObserverMap。於是,會走進 while循環。
private void pushParentState(State state) {
mParentStates.add(state);
}
private ArrayList<State> mParentStates = new ArrayList<>();
複製代碼
pushParentState(statefulObserver.mState); 很簡單,只是將 statefulObserver 的狀態添加到 mParentStates 集合中。
繼續往下走,接着會調用 statefulObserver.dispatchEvent(lifecycleOwner, upEvent(statefulObserver.mState));
private static Event upEvent(State state) {
switch (state) {
case INITIALIZED:
case DESTROYED:
return ON_CREATE;
case CREATED:
return ON_START;
case STARTED:
return ON_RESUME;
case RESUMED:
throw new IllegalArgumentException();
}
throw new IllegalArgumentException("Unexpected state value " + state);
}
複製代碼
upEvent 方法也很簡單,只是返回它的下一個 event。這裏由於他們的 state爲 INITIALIZED,因此它會返回 ON_CREATE。
void dispatchEvent(LifecycleOwner owner, Event event) {
State newState = getStateAfter(event);
mState = min(mState, newState);
mLifecycleObserver.onStateChanged(owner, event);
mState = newState;
}
static State getStateAfter(Event event) {
switch (event) {
case ON_CREATE:
case ON_STOP:
return CREATED;
case ON_START:
case ON_PAUSE:
return STARTED;
case ON_RESUME:
return RESUMED;
case ON_DESTROY:
return DESTROYED;
case ON_ANY:
break;
}
throw new IllegalArgumentException("Unexpected event value " + event);
}
複製代碼
這裏 event 爲 ON_CREATE,因此 newState 也爲 CREATED。 mState = min(mState, newState); mState newState,二者狀態相同,因此 mState 也爲 CREATED。接着回調 mLifecycleObserver 的 onStateChanged 方法。因此,這裏,會收到咱們的 onCreate 事件,與咱們的預想相符。
可是咱們並無在 onStart,onResume, onPause , onStop 和 onDestroy 方法中調用 mLifecycleRegistry.handleLifecycleEvent 方法,它又是怎樣促發 Observer 的 onStateChanged 方法的。這裏先不揭曉,咱們先來看一下 26.1.0 之後的 AppCompatActivity,待會你就明白了,會感嘆 google 真的牛逼!
咱們知道,在 26.1.0 之後,若是咱們要使用 lifecycle,咱們只須要調用如下的方法便可。
getLifecycle().addObserver(new GenericLifecycleObserver() {
@Override
public void onStateChanged(LifecycleOwner source, Lifecycle.Event event) {
Log.d(TAG, "onStateChanged: event =" + event);
}
});
複製代碼
跟蹤 getLifecycle() 方法,它會跳轉到 SupportActivity 的 getLifecycle 方法 中。
public class SupportActivity extends Activity implements LifecycleOwner, Component {
private LifecycleRegistry mLifecycleRegistry = new LifecycleRegistry(this);
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
ReportFragment.injectIfNeededIn(this);
}
@Override
public Lifecycle getLifecycle() {
return mLifecycleRegistry;
}
}
複製代碼
在 SupportActivity 中,它默認爲咱們初始化 mLifecycleRegistry,做爲一個成員變量。接着,他在 onCreate 方法中調用了 ReportFragment.injectIfNeededIn(this); 方法。
public class ReportFragment extends Fragment {
private static final String REPORT_FRAGMENT_TAG = "android.arch.lifecycle"
+ ".LifecycleDispatcher.report_fragment_tag";
public static void injectIfNeededIn(Activity activity) {
// ProcessLifecycleOwner should always correctly work and some activities may not extend
// FragmentActivity from support lib, so we use framework fragments for activities
android.app.FragmentManager manager = activity.getFragmentManager();
if (manager.findFragmentByTag(REPORT_FRAGMENT_TAG) == null) {
manager.beginTransaction().add(new ReportFragment(), REPORT_FRAGMENT_TAG).commit();
// Hopefully, we are the first to make a transaction.
manager.executePendingTransactions();
}
}
複製代碼
在 injectIfNeededIn 方法中,它會判斷咱們是否已經添加 ReportFragment,沒有的話,添加進去。
public class ReportFragment extends Fragment {
private static final String REPORT_FRAGMENT_TAG = "android.arch.lifecycle"
+ ".LifecycleDispatcher.report_fragment_tag";
private ActivityInitializationListener mProcessListener;
private void dispatchCreate(ActivityInitializationListener listener) {
if (listener != null) {
listener.onCreate();
}
}
private void dispatchStart(ActivityInitializationListener listener) {
if (listener != null) {
listener.onStart();
}
}
private void dispatchResume(ActivityInitializationListener listener) {
if (listener != null) {
listener.onResume();
}
}
@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);
}
@Override
public void onPause() {
super.onPause();
dispatch(Lifecycle.Event.ON_PAUSE);
}
@Override
public void onStop() {
super.onStop();
dispatch(Lifecycle.Event.ON_STOP);
}
@Override
public void onDestroy() {
super.onDestroy();
dispatch(Lifecycle.Event.ON_DESTROY);
// just want to be sure that we won't leak reference to an activity
mProcessListener = null;
}
}
複製代碼
而後,它在 onCreat ,onStart, onResume, onPause, onStop, onDestroy 方法中分別調用 dispatch 方法進行分發生命週期。
private void dispatch(Lifecycle.Event event) {
Activity activity = getActivity();
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);
}
}
}
複製代碼
在 dispatch 方法中,會先判斷 activity 是否是實現了 LifecycleRegistryOwner ,若是是,直接分發,不過不是,判斷是否實現 LifecycleOwner,獲取它的 lifecycle,調用它 的 handleLifecycleEvent 進行分發。
public class SupportActivity extends Activity implements LifecycleOwner, Component {
private LifecycleRegistry mLifecycleRegistry = new LifecycleRegistry(this
複製代碼
而很明顯,高版本的 SupportActivity 實現了 LifecycleOwner 接口,並寫 LifecycleOwner.getLifecycle() 是 LifecycleRegistry
對於 26.1.0 之後的版本,你會發現,對於普通的 Activity,若是你想要使用 lifecycle,你只須要實現 LifecycleOwner 接口便可。當生命週期變化的時候,它也能夠回調 Observer 的 onStateChanged 方法。
回到咱們前面的問題:
咱們並無在 onStart,onResume, onPause , onStop 和 onDestroy 方法中調用 mLifecycleRegistry.handleLifecycleEvent 方法,它又是怎樣促發 onStateChanged 方法的
**咱們猜測它也是經過 ReportFragment 實現的。**可是在 Activity 的 onCreate 方法中,咱們並無發現它有添加 ReportFragment,咱們在 As 全局搜一下,看哪些地方使用到 ReportFragment。以下圖
從圖中能夠看到,有幾個地方使用到他。咱們先來看一下 LifecycleDispatcher
class LifecycleDispatcher {
private static final String REPORT_FRAGMENT_TAG = "android.arch.lifecycle"
+ ".LifecycleDispatcher.report_fragment_tag";
private static AtomicBoolean sInitialized = new AtomicBoolean(false);
static void init(Context context) {
if (sInitialized.getAndSet(true)) {
return;
}
// 在 init 方法中,監聽全局 activity 的建立,從而來添加 fragment
((Application) context.getApplicationContext())
.registerActivityLifecycleCallbacks(new DispatcherActivityCallback());
}
@SuppressWarnings("WeakerAccess")
@VisibleForTesting
static class DispatcherActivityCallback extends EmptyActivityLifecycleCallbacks {
private final FragmentCallback mFragmentCallback;
DispatcherActivityCallback() {
mFragmentCallback = new FragmentCallback();
}
@Override
public void onActivityCreated(Activity activity, Bundle savedInstanceState) {
if (activity instanceof FragmentActivity) {
((FragmentActivity) activity).getSupportFragmentManager()
.registerFragmentLifecycleCallbacks(mFragmentCallback, true);
}
ReportFragment.injectIfNeededIn(activity);
}
@Override
public void onActivityStopped(Activity activity) {
if (activity instanceof FragmentActivity) {
markState((FragmentActivity) activity, CREATED);
}
}
@Override
public void onActivitySaveInstanceState(Activity activity, Bundle outState) {
if (activity instanceof FragmentActivity) {
markState((FragmentActivity) activity, CREATED);
}
}
}
// 省略若干代碼
}
複製代碼
能夠看到,它 在 init 方法中,經過 context.getApplicationContext() .registerActivityLifecycleCallbacks 監聽全局 activity 的建立,在 activity oncreate 的時候,調用 ReportFragment.injectIfNeededIn(activity) ,從而來添加 fragment,進而分發相應的事件。
那 LifecycleDispatcher 的 init 方法又是在哪裏調用的呢? 咱們全局搜索一下
public class ProcessLifecycleOwnerInitializer extends ContentProvider {
@Override
public boolean onCreate() {
LifecycleDispatcher.init(getContext());
ProcessLifecycleOwner.init(getContext());
return true;
}
複製代碼
能夠看到它是在 ProcessLifecycleOwnerInitializer 的 onCreate 方法中調用的。而 ProcessLifecycleOwnerInitializer 是一個 ContentProvider。咱們知道 ContentProvider 通常是在 AndroidManifest 中生命的。
果真,在 extensions-1.1.1.aar 中,咱們驚喜地發現,它在 Manifest 裏面註冊了。
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="android.arch.lifecycle.extensions" >
<uses-sdk android:minSdkVersion="14" />
<application>
<provider
android:name="android.arch.lifecycle.ProcessLifecycleOwnerInitializer"
android:authorities="${applicationId}.lifecycle-trojan"
android:exported="false"
android:multiprocess="true" />
</application>
</manifest>
複製代碼
而 ContentProvider 的 onCreate 方法優先於 Application 的 onCreate 執行,因此在 Application 以前咱們就調用了 ProcessLifecycleOwnerInitializer init 方法,監聽了 Activity 的建立,當 Actiivty 建立的時候,會嘗試爲 Activity 添加 ReportFragment。而 ReportFragment 會在 Activity 生命週期變化的時候幫助咱們分發生命週期。
ContentProvider 的 onCreate 方法優先於 Application 的 onCreate 執行,能夠查看這一篇博客 Android系統中的Application和四大組件一些方法的啓動順序和一些坑
ok,咱們來梳理一下。
對於 26.1.0 之後的 SupportActivity
它在 Activity onCreate 的時候添加了 ReportFragment,這個 ReportFragment 至關於一個代理,它在 onActivityCreated 的時候 dispatch(Lifecycle.Event.ON_CREATE) 進行分發生命週期,onStart, onResume, onPause, onStop, onDestroy 的時候也是如此。而 在 dispatch 中 它調用了 LifecycleRegistry handleLifecycleEvent 的方法。而 LifecycleRegistry 方法中通過一系列處理,它又調用了 observer 的 onStateChange 方法,去通知相應的 observer。
對於普通的 Activity
它利用了 ContentProvide 的特徵,它是在 Application onCreate 以前初始化的,他在 ProcessLifecycleOwnerInitializer oncreate 的時候監聽 Activity 的建立,在 Activity 建立的時候,判斷是否已經添加過 ReportFragment,沒有的話,添加進去。這是一個很巧妙的設計,隱式初始化了 lifecycle。
用流程圖表示以下:
該圖片引用自 Android 架構組件(一)——Lifecycle
想一下,若是 ProcessLifecycleOwnerInitializer 不利用 contentProvider 來隱式加載的話,對於 普通的 Activity,舊版本等,若是想使用 lifecycle,那必須在基類中,手動調用 ReportFragment.injectIfNeededIn(activity) 的方法。
利用 fragment 來分發生命週期有兩個優勢
推薦閱讀: