从源码角度看finish()方法的执行流程

1. finish()方法概览

首先我们来看一下finish方法的无参版本的定义:

/**
* Call this when your activity is done and should be closed. The
* ActivityResult is propagated back to whoever launched you via
* onActivityResult(). */
public void finish() {
finish(false);
}

根据源码中的注释我们可以知道,当我们的activity已经完成它的工作,我们想要关闭它时,我们可以调用finish()方法。这个方法内部回去调用finish(boolean)方法,并传入false作为参数。那么接下来我们从finish(boolean)方法出发,来了解下finish()方法的大致执行流程。

2. finish()方法执行流程

     /**
* Finishes the current activity and specifies whether to remove the task associated with this
* activity.
*/
private void finish(boolean finishTask) {
if (mParent == null) {
int resultCode;
Intent resultData;
synchronized (this) {
resultCode = mResultCode;
resultData = mResultData;
}
if (false) Log.v(TAG, "Finishing self: token=" + mToken);
try {
if (resultData != null) {
resultData.prepareToLeaveProcess();
}
if (ActivityManagerNative.getDefault()
.finishActivity(mToken, resultCode, resultData, finishTask)) {
mFinished = true;
}
} catch (RemoteException e) {
// Empty
}
} else {
mParent.finishFromChild(this);
}
}

根据注释我们可以知道boolean类型参数finishTask的作用是是否移除与我们要关闭的activity相关联的task。我们注意到这个方法的访问修饰符是private,所以它只是供Activity类内部调用的方法。那么我们接下来看一下这个方法究竟是怎样实现关闭一个activity的。在第6行,我们判断mParent是否为null。现在我们只需要知道mParent在一般情况下均为null即可。所以这个方法接下来会执行第7到24行的代码。在第10行和第11行,我们分别把resultCode和resultData赋值为mResultCode和mResultData。resultCode和resultData最终会传入到onActivityResult方法中。

以上代码的关键在于第18行调用的finishActivity方法,若这个方法返回true,我们就会设置Activity的mFinished成员变量为true。isFinishing()方法用于判断一个Activity是否处于销毁状态,这个方法的实现就是返回mFinished成员变量。也就是说,若finishActivity方法执行完毕并返回true,则Activity就被成功销毁了。下面我们回到第18行:通过调用ActivityManagerNative.getDefault()方法会得到一个ActivityManagerProxy对象,这是ActivityManagerService(下文简称为AMS)的代理对象。那么AMS是什么呢?这里我们只需要知道它是一个系统服务,系统中四大组件的启动、切换、销毁等都是由它负责的。我们通过ActivityManagerProxy对象可以请求AMS去启动、暂停或是销毁一个Activity。ActivityManagerProxy是ActivityManagerNative的一个内部类,它的finishActivity方法如下所示:

     public boolean finishActivity(IBinder token, int resultCode, Intent resultData, boolean finishTask)
throws RemoteException {
Parcel data = Parcel.obtain();
Parcel reply = Parcel.obtain();
data.writeInterfaceToken(IActivityManager.descriptor);
data.writeStrongBinder(token);
data.writeInt(resultCode);
if (resultData != null) {
data.writeInt(1);
resultData.writeToParcel(data, 0);
} else {
data.writeInt(0);
}
data.writeInt(finishTask ? 1 : 0);
mRemote.transact(FINISH_ACTIVITY_TRANSACTION, data, reply, 0);
reply.readException();
boolean res = reply.readInt() != 0;
data.recycle();
reply.recycle();
return res;
}

以上代码中的reply用于保存返回结果,data会作为参数传递给AMS。我们首先向要传递给AMS的data中写入了token、resultCode。若resultData不为null,则会先写入一个整数1,再写入resultData,若resultData为null,则只写入一个整数0。然后我们再根据finishTask参数为true或false分别写入1或0。以上代码的关键在于第15行调用的mRemote.transact(...)方法,它会导致AMS的onTransact(...)方法被调用。AMS的onTransact方法调用了ActivityManagerNative的onTransact方法,这个方法的代码如下:

    public boolean onTransact(int code, Parcel data, Parcel reply, int flags)
throws RemoteException {
switch (code) {
...
case FINISH_ACTIVITY_TRANSACTION: {
data.enforceInterface(IActivityManager.descriptor);
IBinder token = data.readStrongBinder();
Intent resultData = null;
int resultCode = data.readInt();
if (data.readInt() != 0) {
resultData = Intent.CREATOR.createFromParcel(data);
}
boolean finishTask = (data.readInt() != 0);
boolean res = finishActivity(token, resultCode, resultData, finishTask);
reply.writeNoException();
reply.writeInt(res ? 1 : 0);
return true;
}
...
}

我们可以看到,这个方法会根据传入的code参数执行不同的case分支,这里会执行的是code为FINISH_ACTIVITY_TRANSACTION的分支。以上代码中又调用了finishActivity方法(AMS中),所以我们接着看这个方法的实现:

     /**
* This is the internal entry point for handling Activity.finish().
*
* @param token The Binder token referencing the Activity we want to finish.
* @param resultCode Result code, if any, from this Activity.
* @param resultData Result data (Intent), if any, from this Activity.
*
* @return Returns true if the activity successfully finished, or false if it is still running.
*/
public final boolean finishActivity(IBinder token, int resultCode, Intent resultData) {
// Refuse possible leaked file descriptors
if (resultData != null && resultData.hasFileDescriptors() == true) {
throw new IllegalArgumentException("File descriptors passed in Intent");
}
synchronized(this) {
... final long origId = Binder.clearCallingIdentity();
boolean res = requestFinishActivityLocked(token, resultCode,
18 resultData, "app-request");
19 Binder.restoreCallingIdentity(origId);
20 return res;
21 }
22 }

根据源码中的注释我们可以看到,这个方法是处理Activity.finish()的内部入口点。这个方法内部又调用了requestFinishActivityLocked方法,所以我们还要接着跟进。requestFinishActivityLocked方法的源码如下:

     private final boolean requestFinishActivityLocked(IBinder token, int resultCode,
Intent resultData, String reason) {
...
HistoryRecord r = (HistoryRecord)mHistory.get(index);
// Is this the last activity left?
boolean lastActivity = true;
for (int i=mHistory.size()-1; i>=0; i--) {
HistoryRecord p = (HistoryRecord)mHistory.get(i);
if (!p.finishing && p != r) {
lastActivity = false;
break;
}
} // If this is the last activity, but it is the home activity, then
// just don't finish it.
if (lastActivity) {
if (r.intent.hasCategory(Intent.CATEGORY_HOME)) {
return false;
}
} finishActivityLocked(r, index, resultCode, resultData, reason);
return true;
}

首先我们看一下第4行出现了HistoryRecord和mHistory。这里我们简单的介绍一下它们两个。mHistory是AMS的成员变量,它是一个ArrayList,里面存储的元素类型为HistoryRecord,一个HistoryReord表示一个Activity。也就是说mHistory存储了系统中所有曾经存在过或正在运行的Activity。第6行到第13行的功能就是判断现在系统中是否只剩下一个正在运行Activity,这一点从注释中就可以看出。然后在第17行到第21行,若唯一正在运行的Activity是HomeActivity,则直接返回false(不会关闭它)。以上代码中的关键在于第23行调用的finishActivityLocked方法,这个方法的核心代码如下:

    private final boolean finishActivityLocked(HistoryRecord r, int index,
int resultCode, Intent resultData, String reason) { ...if (mResumedActivity == r) {
...
} else if (r.state != ActivityState.PAUSING) {
// If the activity is PAUSING, we will complete the finish once
// it is done pausing; else we can just directly finish it here.
if (DEBUG_PAUSE) Slog.v(TAG, "Finish not pausing: " + r);
return finishCurrentActivityLocked(r, index,
FINISH_AFTER_PAUSE) == null;
} else {
if (DEBUG_PAUSE) Slog.v(TAG, "Finish waiting for pause of: " + r);
}
return false;
}

以上代码实际上会调用finishCurrentActivityLocked方法,若这个方法返回值为null,finishActivityLocked则会返回true,否则会返回false。那么我们来看看finishCurrentActivityLocked方法的实现:

    private final HistoryRecord finishCurrentActivityLocked(HistoryRecord r,
int index, int mode) {
... final ActivityState prevState = r.state;
r.state = ActivityState.FINISHING;
if (mode == FINISH_IMMEDIATELY
|| prevState == ActivityState.STOPPED
|| prevState == ActivityState.INITIALIZING) {
// If this activity is already stopped, we can just finish
// it right now.
return destroyActivityLocked(r, true) ? null : r;
} else {
// Need to go through the full pause cycle to get this
// activity into the stopped state and then finish it.
if (localLOGV) Slog.v(TAG, "Enqueueing pending finish: " + r);
mFinishingActivities.add(r);
resumeTopActivityLocked(null);
}
return r;
}

根据源码中的注释我们可以知道,若Activity已经处于停止状态,则可以立即调用destroyActivityLocked方法;否则我们需要先经历完整的“暂停周期”以让这个Activity处于停止状态后再结束它。

在destroyActivityLocked方法中存在如下这句代码:

r.app.thread.scheduleDestroyActivity(r, r.finishing,r.configChangeFlags);

其中,r.app.thread实际上是AMS持有的应用程序进程的ApplicationThread的代理对象,所以实际上调用的是ApplicationThread的scheduleDestroyActivity方法,而后这个方法中会向主线程(ActivityThread)发送一个H.DESTROY_ACTIVITY消息,主线程会调用handleDestroyActivity来处理这个消息,再经过层层调用后,Activity的onDestroy方法会被回调。对这一过程感兴趣的同学可以自行阅读相关源码。

3. finish()方法总结

通过上面对源码的分析,我们大概了解了finish()方法的工作流程,有两点需要我们注意:

(1)经过层层调用,ApplicationThread.scheduleDestroyActivity方法会被调用,这个方法会完成对Activity的销毁工作,并且会回调Activity.onDestroy()方法。所以我们知道了调用finish()方法会导致对Acitivity的销毁,从而导致Activity.onDestroy()被回调。

(2)在我们的日常开发中,往往会将finish()方法的调用包含在Activity的某个生命周期中,而实际上Activity的各个生命周期方法都是由ApplicationThread.scheduleXXXActivity方法回调的,这个方法会向主线程发送一个H.XXX_ACTIVITY消息,随后主线程的Looper会从消息队列中这个消息并调用handleXXXActivity方法来处理它,并最终会回到Activity.onXXX方法。比如我们在onCreate()方法中调用了finish()方法,那么由于此时主线程正处于对H.CREATE_ACTIVITY消息的处理中,所以暂时无法处理H.DESTROY_ACTIVITY消息,只有当主线程处理完前一个消息了,才会着手处理H_DESTROY_ACTIVITY消息。因此,我们调用finish()方法后,onDestroy()往往并不会被立即调用,但是我们可以通过isFinishing()方法来判断Activity是否处于销毁状态。

以上是我对finish()方法相关源码的执行流程的总结,由于个人水平有限,叙述中难免存在不准确或是不清晰的地方,希望大家可以指出,谢谢大家:)

4. 参考资料

https://android.googlesource.com/platform/frameworks/base/+/android-6.0.1_r26/core/java/android/app

上一篇:cron 任务


下一篇:【uTenux实验】事件标志