Fragment那點事⑤保存與恢復實踐

文章里所有分析都是根據Android Sdk 25.3.1 v4包

經過前面的分析之后現在有這么一個需求:

  1. APP 總共 3 個 Tab,首頁(HomePageFragment),分類(CategoryFragment),我的(MineFragment)這 3 個 Tab 為第一級。
  2. TopicListFragment 根據穿件來不同的 tab 字段可以分別加載首頁、分類(熱門,精華,分享,招聘)頁面的帖子列表。
  3. 要實現 Activity 被重建的時候所有帖子列表頁面維持不變,不重新加載新的數據、帖子列表懶加載。
  4. Activity 重建用屏幕旋轉來模擬。

效果圖

通過分析可以發現,最外層分別為 首頁,分類,我的 3 個 Fragment。在首頁嵌套一個 TopicListFragment 到 HomePageFragment 里去,在分類頁面嵌套一個 ViewPager,ViewPager 的每一頁都是 TopicListFragment。

MainActivity

根據之前分析的 onSaveInstanceState 在該方法中保存 currPosition 當前可見的 Tab id。

@Override
public void onSaveInstanceState(Bundle outState) {
  super.onSaveInstanceState(outState);
  outState.putInt("currPosition", mCurrPosition);
}

MainActivity.onCreate() 方法中做如下處理,判斷 savedInstanceState == null

  • 如果為真,說明沒有發生重啟,直接初始化 3 個Fragment 實例并 add 進 Activity 中。
  • 如果為假,說明 FragmentActivity 已經幫我們做好了 Fragment 的保存與恢復工作,不用再重復的去添加新的實例到 FragmentManager,直接去 FragmentManager 中去獲取這 3 個 Fragment 的實例(在外部獲取實例在切換 tab 的時候需要)。
@Override
public void initView(Bundle savedInstanceState) {
  
  if (savedInstanceState == null) {
    mFragments = new BaseFragment[3];
    mFragments[0] = HomePageFragment.newInstance();
    mFragments[1] = CategoryFragment.newInstance();
    mFragments[2] = MineFragment.newInstance();
    FragmentUtils.addMultiple(getSupportFragmentManager(), R.id.content, mCurrPosition, mFragments);
  } else {
    mCurrPosition = savedInstanceState.getInt("currPosition");
    mFragments[0] = findFragment(HomePageFragment.class);
    mFragments[1] = findFragment(CategoryFragment.class);
    mFragments[2] = findFragment(MineFragment.class);

    if (mCurrPosition != 0) {
      updateNavigationBarState(mCurrPosition);
    }
  }
}

下面是 FragmentUtils.addMultiPle() 方法,添加多個 Fragment 到 content 并設置顯示和隱藏。并調用 Fragment.setUserVisibleHint 更新 mUserVisibleHint 屬性,在 Fragment 中默認該屬性為 true。

public static void addMultiple(FragmentManager manager, int containerId, int showPosition, BaseFragment... fragments) {
  FragmentTransaction transaction = manager.beginTransaction();
  for (int i = 0; i < fragments.length; i++) {
    String tag = fragments[i].getClass().getName();
    transaction.add(containerId, fragments[i], tag);
    if (showPosition != i) {
      transaction.hide(fragments[i]);
    }
    fragments[i].setUserVisibleHint(!fragments[i].isHidden());
  }
  transaction.commit();
}

下面是 FragmentUtils.FindFragment() 方法,根據添加 Fragment 的時候設置的 Tag,可以獲取 Fragment。

public static <T extends BaseFragment> T findFragment(FragmentManager manager, Class<T> tClass) {
  if (manager.getFragments() == null) {
    return null;
  }
  return (T) manager.findFragmentByTag(tClass.getName());
}

切換 tab 的時候 show 要顯示的 Fragment,其余 Fragment 被 hide,因為 show 和 hide 并不會改變 mUserVisibleHint 所以要手動調用 setUserVisibleHint() 。

public static void showHideFragment(FragmentManager manager, Fragment show, Fragment hide, boolean animation, boolean backStack) {
  FragmentTransaction transaction = manager.beginTransaction();
  if (animation) {
    transaction.setCustomAnimations(
      R.anim.fragment_translate_in, R.anim.fragment_translate_out
      ,R.anim.fragment_pop_in,R.anim.fragment_pop_out);
  }
  transaction.show(show);
  if (hide == null) {
    List<Fragment> fragments = manager.getFragments();
    if (fragments != null) {
      for (Fragment fragment : fragments) {
        if (fragment != show) {
          transaction.hide(fragment);
        }
      }
    }
  } else {
    transaction.hide(hide);
  }
  if (backStack) {
    transaction.addToBackStack("showHideFragment");
  }
  transaction.commit();
}

HomePageFragment

在 HomePageFragment.onViewCreated() 方法中的處理和 MainActivity.onCreate() 方法中相似。這個時候 ChildFragmentManager 已經恢復完畢,調用 findFragmentByTag 查看是否包含 TopicListFragment,如果不包含就重新實例化添加。

@Override
public void initView(View root) {
  if (getChildFragmentManager().findFragmentByTag(TopicListFragment.class.getName()) == null) {
    TopicListFragment fragment = TopicListFragment.instance(null);
    fragment.setUserVisibleHint(true);
    FragmentUtils.replace(getChildFragmentManager(), R.id.home_page_content, fragment, false, TopicListFragment.class.getName());
  }
}

TopicListFragment

在 onCreate() 方法中設置 setRetainInstance(true) 由之前的分析可知,當 Activity 發生重啟后,該 Fragment 實例會被保存下來,已經獲取的帖子數據也不用重新請求,直接通過 RecyclerView 的自我恢復重新填充。

@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  setRetainInstance(true);
}

CategoryFragment

在 CategoryFragment 中的布局是一個 ViewPager,在 ViewPager 中實現了 View.onSaveInstanceState() 這個方法,在之前介紹 Fragment 保存與恢復中(Fragment 保存內部 View 狀態的流程)講過,部分 View 實現了該方法,可以自行保存狀態。那就看看 ViewPager 保存了什么東西

@Override
public Parcelable onSaveInstanceState() {
  Parcelable superState = super.onSaveInstanceState();
  SavedState ss = new SavedState(superState);
  ss.position = mCurItem;
  if (mAdapter != null) {
    ss.adapterState = mAdapter.saveState();
  }
  return ss;
}

通過分析可知,保存了當前頁面的 position 并調用 mAdapter.saveState() 方法保存 mAdapter 的狀態(FragmentPagerAdapter 并沒有保存任何東西返回 null)。

FragmentPagerAdapter

@Override
public Object instantiateItem(ViewGroup container, int position) {
  if (mCurTransaction == null) {
    mCurTransaction = mFragmentManager.beginTransaction();
  }
  final long itemId = getItemId(position);
  
  // Do we already have this fragment?
  String name = makeFragmentName(container.getId(), itemId);
  Fragment fragment = mFragmentManager.findFragmentByTag(name);
  if (fragment != null) {
    if (DEBUG) Log.v(TAG, "Attaching item #" + itemId + ": f=" + fragment);
    mCurTransaction.attach(fragment);
  } else {
    fragment = getItem(position);
    if (DEBUG) Log.v(TAG, "Adding item #" + itemId + ": f=" + fragment);
    mCurTransaction.add(container.getId(), fragment,
                        makeFragmentName(container.getId(), itemId));
  }
  if (fragment != mCurrentPrimaryItem) {
    fragment.setMenuVisibility(false);
    fragment.setUserVisibleHint(false);
  }
  return fragment;
}

由上面 instantiateItem 方法可知,PagerAdapter 是靠宿主的 FragmentManager 來管理 Fragment 的,即所有的 Fragment 都被托管在 CategoryFragment 的 ChildFragmentManager 中,當 findFragmentByTag 不為空時就直接使用該 fragment 實例,反之調用 getItem(position) 實例化一個新的 Fragment。

本文中使用的案例源碼地址

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容