一、概述
在平時的開發當中,用到ViewPager
的場景主要是以下兩種:
- 對于主頁中的每個子頁面,用
Fragment
包裹起來,然后通過ViewPager
來實現頁面之間的切換。 - 廣告輪播圖。
其中對于第一種情況,我們常常會使用到兩個PagerAdapter
的實現類,也就是FragmentStatePagerAdapter
和FragmentPagerAdapter
,今天,我們就來學習一下它們的使用方法,并進行對比。
二、FragmentPagerAdapter
2.1 使用
在我們的例子中,我們定義了一個Acitivity
,它的布局中包含有一個ViewPager
。初始時候我們會給mFragments
列表中新建4
個Fragment
實例,然后把它傳給繼承于FragmentPagerAdapter
的適配器,LogcatFragment
就是用來打印Fragment
的生命周期:
private void initFPAFragments() {
mFragments = new ArrayList<>();
for (int i = 0; i < INCREASE; i++) {
//初始時刻有4個Fragment,每個Fragment和一條數據相關聯.
mFragments.add(LogcatFragment.newInstance("index=" + i));
}
ViewPager viewPager = (ViewPager) findViewById(R.id.vp_content);
mFPAdapter = new FPAdapter(getSupportFragmentManager(), mFragments);
viewPager.setAdapter(mFPAdapter);
}
private class FPAdapter extends FragmentPagerAdapter {
private List<Fragment> mFragments;
public FPAdapter(FragmentManager fm, List<Fragment> fragments) {
super(fm);
mFragments = fragments;
}
@Override
public Fragment getItem(int position) {
Log.d("LogcatFragment", "get Item from FPAdapter, position=" + position);
return mFragments.get(position);
}
@Override
public int getCount() {
return mFragments.size();
}
}
2.2 現象
使用過ViewPager
的同學都知道,ViewPager
有一個setOffscreenPageLimit
,它表示對于當ViewPager
處于IDLE
狀態時,它的左右兩端最多會保留多少個頁面,對于超出這個范圍的頁面有可能會需要從PageAdapter
中進行重建,這里我們設置的是1
,下面我們進行一系列的操作,并觀察此時各個頁面及其內部的Fragment
的變化情況:
- 第一步:當我們第一次啟動
Activity
的時候,默認會添加它的左右兩個界面,由于我們位于第一個(index=0
),因此會添加它及其右邊的界面(index=0
),此時這兩個頁面當中內部的Fragment
的生命周期如下圖所示:
從我們經常看到的Fragment
生命周期的圖來看,就是下面紅色的部分:
- 第二步:下面,我們滑動到
index=1
的界面,此時index=2
的頁面會被添加,它內部的Fragment
所走的生命周期和上面完全相同,由于index=1
左右兩邊的界面個數都為1
,因此不會有頁面被移除。 - 第三步:繼續往右滑動到
index=2
的界面,此時會添加index=3
的頁面,并移除index=0
的頁面,其內部包含的Fragment
的生命周期打印為:
可以看到對于添加的index=3
的頁面而言,它內部的Fragment
所走的生命周期和index=0/1/2
相同,而被移除的index=0
的頁面內部的Fragment
所走的生命周期為:
- 第四步:向右滑動到
index=1
的界面,此時index=0
的界面需要被重新添加,而index=3
的界面則需要被移除,此時的打印為:
這時候,對于重新添加的頁面index=0
,它和第一次添加的時候有兩點不同: - 沒有再去自定義的
FragmentPagerAdapter
中取Fragment
- 其內部的
Fragment
所走的生命周期不同,此時為:
最后,我們總結一下,對于三種情況的頁面內部的Fragment
所走生命周期的區別如下圖所示:
- 第一次添加的頁面
- 重新添加的頁面
- 移除的頁面
2.3 源碼解析
現在,我們就開始解釋一下,為什么第一次添加和重新添加的頁面內部對應的Fragment
會有所不同,我們只需要關注FragmentPagerAdapter
內的兩個函數:
-
public Object instantiateItem(ViewGroup container, int position)
,添加頁面時回調。 -
public void destroyItem(ViewGroup container, int position, Object object)
,移除頁面時回調。
@Override
public Object instantiateItem(ViewGroup container, int position) {
if (mCurTransaction == null) {
mCurTransaction = mFragmentManager.beginTransaction();
}
//這里的itemId返回的是對應position的頁面的唯一標識符.
final long itemId = getItemId(position);
//1.先是通過FragmentManager來找.
String name = makeFragmentName(container.getId(), itemId);
Fragment fragment = mFragmentManager.findFragmentByTag(name);
//2.如果找到了,那么調用attach方法.
if (fragment != null) {
if (DEBUG) Log.v(TAG, "Attaching item #" + itemId + ": f=" + fragment);
mCurTransaction.attach(fragment);
} else {
//3.如果沒找到,那么通過子類實現的getItem方法來獲取.
fragment = getItem(position);
//這里調用的是add方法.
mCurTransaction.add(container.getId(), fragment, makeFragmentName(container.getId(), itemId));
}
//根據需要,回調下面這兩個方法.
if (fragment != mCurrentPrimaryItem) {
fragment.setMenuVisibility(false);
fragment.setUserVisibleHint(false);
}
//返回給ViewPager.
return fragment;
}
@Override
public void destroyItem(ViewGroup container, int position, Object object) {
if (mCurTransaction == null) {
mCurTransaction = mFragmentManager.beginTransaction();
}
//4.移除界面時,調用的是detach方法.
mCurTransaction.detach((Fragment)object);
}
注意看上面的注釋,就能解釋上面我們看到的現象了:
- 第一次添加界面的時候,由于
FragmentManager
中沒有這個Fragment
,因此需要通過自定義的FragmentPagerAdapter
獲取,然后調用add
方法,也就是上面代碼中的第(3)步,所走的生命周期為onAttach() -> onResume()
。 - 移除界面時,使用的是
detach
方法,也就是上面代碼中的第(4)步,接觸過Fragment
的人都知道,這時候僅僅是Fragment
的界面被從View
樹上移除了而已,它的實例仍然被保存在FragmentManager
當中,所走的生命周期為onPause() -> onDestroyView()
。 - 重新添加界面時,由于此時去
FragmentManager
中能找到那個Fragment
,所以調用的是attach
方法,也就是上面代碼中的第(2)步,所走的生命周期為onCreateView() -> onResume()
,并且不需要再從自定義的FragmentPagerAdapter
中獲取Fragment
。
整個邏輯如下圖所示:
三、FragmentStatePagerAdapter
3.1 現象
我們的代碼基本不用改動,只需要把原來繼承于FragmentPagerAdapter
的子類替換為繼承FragmentStatePagerAdapter
就可以了。在第二章當中,我們分析得很詳細,相信大家對于整個分析的套路已經理解,因此,為了減少篇幅,我們直接說結論,當進行和上面相同的操作之后,把頁面分為三種類型:
- 第一次添加
- 重新添加
- 移除
此時,它們內部的Fragment
所走的生命周期為:
對于重新添加和移除的界面,其內部的Fragment
所走的生命周期都和FragmentPagerAdapter
不同,下面,我們就從源碼的角度,來看一下導致這些區別的原因。
3.2 源碼解析
和前面類似,我們只關注添加和移除時調用的那兩個方法:
@Override
public Object instantiateItem(ViewGroup container, int position) {
//如果mFragments中存在對應位置的fragment,那么直接返回.
if (mFragments.size() > position) {
Fragment f = mFragments.get(position);
if (f != null) {
return f;
}
}
if (mCurTransaction == null) {
mCurTransaction = mFragmentManager.beginTransaction();
}
Fragment fragment = getItem(position);
//多了恢復狀態的操作.
if (mSavedState.size() > position) {
Fragment.SavedState fss = mSavedState.get(position);
if (fss != null) {
fragment.setInitialSavedState(fss);
}
}
//保證mFragments的大小和ViewPager往右滑動的最遠的index相同.
while (mFragments.size() <= position) {
mFragments.add(null);
}
fragment.setMenuVisibility(false);
fragment.setUserVisibleHint(false);
//設置對應位置.
mFragments.set(position, fragment);
//這里很關鍵,調用的add方法.
mCurTransaction.add(container.getId(), fragment);
return fragment;
}
@Override
public void destroyItem(ViewGroup container, int position, Object object) {
Fragment fragment = (Fragment) object;
if (mCurTransaction == null) {
mCurTransaction = mFragmentManager.beginTransaction();
}
while (mSavedState.size() <= position) {
mSavedState.add(null);
}
mSavedState.set(position, fragment.isAdded() ? mFragmentManager.saveFragmentInstanceState(fragment) : null);
mFragments.set(position, null);
//調用的是remove方法.
mCurTransaction.remove(fragment);
}
從上面的源碼當中,總結出以下幾點:
-
FragmentStatePagerAdapter
在移除頁面的時候,調用的是remove
方法,也就是說,FragmentManager
中不再有這個Fragment
的實例,所走的生命周期為onPause() -> onDetach()
。 - 無論是添加頁面還是重新添加頁面,它是通過
add
方法,并且每次都會通過自定義的FragmentStatePagerAdapter
子類的getItem
方法來獲取Fragment
,所以它們內部的Fragment
所走生命周期相同,都是從onAttach() -> onResume()
。 - 對于
ViewPager
當前界面中所對應的Fragment
,是通過一個mFragments
列表來管理的,由于此時沒有FragmentManager
來幫我們實現Fragment
集合的狀態的保存和恢復,所以就需要我們自己實現onSave/onRestore
方法來進行狀態的保存和恢復。
整個流程如下圖所示:
四、總結
FragmentPagerAdapter
和FragmentStatePagerAdapter
最大的區別就在于前者會把所有Fragment
的示例都緩存在內存當中,而后者僅僅保存了ViewPager
當前存在的頁面所對應的Fragment
,當頁面被移除之后,這個Fragment
的示例它也就不再保存了。
當然,在我們前面的例子中,雖然使用了FragmentStatePagerAdapter
,但是由于我們在DemoActivity
中用一個列表保存了所有的Fragment
實例,因此它沒有被回收,如果希望讓頁面被移除的時候,其對應的Fragment
實例也被回收,那么我們的FragmentStatePagerAdapter
的子類應該寫成這樣:
private void initFSPAFragments() {
ViewPager viewPager = (ViewPager) findViewById(R.id.vp_content);
mFSPAdapter = new FSPAdapter(getSupportFragmentManager());
viewPager.setAdapter(mFSPAdapter);
}
private class FSPAdapter extends FragmentStatePagerAdapter {
public FSPAdapter(FragmentManager fm) {
super(fm);
}
@Override
public Fragment getItem(int position) {
Log.d("LogcatFragment", "get Item from FSPAdapter, position=" + position);
return LogcatFragment.newInstance("index=" + position);
}
@Override
public int getCount() {
return INCREASE;
}
}