- 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() 來生成新的對象。
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 的操作。
- 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 所佔用的資源不會被釋放。
- 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(),並釋放其資源。
1 @Override 2 public Fragment getItem(int position) { 3 MyFragment f = new MyFragment(); 4 return f; 5 } 6 7 @Override 8 public Object instantiateItem(ViewGroup container, int position) { 9 MyFragment f = (MyFragment) super.instantiateItem(container, position); 10 String title = mList.get(position); 11 f.setTitle(title); 12 return f; 13 } 14 15 @Override 16 public int getItemPosition(Object object) { 17 return PagerAdapter.POSITION_NONE; 18 }