Jetpack系列 - Lifecycle从入门到源码

这篇文章旨在用最简单的方式教会你Lifecycle如何使用,及它的工作原理。

Lifecycle介绍

Lifecycle是Google推出的JetPack框架组件的一个,主要是用来感知Activity和Fragment的生命周期,可以帮你写出更简洁,通用的代码。

Lifecycle使用

总共两步

  1. 第一步,编写自己的Observer类文件,并实现对应的监听方法,通过注解实现对响应生命周期方法的监听,代码如下:
public class MyLifeObserver implements LifecycleObserver {

  private static final String TAG = "MyLifeObserver";

  // OnLifecycleEvent()内的注解Lifecycle.Event.XXX 对应不同的生命周期方法,你可以根据需要监听不同的生命周期方法。
  // 方法名可以随意,这里为了方便理解定义为onResumeListener()。
  @OnLifecycleEvent(Lifecycle.Event.ON_RESUME)
  public void onResumeListener() {
    Log.d(TAG, "onResume: ");
  }

  @OnLifecycleEvent(Lifecycle.Event.ON_PAUSE)
  public void onPauseListener() {
    Log.d(TAG, "onPause: ");
  }

  @OnLifecycleEvent(Event.ON_DESTROY)
  public void onDestoryListener() {
    Log.d(TAG, "onDestory: ");
  }
  1. 第二步在被监听的Activity/Fragment内注册:
public class MainActivity extends AppCompatActivity {

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    getLifecycle().addObserver(new MyLifeObserver());
  }
}

不管你信不信,代码已经写完了!

image.png

我们跑一下代码:

2019-02-28 12:00:40.068 com.example.lifecycledemo D/MyLifeObserver: onResume: 
2019-02-28 12:00:46.091 com.example.lifecycledemo D/MyLifeObserver: onPause: 
2019-02-28 12:00:46.416 com.example.lifecycledemo D/MyLifeObserver: onDestory: 

Log 显示我们写的 Observer 内的方法的确在 Activity 的指定周期内执行了。恭喜你,已经能够使用 Lifecycle 了
但是注意几点:

  1. 通常我们会 把MyLifeObserver 作为内部类写在另一个 Activity/Fragment 中,以方便在监控到生命周期方法后做一些业务操作,以上代码为了快速看到效果而做了省略。
  2. 注意上面 Activity 的代码中,我们的 Activity 继承了AppCompatActivity,AppCompatActivity 和 Fragment 都实现了LifecycleOwner 接口(Support Library 26.1.0之后的版本),所以可以直接拿来使用。如果你被监控的 Actiivty 是自定义的 Activity,需要手动继 承LifecycleOwner,具体操作如下:
1\. 实现LifecycleOwner接口,并重写getLifecycle方法。
2\. 手动在每个生命周期方法中做标记。

具体代码如下:

public class MyActivity extends Activity implements LifecycleOwner {
  private LifecycleRegistry mLifecycleRegistry;
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_my);
    //创建Lifecycle对象
    mLifecycleRegistry = *new*LifecycleRegistry(this);
    //做标记
    mLifecycleRegistry.markState(Lifecycle.State.CREATED);
    //添加观察者
    getLifecycle().addObserver(new MyLifeObserver());
  }

  @NonNull
  @Override
  public Lifecycle getLifecycle() {
    return mLifecycleRegistry;
  }

  @Override
  public 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); 
  }
}

至此,Lifecycle 的使用方法已经介绍完了,因为 AppCompatActivity 已经帮我们实现了 LifecycleOwner 接口,所以同学们注意活学活用
比如:在封装网络请求工具时候,传入当前 Activity 对象,当 Activity 对象生命周期为 Destory 时,撤销请求网络的操作。 Lifecycle 用武之地还有很多,这里只介绍最基础的,你现在可以思考如何通过 Lifecycle 来优化你的项目了。
如果你对Lifecyle的工作原理有兴趣,请继续阅读,我会带着你从源码一步一步完全理解 Lifecycle 的工作原理。 如果没有兴趣,可以直接拉到文章末尾看总结~

Lifecycle的工作原理

我们就以使用到的几个类为切入口,分析 Lifecycle 的工作原理。 我们主要点进这几个类看(Crtl+单击类名):LifecycleOwner.java,Lifecycle.java,LifecycleRegistry.java

LifecycleOwner.java

这个很简单,LifecycleOwner定义了一个getLifecycle()方法,通过@NonNull强制我们返回Lifecycle对象。代码如下:

public interface LifecycleOwner {
    @NonNull
    Lifecycle getLifecycle();
}

Lifecycle.java

代码如下:

public abstract class Lifecycle {

    @MainThread
    public abstract void addObserver(@NonNull LifecycleObserver observer);

    @MainThread
    public abstract void removeObserver(@NonNull LifecycleObserver observer);

    @MainThread
    @NonNull
    public abstract State getCurrentState();

    @SuppressWarnings("WeakerAccess")
    public enum Event {
    ON_CREATE,ON_START,ON_RESUME,ON_PAUSE,ON_STOP,
    ON_DESTROY,ON_ANY
    }

    @SuppressWarnings("WeakerAccess")
    public enum State {

        DESTROYED,INITIALIZED,CREATED,STARTED, RESUMED;

        public boolean isAtLeast(@NonNull State state) {
            return compareTo(state) >= 0;
        }
    }
}

Lifecycle的代码也并不多,注意它是一个抽象类。Lifecycle内部通过两个枚举分别定义了组件的生命周期的状态事件。 下面这张图摘自Android开发者官网,介绍了StateEvent的关系:

image.png

简单说下这个图怎么看:看箭头,比如 ON_CREATE 箭头表示:State 从 INITIALIZED 变为 CREATED,会触发 ON_CREATE 的 Event。依次类推。

LifecycleRegistry.java

这个类的代码比较多,是 Lifecycle 的子类,也是监听组件声明周期的核心类。我们就从使用到的方法一个一个来看:

A.构造方法,主要初始化了 mLifecycleOwner 和当前组件的状态(mState),没什么说的。

publicLifecycleRegistry(@NonNull LifecycleOwner provider) {
  mLifecycleOwner = new WeakReference<>(provider);
  mState = INITIALIZED;
}

B. 我们在 Lifecycle 的使用部分,继承了 LifecycleOwner,并在组件的生命周期内调用了 markState()方法。点进去如下:

public void markState(@NonNull State state) {
  moveToState(state);
}

C. 省去了一些复杂逻辑的代码,我们找到了这个核心的方法 sync():

private void moveToState(State next) {
 ...
  mHandlingEvent = true;
  sync();
  mHandlingEvent = false;
}

D. 同样在 sync()方法中,忽略掉逻辑代码,我们发现了正真执行的两个方法:backwardPass(),forwardPass()

private void sync() {
    LifecycleOwner lifecycleOwner = mLifecycleOwner.get();
    while(!isSynced()) {
        mNewEventOccurred = false;
        if(mState.compareTo(mObserverMap.eldest().getValue().mState) < 0) {
            backwardPass(lifecycleOwner);
        }
        Entry newest = mObserverMap.newest();
        if(!mNewEventOccurred && newest != null && mState.compareTo(newest.getValue().mState) > 0) {
            forwardPass(lifecycleOwner);
        }
    }
    mNewEventOccurred = false;
}

E. 在 backwardPass()和 forwardPass(),调用了 observer.dispatchEvent(),看名字想必就是发送事件的方法了:

private void forwardPass(LifecycleOwner lifecycleOwner) {
    ...
            observer.dispatchEvent(lifecycleOwner, upEvent(observer.mState));
    ...
}

private void backwardPass(LifecycleOwner lifecycleOwner) {
 ...
            observer.dispatchEvent(lifecycleOwner, event);
            popParentState();
 ...
}

F. 我们点击 dispatchEvent()方法,进入了下面这个静态内部类中,这个类中,就可以确定了:Observer(下面代码中的 mLifecycleObserver)触监听定生命周期的方法在这里被触发了。 但是我们如何确定这个方法的 mLifecycleObserver 就是我们实现的 Observer 呢?这个静态类还有一个方法,我们点击一下看它在哪里被调用了:

static class ObserverWithState {
    State mState;
    GenericLifecycleObserver mLifecycleObserver;

    ObserverWithState(LifecycleObserver observer, State initialState) {
        mLifecycleObserver = Lifecycling.getCallback(observer);
        mState = initialState;
    }

    void dispatchEvent(LifecycleOwner owner, Event event) {
        State newState = getStateAfter(event);
        mState = min(mState, newState);
        mLifecycleObserver.onStateChanged(owner, event);
        mState = newState;
    }
}

G. 很高兴,我们来到了 addObserver()方法,你一定还记得我们在讲解 Lifecycle 使用部分是,绑定 Observer 就是使用这个方法。

@Override
public void addObserver(@NonNull LifecycleObserver observer) {
    State initialState = mState == DESTROYED ? DESTROYED : INITIALIZED;
    ObserverWithState*statefulObserver = new ObserverWithState(observer, initialState);
    ObserverWithState*previous = mObserverMap.putIfAbsent(observer, statefulObserver);
...
}

H. 最后我们看一眼 LifecycleObserver接口(观察者),发现它是空的。其实我们看到注解应该猜到,系统是通过 apt-processor(注释处理器)将我们的 Observer 转换成 Lifecycle 真正需要类型 的Observer,下面是 OnLifecycleEvent 注解的声明:

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface OnLifecycleEvent {
    Lifecycle.Event value();
}

总结

看到这里,相信大家对 Lifecycle 的工作原理已经理解的差不多了吧,跟接口回调类似,我们创建了 Obersver 的对象,然后将 Obersver 的引用交给 Lifecycle,在组件生命周期方法执行时,调用 Observer 的相应的方法。

image.png

当然,我们自己也可以写一套接口回调来监控组件的生命周期,但是我们不得不考虑在哪里设置监听器,生命周期的问题。 其实我们使用 Lifecycle 真正的理由是,Lifecycle(LifecycleRegistry)类帮我们处理了大量的与宿主组件生命周期相关的问题,使我们的代码更简洁。专心处理业务逻辑即可。

你可能感兴趣的:(Jetpack系列 - Lifecycle从入门到源码)