Android——FragmentPagerAdapter與FragmentStatePagerAdapter區別

小欣兒發表於2018-07-04

在一個 Android 應用中,我們使用 FragmentPagerAdapter 來處理多 Fragment 頁面的橫向滑動。不過我碰到了一個問題,即當 Fragment 對應的資料集發生改變時,我希望能夠通過呼叫 mAdapter.notifyDataSetChanged() 來觸發 Fragment 頁面使用新的資料調整或重新生成其內容,可是當我呼叫 notifyDataSetChanged() 後,發現什麼都沒發生。

搜尋之後發現不止我一個人碰到這個問題,大家給出的解決辦法五花八門,有些確實解決了問題,但是我總感覺問題沒搞清楚。於是我決定搞明白這個問題到底是怎麼回事,以及正確的用法到底如何。要搞明白這個問題,僅僅閱讀文件並不足夠,還需要閱讀相關幾個類的相關方法的實現,搞懂其設計意圖。下面就是通過閱讀原始碼搞明白的內容。

【ViewPager】

ViewPager 如其名所述,是負責翻頁的一個 View。準確說是一個 ViewGroup,包含多個 View 頁,在手指橫向滑動螢幕時,其負責對 View 進行切換。為了生成這些 View 頁,需要提供一個 PagerAdapter 來進行和資料繫結以及生成最終的 View 頁。

  • setAdapter()
    ViewPager 通過 setAdapter() 來建立與 PagerAdapter 的聯絡。這個聯絡是雙向的,一方面,ViewPager 會擁有 PagerAdapter 物件,從而可以在需要時呼叫 PagerAdapter 的方法;另一方面,ViewPager 會在 setAdapter() 中呼叫 PagerAdapter 的 registerDataSetObserver() 方法,註冊一個自己生成的 PagerObserver 物件,從而在 PagerAdapter 有所需要時(如 notifyDataSetChanged()或 notifyDataSetInvalidated() 時),可以呼叫 Observer 的 onChanged() 或 onInvalidated() 方法,從而實現 PagerAdapter 向 ViewPager 方向傳送資訊。

  • dataSetChanged()
    在 PagerObserver.onChanged(),以及 PagerObserver.onInvalide() 中被呼叫。因此當 PagerAdapter.notifyDataSetChanged() 被觸發時,ViewPager.dataSetChanged() 也可以被觸發。該函式將使用 getItemPosition() 的返回值來進行判斷,如果為 POSITION_UNCHANGED,則什麼都不做;如果為 POSITION_NONE,則呼叫 PagerAdapter.destroyItem() 來去掉該物件,並設定為需要重新整理 (needPopulate = true) 以便觸發PagerAdapter.instantiateItem() 來生成新的物件。

【PagerAdapter】

PageAdapter 是 ViewPager 的支持者,ViewPager 將呼叫它來取得所需顯示的頁,而 PageAdapter 也會在資料變化時,通知 ViewPager。這個類也是FragmentPagerAdapter 以及 FragmentStatePagerAdapter 的基類。如果繼承自該類,至少需要實現 instantiateItem(), destroyItem(), getCount() 以及 isViewFromObject()。

  • getItemPosition()
    該函式用以返回給定物件的位置,給定物件是由 instantiateItem() 的返回值。
    在 ViewPager.dataSetChanged() 中將對該函式的返回值進行判斷,以決定是否最終觸發 PagerAdapter.instantiateItem() 函式。
    在 PagerAdapter 中的實現是直接傳回 POSITION_UNCHANGED。如果該函式不被過載,則會一直返回 POSITION_UNCHANGED,從而導致 ViewPager.dataSetChanged() 被呼叫時,認為不必觸發 PagerAdapter.instantiateItem()。很多人因為沒有過載該函式,而導致呼叫
    PagerAdapter.notifyDataSetChanged() 後,什麼都沒有發生。

  • instantiateItem()
    在每次 ViewPager 需要一個用以顯示的 Object 的時候,該函式都會被 ViewPager.addNewItem() 呼叫。

  • notifyDataSetChanged()
    在資料集發生變化的時候,一般 Activity 會呼叫 PagerAdapter.notifyDataSetChanged(),以通知 PagerAdapter,而 PagerAdapter 則會通知在自己這裡註冊過的所有 DataSetObserver。其中之一就是在 ViewPager.setAdapter() 中註冊過的 PageObserver。PageObserver 則進而呼叫 ViewPager.dataSetChanged(),從而導致 ViewPager 開始觸發更新其內含 View 的操作。

【FragmentPagerAdapter】

FragmentPagerAdapter 繼承自 PagerAdapter。相比通用的 PagerAdapter,該類更專注於每一頁均為 Fragment 的情況。如文件所述,該類內的每一個生成的 Fragment 都將儲存在記憶體之中,因此適用於那些相對靜態的頁,不請求網路,數量也比較少的那種;如果需要處理有很多頁,並且資料動態性較大、佔用記憶體較多的情況,應該使用FragmentStatePagerAdapter。FragmentPagerAdapter 過載實現了幾個必須的函式,因此來自 PagerAdapter 的函式,我們只需要實現 getCount(),即可。且,由於 FragmentPagerAdapter.instantiateItem() 的實現中,呼叫了一個新增的虛擬函式 getItem(),因此,我們還至少需要實現一個 getItem()。因此,總體上來說,相對於繼承自 PagerAdapter,更方便一些。

  • getItem()
    該類中新增的一個虛擬函式。函式的目的為生成新的 Fragment 物件。過載該函式時需要注意這一點。在需要時,該函式將被 instantiateItem() 所呼叫。
    如果需要向 Fragment 物件傳遞相對靜態的資料時,我們一般通過 Fragment.setArguments() 來進行,這部分程式碼應當放到 getItem()。它們只會在新生成 Fragment 物件時執行一遍。
    如果需要在生成 Fragment 物件後,將資料集裡面一些動態的資料傳遞給該 Fragment,那麼,這部分程式碼不適合放到 getItem() 中。因為當資料集發生變化時,往往對應的 Fragment 已經生成,如果傳遞資料部分程式碼放到了 getItem() 中,這部分程式碼將不會被呼叫。這也是為什麼很多人發現呼叫 PagerAdapter.notifyDataSetChanged() 後,getItem() 沒有被呼叫的一個原因。

  • instantiateItem()
    函式中判斷一下要生成的 Fragment 是否已經生成過了,如果生成過了,就使用舊的,舊的將被 Fragment.attach();如果沒有,就呼叫 getItem() 生成一個新的,新的物件將被 FragmentTransation.add()。
    FragmentPagerAdapter 會將所有生成的 Fragment 物件通過 FragmentManager 儲存起來備用,以後需要該 Fragment 時,都會從 FragmentManager 讀取,而不會再次呼叫 getItem() 方法。
    如果需要在生成 Fragment 物件後,將資料集中的一些資料傳遞給該 Fragment,這部分程式碼應該放到這個函式的過載裡。在我們繼承的子類中,過載該函式,並呼叫 FragmentPagerAdapter.instantiateItem() 取得該函式返回 Fragment 物件,然後,我們該 Fragment 物件中對應的方法,將資料傳遞過去,然後返回該物件。
    否則,如果將這部分傳遞資料的程式碼放到 getItem()中,在 PagerAdapter.notifyDataSetChanged() 後,這部分資料設定程式碼將不會被呼叫。

  • destroyItem()
    該函式被呼叫後,會對 Fragment 進行 FragmentTransaction.detach()。這裡不是 remove(),只是 detach(),因此 Fragment 還在 FragmentManager 管理中,Fragment 所佔用的資源不會被釋放。

【FragmentStatePagerAdapter】

FragmentStatePagerAdapter 和前面的 FragmentPagerAdapter 一樣,是繼承子 PagerAdapter。但是,和 FragmentPagerAdapter 不一樣的是,正如其類名中的 ‘State’ 所表明的含義一樣,該 PagerAdapter 的實現將只保留當前頁面,當頁面離開視線後,就會被消除,釋放其資源;而在頁面需要顯示時,生成新的頁面(就像 ListView 的實現一樣)。這麼實現的好處就是當擁有大量的頁面時,不必在記憶體中佔用大量的記憶體。總之呢他們倆都不適合一般app的主頁,因為主頁tab切換要求保持各Fragment生命週期只會在執行一次,而它們兩的Fragment生命週期在ViewPage的切換過程中都會重複執行多次。

  • getItem()
    一個該類中新增的虛擬函式。
    函式的目的為生成新的 Fragment 物件。
    Fragment.setArguments() 這種只會在新建 Fragment 時執行一次的引數傳遞程式碼,可以放在這裡。
    由於 FragmentStatePagerAdapter.instantiateItem() 在大多數情況下,都將呼叫 getItem() 來生成新的物件,因此如果在該函式中放置與資料集相關的 setter 程式碼,基本上都可以在 instantiateItem() 被呼叫時執行,但這和設計意圖不符。畢竟還有部分可能是不會呼叫 getItem() 的。因此這部分程式碼應該放到 instantiateItem() 中。

  • instantiateItem()
    除非碰到 FragmentManager 剛好從 SavedState 中恢復了對應的 Fragment 的情況外,該函式將會呼叫 getItem() 函式,生成新的 Fragment 物件。新的物件將被 FragmentTransaction.add()。
    FragmentStatePagerAdapter 就是通過這種方式,每次都建立一個新的 Fragment,而在不用後就立刻釋放其資源,來達到節省記憶體佔用的目的的。

  • destroyItem()
    將 Fragment 移除,即呼叫 FragmentTransaction.remove(),並釋放其資源。

討論

之前看到一些解決辦法,有的認為這是一個 bug,應該被修復;有的建議不用 FragmentPagerAdapter,而改用 FragmentStatePagerAdapter,並且過載 getItemPosition() 並返回 POSITION_NONE,以觸發銷燬物件以及重建物件。從上面的分析中看,後者給出的建議確實可以達到呼叫 notifyDataSetChanged() 後,Fragment 被以新的引數重新建立的效果。

但是問題在於,如果我們只能這麼解決這個問題,豈不是 FragmentPagerAdapter 就用不上了?最關鍵的是,二者對應的情況不同。對於頁面相對較少的情況,我仍舊希望能夠將生成的 Fragment 儲存在記憶體中,在需要顯示的時候直接呼叫,而不要產生生成、銷燬物件的額外的開銷,這樣效率更高。這種情況下,選擇 FragmentPagerAdapter 是更適合,不加考慮的選擇 FragmentStatePagerAdapter 是不合適的。我們不能夠因噎廢食。

因此,對於 FragmentPagerAdapter 的解決方案就是,分別過載 getItem() 以及 instantiateItem() 物件。getItem() 只用於生成新的與資料無關的 Fragment;而 instantiateItem() 函式則先呼叫父類中的 instantiateItem() 取得所對應的 Fragment 物件,然後,根據對應的資料,呼叫該物件對應的方法進行資料設定。

當然,不要忘記過載 getItemPosition() 函式,返回 POSITION_NONE,這個兩個類的解決方案都需要的。二者不同之處在於,FragmentStatePagerAdapter 在會在因 POSITION_NONE 觸發呼叫的 destroyItem() 中真正的釋放資源,重新建立一個新的 Fragment;而 FragmentPagerAdapter 僅僅會在 destroyItem() 中 detach 這個 Fragment,在 instantiateItem() 時會使用舊的 Fragment,並觸發 attach,因此沒有釋放資源及重建的過程。

這樣,當 notifyDataSetChanged() 被呼叫後,會最終觸發 instantiateItem(),而不管 getItem() 是否被呼叫,我們都在過載的 instantiateItem() 函式中已經將所需要的資料傳遞給了相應的 Fragment。在 Fragment 接下來的 onCreateView(), onStart() 以及 onResume() 的事件中,它可以正確的讀取新的資料,Fragment 被成功複用了。

這裡需要注意一個問題,在 Fragment 沒有被新增到 FragmentManager 之前,我們可以通過 Fragment.setArguments() 來設定引數,並在 Fragment 中,使用 getArguments() 來取得引數。這是常用的引數傳遞方式。但是這種方式對於我們說的情況不適用。因為這種資料傳遞方式只可能用一次,在 Fragment 被新增到 FragmentManager 後,一旦被使用,我們再次呼叫 setArguments() 將會導致 java.lang.IllegalStateException: Fragment already active 異常。因此,我們這裡的引數傳遞方式選擇是,在繼承的 Fragment 子類中,新增幾個 setter,然後通過這些 setter 將資料傳遞過去。反向也是類似。相關資訊可以參考 [5]。哦,這些 setter 中要注意不要操作那些 View,這些 View 只有在 onCreateView() 事件後才可以操作。

針對 FragmentPagerAdapter 的解決辦法如下列程式碼所示:

[mw_shl_code=java,true]@Override
public Fragment getItem(int position) {
     MyFragment f = new MyFragment();
     return f;
}

@Override
public Object instantiateItem(ViewGroup container, int position) {
     MyFragment f = (MyFragment) super.instantiateItem(container, position);
     String title = mList.get(position);
     f.setTitle(title);
     return f;
}

@Override
public int getItemPosition(Object object) {
     return PagerAdapter.POSITION_NONE;
}

原文連結:FragmentPagerAdapter與FragmentStatePagerAdapter區別

相關文章