Android Fragment 详解（未完...）
版权声明：本文为博主原创文章，未经博主允许不得转载。
微博：厉圣杰
源码：AndroidDemo/Fragment
文中如有纰漏，欢迎大家留言指出。
之前写过一篇关于 Fragment 生命周期的文章，针对 Fragment 各种情况下的生命周期进行了讨论，这段时间对 Fragment 的使用次数逐渐增加，对 Fragment 也有一定的了解，写此文以做总结。本文中使用 support library v4 包中的 Fragment。
本文大致会从以下几个方面对 Fragment 进行总结，如有不当之处，欢迎指出~
Fragment 简介
Fragment 是在 Android 3.0 中引入，主要用于在大屏设备（如平板电脑）上支持更多动态和灵活的 UI 设计。 因为平板的屏幕比手机屏幕大得多，所以有更多的空间放更多的 UI 控件，也会产生更多的交互。Fragment 可以将 Activity 中的 UI 划分到自身，以实现在多个 Activity 中重用。
下图来自 Android 官方文档，很好的说明了 Fragment 的设计理念：
当在平板电脑上运行时，App 可以在 Activity A 中嵌入 2 个 Fragment。当用户在 Fragment A 中选中某个 Item 时就可以直接在 Fragment B 中展示内容。而在手机等小屏幕设备上，由于没有足够的空间，Activity A 只能展示 Fragment A，并且只能通过启动 Activity B 才能展示选中 Item 的内容。
Fragment 有自己的布局，有自己的生命周期，有自己的响应事件。但 Fragment 又依赖于 Activity 的存在，你可以把多个 Fragment 嵌入到一个 Activity 中或者多个 Activity 重用一个 Fragment。Activity 的生命周期直接影响 Fragment 的生命周期。在 Activity 运行过程中，可以添加、移除或者替换Fragment。
Fragment 使用比较多的直接子类有：
DialogFragment:一种特殊的 Fragment ，可以创建类似 Dialog 的对话框。
因为是 Fragment ，所以可以管理其生命周期。官方推荐使用。
ListFragment:类似于 ListActivity
PreferenceFragment:类似于 PreferenceActivity
关于 Fragment 子类的使用方式本文不在赘述，有兴趣的可以自行上网搜索~
Fragment 的创建
Fragment 可以通过 XML 静态添加，也可以通过代码动态添加，而动态添加又可以分为通过 new 一个Fragment 和通过 newInstance() 生成一个 Fragment 实例。
静态添加Fragment
首先，我们创建一个布局文件 fragment_test.xml:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<TextView
android:id="@+id/tv_content"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:gravity="center"
android:text="This is a Fragment"
android:textSize="20sp" />
</LinearLayout>
然后创建 TestFragment，该类继承作者自己封装的 BaseFragment ，与系统自带的 Fragment 有些许差异，但不影响理解
public class TestFragment extends BaseFragment {
@BindView(R.id.tv_content)
TextView mTvContent;
private String mTitle;
private int mBgColor;
public static TestFragment newInstance(String title, int bgColor) {
Bundle args = new Bundle();
TestFragment fragment = new TestFragment();
args.putString(Constant.EXTRA_TITLE, title);
args.putInt(Constant.EXTRA_COLOR, bgColor);
fragment.setArguments(args);
return fragment;
}
@Override
protected int getPageLayoutID() {
return R.layout.fragment_test;
}
@Override
protected void initData() {
if (getArguments() == null) {
return;
}
mTitle = getArguments().getString(Constant.EXTRA_TITLE);
mBgColor = getArguments().getInt(Constant.EXTRA_COLOR);
}
@Override
protected void initView(View view, Bundle savedInstanceState) {
if (!TextUtils.isEmpty(mTitle)) {
mTvContent.setText(mTitle);
}
mTvContent.setBackgroundColor(mBgColor);
}
@Override
protected void initViewListener() {}
@Override
protected void process(Bundle savedInstanceState) {}
}
接下去，在 Activity 的布局文件中添加 TestFragment 即可，使用方法与普通控件相似。
activity_static_create.xml:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/activity_static_create"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context="com.littlejie.demo.modules.base.fragment.create.StaticCreateActivity">
<!-- name 属性用于指定使用哪个 Fragment -->
<fragment
android:name="com.littlejie.demo.modules.base.fragment.create.TestFragment"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</LinearLayout>
Activity 布局相对简单，这里就不再展示代码。运行效果如下：
动态添加 Fragment
现在我们已经学会了如何在 XML 中静态添加 Fragment，但这只是最基础的使用。Fragment 的强大之处在于其可以动态的添加到 Activity 当中。
这里我们依旧使用上一节中 TestFragment 的代码，这也是 Fragment 复用性的体现。
主界面由两个 Button 和一个 FrameLayout 组成。
activity_dynamic_create.xml:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/activity_dynamic_create"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
tools:context="com.littlejie.demo.modules.base.fragment.create.DynamicCreateActivity">
<Button
android:id="@+id/btn_show_fragment1"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="显示Fragment1" />
<Button
android:id="@+id/btn_show_fragment2"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="显示Fragment2" />
<FrameLayout
android:id="@+id/fragment_container"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</LinearLayout>
DynamicCreateActivity 继承自作者封装的 BaseActivity，代码如下：
public class DynamicCreateActivity extends BaseActivity {
@Override
protected int getPageLayoutID() {
return R.layout.activity_dynamic_create;
}
@Override
protected void initData() {}
@Override
protected void initView() {}
@Override
protected void initViewListener() {}
@Override
protected void process() {}
@OnClick(R.id.btn_show_fragment1)
public void showFragment1() {
showFragment(TestFragment.newInstance("This is Fragment1", Color.YELLOW));
}
@OnClick(R.id.btn_show_fragment2)
public void showFragment2() {
showFragment(TestFragment.newInstance("This is Fragment2", Color.CYAN));
}
private void showFragment(Fragment fragment) {
FragmentManager fragmentManager = getSupportFragmentManager();
FragmentTransaction transaction = fragmentManager.beginTransaction();
transaction.replace(R.id.fragment_container, fragment);
transaction.commit();
}
}
程序运行效果如图：
动态添加 Fragment 的主要逻辑集中在 showFragment() 中，该过程可以分解为以下几步：
1. 获取 FragmentManager ，在 V4 包中通过 `getSupportFragmentManager()`，在系统中原生的 Fragment 是通过 `getFragmentManager()` 获得的。
2. 调用 `beginTransaction()` 开启事务
3. 向 FrameLatout 添加 Fragment，一般使用 add() 或者replace() 方法实现，需要传入容器的 id 和 Fragment 的实例
4. 调用 `commit()` 方法提交事务
通过上述例子，你是不是对 Fragment 的使用有了初步的了解呢？
补充：new Fragment 与 newInstance() 的区别
当系统内存不足时，Fragment 可能会被销毁，当其再次实例化时，系统只会调用 Fragment 的无参构造函数，一些需要外部传入的参数的初始化过程就无法完成。而通过 newInstance() 方式就可以将外部传入的在 Fragment 内部，在 Fragment 调用 onCreate() 时将其取出初始化。
public static Fragment instantiate(Context context, String fname, @Nullable Bundle args) {
try {
Class<?> clazz = sClassMap.get(fname);
if (clazz == null) {
// Class not found in the cache, see if it's real, and try to add it
clazz = context.getClassLoader().loadClass(fname);
sClassMap.put(fname, clazz);
}
Fragment f = (Fragment)clazz.newInstance();
if (args != null) {
args.setClassLoader(f.getClass().getClassLoader());
f.mArguments = args;
}
return f;
} catch (ClassNotFoundException e) {
throw new InstantiationException("Unable to instantiate fragment " + fname
+ ": make sure class name exists, is public, and has an"
+ " empty constructor that is public", e);
} catch (java.lang.InstantiationException e) {
throw new InstantiationException("Unable to instantiate fragment " + fname
+ ": make sure class name exists, is public, and has an"
+ " empty constructor that is public", e);
} catch (IllegalAccessException e) {
throw new InstantiationException("Unable to instantiate fragment " + fname
+ ": make sure class name exists, is public, and has an"
+ " empty constructor that is public", e);
}
}
Fragment 中的重要方法
上一节我们学习了 Fragment 的创建方式，算是对 Fragment 的使用有了初步了解，也使用了 Fragment 中的一些方法，但仅仅这样是不够的。下面，我们来系统的学习下 Fragment 使用中常见的方法。
FragmentManager
FragmentManager 用于管理 Fragment，可以通过 getSupportFragmentManager() 和 getChildFragmentManager() 获取，但两者之间是有差异的。
/**
* 管理 Activity 中的 Fragment，对于 support library v4 包下的 Fragment。
* 类似的有 getFragmentManager() ，不过该方法只支持 Android 3.0 以上。
*/
void getSupportFragmentManager()
/**
* 管理 Fragment 内嵌的 Fragment，要与前者区别开，否则会造成很郁闷的问题。如：add()、replace()、getBackStackEntryCount() 操作的结果会与预期不一致。
*/
void getChildFragmentManager();
FragmentManager 使用频率比较高的有以下方法：
/**
* 开启事务，用于 Fragment 的处理
*/
FragmentTransaction beginTransaction();
/**
* 将 Fragment 从回退栈中弹出，需要与 addToBackStack() 配合使用
* 若回退栈不为空，按返回键时默认弹出回退栈顶端的 Fragment
*/
void popBackStack();
/**
* 针对第一个参数，如果 name 为 null，那么只有顶部的状态被弹出；
* 如果 name 不为 null，并且找到了这个 name 所指向的 Fragment 对象；
* 根据 flags 的值，如果是 flag = 0 ，那么将会弹出该状态以上的所有状态；
* 如果 flag = POP_BACK_STACK_INCLUSIVE ，那么将会弹出该状态（包括该状态）以上的所有状态。
*/
void popBackStack(String name, int flags);
/**
* 针对第一个参数，如果该 id 找不到，那么什么都不做；
* 否则根据 flags 的值，如果是 flag = 0 ，那么将会弹出该状态以上的所有状态；
* 如果 flag = POP_BACK_STACK_INCLUSIVE ，那么将会弹出该状态（包括该状态）以上的所有状态。
*/
void popBackStack(int id, int flags);
/**
* 和 popBackStack(int id, int flags) 类似，不同的是这个事立马弹出，和 executePendingTransactions() 方法之后的效果一样。
* 如果有东西弹出，返回为 true ；否则就是 false 。
*/
boolean popBackStackImmediate();
/**
* 获取回退栈中 Fragment 的个数
*/
int getBackStackEntryCount();
/**
* 根据序号返回后台堆栈中的BackStackEntry对象，最底的序号为0。
*/
FragmentManager.BackStackEntry getBackStackEntryAt(int index);
/**
* 通过 tag 查找 Fragment,这个 tag 可以是 XML 中的，也可以是通过事务动态添加的
*/
Fragment findFragmentByTag(String tag);
/**
* 通过 id 查找 Fragment，这个 id 可以是 XML 中的，也可以是通过事务动态添加的
*/
Fragment findFragmentById(int id);
/**
* 抽象方法，为 Fragment 的回退栈添加一个监听器，用于监听堆栈的改变情况。
*/
public abstract void addOnBackStackChangedListener(OnBackStackChangedListener listener);
/**
* 抽象方法，移除回退栈的监听器
*/
public abstract void removeOnBackStackChangedListener(OnBackStackChangedListener listener);
FragmentTransaction
boolean add():将一个 Fragment 实例添加到最顶端
/**
* 将 Fragment 添加到回退栈，
*/
addToBackStack():
replace():
show():
hide():
commit():
Fragment
以下方法主要用于判断 Fragment 的状态，如可见性等，后续会详细讲解。
/**
* 获取当前 Fragment 的父 Fragment。
* 如果该 Fragment 是直接添加在 Activity 上，那么返回 null
*/
Fragment getParentFragment();
/**
* 如 TestFragment 中，该方法主要为 Fragment 提供一些初始化数据
* 数据以 Bundle 形式封装传递。
*/
void setArguments(Bundle args);
/**
* 获取传递给 Fragment 的参数
*/
Bundle getArguments();
/**
* 判断 Fragment 是否已经添加到 Activity 上
*/
boolean isAdded();
/**
*
*/
boolean isHidden();
void onHiddenChanged();
boolean isVisible();
void setVisibleToUser();
boolean getUserVisibleHint();
Fragment 的生命周期
现在，我们对 Fragment 的使用已经有了详尽的认识。但是，有句古话说的好：工欲善其事，必先利其器。要对 Fragment 有透彻的认识，还得掌握它的生命周期。
阎王叫你五更死，你活不到三更
简单来说，Fragment 的生命周期可以用下图来表示：
是不是觉得这图看着很眼熟，没错，前面讲过 Fragment 是依赖于 Activity 存在的，所以 Fragment 的生命周期跟 Activity 的生命周期很相似。
下图很好的描述了 Fragment 与 Activity 生命周期的关系，请看图~
Fragment 的生命周期这样就讲完了？理论上来说，是的。但是，我还有话要讲~
上面只是展示了 Fragment 与 Activity 生命周期最基本的关系，如果通过 addToBackStack() 将 Fragment 放入回退栈，然后通过 popBackStack() 出栈，Fragment 的生命周期会如何变化呢？如果 Fragment 与 ViewPager 结合使用，Fragment 的生命周期又是如何？如果通过 hide() 和 show() 方法来展示隐藏，这时 Fragment 的生命周期又会如何？
不急，先看思维导图中的问题，然后咱们就来研究一下上诉问题~
既然是 Fragment 的生命周期，那自然是少不了对 Fragment 生命周期的监测，怎么办？打 Log。
项目结构如下
本文涉及到的类主要集中在 life 包中。代码已上传 AndroidDemo/Fragment ，这里贴出 LifeFragment 的主要代码。
LifeFragment.java
/**
* 测试 Fragment 生命周期，setUserVisibleHint 初始进来时只有默认 Tab
* Created by littlejie on 2016/12/30.
*/
public class LifeFragment extends BaseFragment {
private final String TAG = LifeFragment.class.getSimpleName();
//截取 Fragment.toString() 方法中的标识数字
private final String ID = this.toString().substring(this.toString().indexOf("{") + 1, this.toString().length() - 1);
private TextView mTvContent;
//默认 Title 值
private String mTitle = "Tab";
public static LifeFragment newInstance(String title) {
Bundle args = new Bundle();
LifeFragment fragment = new LifeFragment();
args.putString(Constant.PARAM_TITLE, title);
fragment.setArguments(args);
return fragment;
}
/**
* 当 Fragment 调用 hide() 、 show() 时回调
* @param hidden
*/
@Override
public void onHiddenChanged(boolean hidden) {
Log.i(TAG, "Fragment id = " + ID + "," + mTitle + " is onHiddenChanged.hidden = " + hidden);
super.onHiddenChanged(hidden);
}
/**
* 当 Fragment 与 ViewPager 结合使用时，切换 Pager 时回调
* @param isVisibleToUser
*/
@Override
public void setUserVisibleHint(boolean isVisibleToUser) {
Log.i(TAG, "Fragment id = " + ID + "," + mTitle + " is setUserVisibleHint.isVisibleToUser = " + isVisibleToUser);
super.setUserVisibleHint(isVisibleToUser);
}
/**
* Fragment 关联到 Activity 时回调
* 此时 Activity 已经与 Fragment 关联，通过 Context 向下转型，就可以与 Activity 通信
* 当然也可以使用 getActivity(),前提是这个 fragment 已经和宿主的 activity 关联，并且没有脱离
* onAttach 只调用一次。
*
* @param context
*/
@Override
public void onAttach(Context context) {
//由于 onCreate 是在 onAttach 后执行，故此时 mTitle 为空
Log.i(TAG, "Fragment id = " + ID + "," + mTitle + " is onAttach.");
super.onAttach(context);
}
/**
* 系统创建 Fragment 的时候回调，介于 onAttach() 和 onCreateView() 之间
* 一般用于初始化一些数据
* 值得注意的是，此时 Activity 还在创建中，因此不能在执行一些跟 Activity UI 相关的操作
* 否则，会出现一些难以预料的问题，比如：NullPointException
* 如果要对 Activity 上的 UI 进行操作，建议在 onActivityCreated() 中操作
*
* @param savedInstanceState
*/
@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
Log.i(TAG, "Fragment id = " + ID + "," + mTitle + " is onCreate.");
super.onCreate(savedInstanceState);
setHasOptionsMenu(true);
if (getArguments() != null) {
mTitle = getArguments().getString(Constant.PARAM_TITLE);
}
//测试 onCreate() 是 Activity 的 UI 是否初始化完成
//if (getContext() instanceof LifeCircleActivity) {
//((LifeActivity) getContext()).setActivityCreated("Fragment 进行 onCreate() 时 Activity UI 尚未初始化完成。"
// + "\n你看不到我，因为我已经变成异常抛出了。");
//}
}
/**
* 创建 Fragment 需要显示的 View，默认返回 null。
* 当返回的 View 不为 null 时，View 被销毁时会调用 onDestroyView()
* 此处应该只进行布局的初始化，而不应该执行耗时操作，如网络请求、数据库读取
*
* @param inflater
* @param container
* @param savedInstanceState
* @return
*/
@Nullable
@Override
public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
Log.i(TAG, "Fragment id = " + ID + "," + mTitle + " is onCreateView.");
return inflater.inflate(R.layout.fragment_life_circle, container, false);
}
/**
* 该方法在 onCreateView() 之后会被立即执行
* 此时可以对 View 对象进行赋值，当然在 onCreateView() 中也可以执行
*
* @param view
* @param savedInstanceState
*/
@Override
public void onViewCreated(View view, @Nullable Bundle savedInstanceState) {
Log.i(TAG, "Fragment id = " + ID + "," + mTitle + " is onViewCreated.");
super.onViewCreated(view, savedInstanceState);
mTvContent = (TextView) view.findViewById(R.id.tv_content);
mTvContent.setText(mTitle);
}
/**
* 当 Activity 执行完 onCreate() 方法后调用
* 此时可以执行与 Activity 相关的 UI 操作
*
* @param savedInstanceState
*/
@Override
public void onActivityCreated(@Nullable Bundle savedInstanceState) {
Log.i(TAG, "Fragment id = " + ID + "," + mTitle + " is onActivityCreated.");
super.onActivityCreated(savedInstanceState);
//测试 onCreate() 是 Activity 的 UI 是否初始化完成
if (getContext() instanceof SimpleLifeCircleActivity) {
((SimpleLifeCircleActivity) getContext()).setActivityCreated("Fragment 进行 onActivityCreated() 时 Activity UI 已初始化完成。"
+ "\n你能看到我。");
}
}
@Override
public void onViewStateRestored(@Nullable Bundle savedInstanceState) {
Log.i(TAG, "Fragment id = " + ID + "," + mTitle + " is onViewStateRestored.");
super.onViewStateRestored(savedInstanceState);
}
/*-----------跟 Activity 中对应方法类似-------------*/
@Override
public void onStart() {
Log.i(TAG, "Fragment id = " + ID + "," + mTitle + " is onStart.");
super.onStart();
}
@Override
public void onResume() {
Log.i(TAG, "Fragment id = " + ID + "," + mTitle + " is onResume.");
super.onResume();
}
@Override
public void onPause() {
Log.i(TAG, "Fragment id = " + ID + "," + mTitle + " is onPause.");
super.onPause();
}
@Override
public void onStop() {
Log.i(TAG, "Fragment id = " + ID + "," + mTitle + " is onStop.");
super.onStop();
}
/*-----------跟 Activity 中对应方法类似-------------*/
/**
* 表示销毁 Fragment 相关联的 UI 布局，清除所有跟视图相关的资源。
* 不一定在 Activity 的 onDestroy() 方法中调用
* 如：Fragment 与 ViewPager 结合使用时
*
* @see com.littlejie.fragment.lifecircle.LifeCircleWithViewPagerActivity
*/
@Override
public void onDestroyView() {
Log.i(TAG, "Fragment id = " + ID + "," + mTitle + " is onDestroyView.");
super.onDestroyView();
}
/**
* 销毁 Fragment 对象的时候调用，一般是调用 Activity 的 onDestroy() 的时候执行
*/
@Override
public void onDestroy() {
//当调用 Activity 的 onDestroy() 时调用
Log.i(TAG, "Fragment id = " + ID + "," + mTitle + " is onDestroy.");
super.onDestroy();
}
/**
* 解除 Fragment 与 Activity 的关联
*/
@Override
public void onDetach() {
Log.i(TAG, "Fragment id = " + ID + "," + mTitle + " is onDetach.");
super.onDetach();
}
}
由于日志过多，这里不再展示，有兴趣的可自行下载 Demo 测试。这里简要总结下关于 Fragment 生命周期。
- 第一点很重要，最开始的两张图展示的 Fragment 与 Activity 的生命周期关系没毛病。
onAttach()和onCreate()只在 Fragment 与 Activity 第一次关联时调用。onDestroy()和onDetach()只在 Fragment 的宿主 Activity 销毁时才会被调用。- 根据前 3 点，将 Fragment 通过
addToBackStack()只涉及onCreateView()和onDestroyView()这之间的生命周期。add()和replace()不会对 Fragment 的生命周期产生影响，但add()方法会造成 Fragment 叠加显示。 - Fragment 与 ViewPager 结合使用时的生命周期与第 4 点相似。
- 通过
hide()、show()来隐藏、显示Fragment，此时 Fragment 只改变了可见性，并不涉及生命周期的改变 - 第 7 点与Fragment 和 Activity 的生命周期有关，即：不要在 Fragment 的 onCreate() 方法中操作宿主Activity 的 UI。因为你无法保证此时 宿主Activity 的 UI 已经完全初始化。PS:某些情况下是可以确保 宿主Activity 已经初始化完成的。
