Fragment - (3) -commit使用细节及源码分析

转自：http://www.jianshu.com/p/f50a1d7ab161

1. 每个事务（FragmentTranscation）只能被commit一次

承接Fragment进阶 - 基本用法中“Fragment动态加载”的事例,如果界面里有多个Fragment需要提交，而且我不想一次性全部提交，而是分几次提交...（事例代码如下）

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        getSupportFragmentManager().beginTransaction().add(R.id.fl_main, new ContentFragment(), null).commit();
        getSupportFragmentManager().beginTransaction().add(R.id.fl_main, new ContentFragment(), null).commit();
        getSupportFragmentManager().beginTransaction().add(R.id.fl_main, new ContentFragment(), null).commit();
    }
}

运行程序,没有问题程序正常，然后看下此时的视图结构：

add.png

我们add了3次，我们的Activty里有了3个Fragment的视图（这也是小编踩坑之后才成功的）。

在最初进行编写代码的时候，小编遇到一个坑，最初的代码是这样写的：

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        FragmentTransaction transaction = getSupportFragmentManager().beginTransaction();
        transaction.add(R.id.fl_main, new ContentFragment(), null).commit();
        transaction.add(R.id.fl_main, new ContentFragment(), null).commit();
        transaction.add(R.id.fl_main, new ContentFragment(), null).commit();
    }
}

我们把事务对象提取了出来（相信这是有洁癖的程序员的爱好），进行了多次提交，运行一下结果程序崩溃了（崩溃日志如下）...

 Caused by: java.lang.IllegalStateException: commit already called

日志告诉我们commit已经被调用了，看来每个事务对象只能commit一次...

但是之前的写法是没问题的，由此可以推测:每次调用getSupportFragmentManager().beginTransaction()获取的都是一个新的实例。

查看源码，证实了我们的推测...

fragment_transation.png

原来，我们开启的每一个事务都是一个回退栈记录（BackStackRecord是FragmentTransaction的一个具体实现类）

接下来，我们研究下BackStackRecord，看看commit异常是怎么抛出的。

commit_error.png

BackStackRecord的commit操作会调用一个commitInternal方法。

mCommitted记录了提交状态，我们的第1次提交mCommitted被置为true，第2次提交就抛异常了（整个源码中对mCommitted进行赋值的地方仅此1处（628行））。

结论：每个事务对象只能被commit一次。

2. Activity执行完onSaveInstanceState()方法后不能再执行commit()方法

小编想手动控制Fragment的添加显示，在Activity被销毁的时候将Fragment移除掉（代码如下）

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        getSupportFragmentManager().beginTransaction().add(R.id.fl_main, new ContentFragment(), "ContentFragment").commit();
    }

    @Override
    protected void onDestroy() {
        getSupportFragmentManager().beginTransaction().remove(getSupportFragmentManager().findFragmentByTag("ContentFragment")).commit();
        super.onDestroy();
    }
}

运行下程序，发现退出时程序崩溃了...我们得到如下崩溃日志：

Caused by: java.lang.IllegalStateException: Can not perform this action after onSaveInstanceState

异常日志告诉我们：不能在onSaveInstanceState（）方法被执行之后调用commit（）方法。

那么我们就提到onSaveInstanceState（）之前调用，代码如下：

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        getSupportFragmentManager().beginTransaction().add(R.id.fl_main, new ContentFragment(), "ContentFragment").commit();
    }

    @Override
    protected void onSaveInstanceState(Bundle outState) {
        getSupportFragmentManager().beginTransaction().remove(getSupportFragmentManager().findFragmentByTag("ContentFragment")).commit();
        super.onSaveInstanceState(outState);
    }
}

运行下程序，发现退出程序不蹦了...但又有一个新问题，手机灭屏时也会调用onSaveInstanceState方法，在打开界面发现界面变成空白了...这种方法显然不行，我们只能另找方法了。

3. commitAllowingStateLoss（）方法

FragmentTranscation 给我们提供了另外一个方法 commitAllowingStateLoss（），从名字我们也能看出这个方法的作用：允许状态丢失的提交。

看下官方文档的解释，我们就能明白原因了:

FragmentTransaction API commitAllowingStateLoss() (需要翻墙)

commit.png

原来，在Activity的状态被保存之后的提交操作是没有被Activity所记录的，恢复时也就没办法恢复这些提交操作，所以官方文档称这个方法是一个危险的操作。如果这些提交操作不是很重要，丢不丢失无所谓的话你就可以使用commitAllowingStateLoss（）这个方法了。

我们调整下代码，用commitAllowingStateLoss（）代替commit（）方法（如下）：

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        getSupportFragmentManager().beginTransaction().add(R.id.fl_main, new ContentFragment(), "ContentFragment").commit();
    }

    @Override
    protected void onDestroy() {
        getSupportFragmentManager().beginTransaction().remove(getSupportFragmentManager().findFragmentByTag("ContentFragment")).commitAllowingStateLoss();
        super.onDestroy();
    }
}

运行下代码，现在看起来没问题了...但我们知道如果出现了Activity异常销毁重启的情况，我们的移除操作在恢复时就丢失了,我们的Fragment将会出现重复叠加的问题。

之前小编在Fragment进阶 - FragmentTransaction详解最开始的时候阐述过这个问题，给出过最佳的解决办法，就不再重复说明了。

最后，我们从源码上看下commit（）和commitAllowingStateLoss（）有什么区别。

下面为BackStackRecord（FragmentTransaction的具体实现类）的部分源码。

final class BackStackRecord extends FragmentTransaction implements
        FragmentManager.BackStackEntry, Runnable {

        ......

        public int commit() {
            return commitInternal(false);
        }

        public int commitAllowingStateLoss() {
            return commitInternal(true);
        }

        int commitInternal(boolean allowStateLoss) {
            ......
            mManager.enqueueAction(this, allowStateLoss);
            ......
        }
        ......    
}

我们看到commit（）和commitAllowingStateLoss（）都调用了commitInternal（boolean allowStateLoss）这个方法只不过传入参数不同而已（commit（）传入的false,commitAllowingStateLoss（）传入的true），接下来会调用FragmentManagerImpl(FragmentManager的具体实现类)的enqueueAction方法。

final class FragmentManagerImpl extends FragmentManager implements LayoutInflaterFactory {
    ......
    public void enqueueAction(Runnable action, boolean allowStateLoss) {
        if (!allowStateLoss) {
            checkStateLoss();
        }
        ......
    }
    .....

}

我们看到，如果commitAllowingStateLoss（）传的是true所以忽略掉了检查，commit（）传的是false，所以进行了检查。

最后我们看下检查的方法checkStateLoss():

final class FragmentManagerImpl extends FragmentManager implements LayoutInflaterFactory {
    ......
    private void checkStateLoss() {
        if (mStateSaved) {
            throw new IllegalStateException(
                    "Can not perform this action after onSaveInstanceState");
        }
        ......
    }
    ......
}

看来我们之前的异常就是在这抛出的，也算是找到根源了。

4. `commit（）`方法被调用时并不会立即执行

举个简单的例子：

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        getSupportFragmentManager().beginTransaction().add(R.id.fl_main, new ContentFragment(), null).commit();
        Log.e("TAG", "MainActivity onCreated");
    }

    @Override
    public void onAttachFragment(Fragment fragment) {
        super.onAttachFragment(fragment);
        Log.e("TAG", "MainActivity onAttachFragmented");
    }
}

onAttachFragment(Fragment fragment)方法，会在添加进来的Fragment执行完onAttach方法后被回调。

我们得到如下的运行日志：

10-17 17:26:51.076 9035-9035/com.sina.example.fragmentdemo E/TAG: MainActivity onCreated
10-17 17:26:51.078 9035-9035/com.sina.example.fragmentdemo E/TAG: Fragment onAttach()
10-17 17:26:51.078 9035-9035/com.sina.example.fragmentdemo E/TAG: MainActivity onAttachFragmented

我们看到commit()被调用后生命周期没有立即开始，而是放在了onCreate（Bundle savedInstanceState）执行完成之后的某个时间。

（具体开始执行的时间点：在源码中该任务是被放在一个mHost.getHandler().post(mExecCommit)方法的参数里，也就是Handler初始化完毕，开始发送消息的时候，我们提交的任务将会被真正执行）

如果不想等待Handler初始化完毕，想要立即执行commit的操作可以使用FragmentManager里提供的executePendingTransactions()方法,这个方法将会将你所有提交的操作一并执行，而且是立即执行。

我们更改代码，添加上这个方法（如下所示）。

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        getSupportFragmentManager().beginTransaction().add(R.id.fl_main, new ContentFragment(), null).commit();
        getSupportFragmentManager().executePendingTransactions();
        Log.e("TAG", "MainActivity onCreated");
    }

    @Override
    public void onAttachFragment(Fragment fragment) {
        super.onAttachFragment(fragment);
        Log.e("TAG", "MainActivity onAttachFragmented");
    }
}

运行程序，打印下日志：

10-17 17:51:37.626 22400-22400/com.sina.example.fragmentdemo E/TAG: Fragment onAttach()
10-17 17:51:37.626 22400-22400/com.sina.example.fragmentdemo E/TAG: MainActivity onAttachFragmented
10-17 17:51:37.627 22400-22400/com.sina.example.fragmentdemo E/TAG: MainActivity onCreated

我们看到在"MainActivity onCreated"日志还未被打印之前，我们提交的Fragment的生命周期已经开始了。

5. `commitNow()`和`commitNowAllowingStateLoss()`

在最新的API_24文档里FragmentTranslation里添加了两个方法：

commitNow()
commitNowAllowingStateLoss()

调用这两个方法类似于先执行commit()/commitAllowingStateLoss()然后执行executePendingTransactions()方法。但也有区别。

区别一:不支持添加到回退栈的操作（源码如下）

final class BackStackRecord extends FragmentTransaction implements
            FragmentManager.BackStackEntry, Runnable {
    ......

    @Override
    public void commitNow() {
        disallowAddToBackStack();
        mManager.execSingleAction(this, false);
    }

    @Override
    public void commitNowAllowingStateLoss() {
        disallowAddToBackStack();
        mManager.execSingleAction(this, true);
    }
    ......
}

如果还调用addToBackStack(String name)方法会报一个IllegalStateException异常，告诉你不能向回退栈中添加FragmentTransaction。

区别二:源码没有再使用Handler，而是直接执行（源码如下）

final class FragmentManagerImpl extends FragmentManager implements LayoutInflaterFactory {

    ......
    public void execSingleAction(Runnable action, boolean allowStateLoss) {

        ......
        action.run();
        ......

    }
    ......
}

BackStackRecord实现了Runnable接口重写了run方法，action.run()会直接执行BackStackRecord的run方法。

补充：

官方更推荐使用commitNow（）和commitNowAllowingStateLoss()来代替先执行commit（）/commitAllowingStateLoss()然后执行executePendingTransactions()这种方式，因为后者会有不可预料的副作用。

总结：

如果你需要同步提交Fragment并且无需添加到回退栈中，则使用commitNow()。Support库中在 FragmentPagerAdapter中使用这个函数，来确保更新Adapter的时候页面被正确的添加和删除。一般来说，只要不添加到回退栈中，都可以使用这个函数来提交。
如果执行的提交不需要是同步的，或者需要将提交都添加到回退栈中，那么就使用commit()。
如果你需要把多次提交的操作在同一个时间点一起执行，则使用 executePendingTransactions()
如果你需要在Activity执行完onSaveInstanceState()之后还要进行提交，而且不关心恢复时是否会丢失此次提交，那么可以使用commitAllowingStateLoss()或commitNowAllowingStateLoss()。