Android支持库中Fragment的使用及参数传递

自己好久不写APK的界面部分了，平时的工作主要集中在APK的控制层和模型层，
或者干脆就深入到Android框架及更底层的部分了，因此许多界面的知识都有些遗忘了。

这次主要结合Android权威指南中的例子，回忆一下以前的知识，以博客的方式记录一下，
Android中使用android.support.v4.app.Fragment的基本方式。

一、Fragment的使用
我们知道Fragment的生命周期由嵌入的Activity管理。
Activity托管Fragment主要有如下两种方式：
1、在Activity的布局中添加fragment；
2、在Activity的代码中加入fragment。

第一种方式就是使用布局fragment。这种方式简单但不够灵活。
在Activity的布局中添加fragment，就等同于将fragment及其视图与activity的视图绑定在一起，
并且在activity的生命周期过程中，无法切换fragment视图。

第二种方式比较复杂，但也是唯一可以在运行时控制fragment的方式。
我们可以自行决定何时添加fragment、移除fragment等。

因此，为了追求真正灵活的UI设计，就必须以第二种方式，即以代码的方式添加fragment。
接下来，我们就看看以代码添加fragment的步骤。
考虑到兼容性，我们主要使用的是android支持库中的fragment，即android.support.v4.app.Fragment等相关类。

Fragment终究是需要嵌入到activity中，因此首先需要定义Activity的布局，示例如下：

<?xml version="1.0" encoding="utf-8"?><FrameLayout    xmlns:android="http://schemas.android.com/apk/res/android"    android:id="@+id/fragment_container"    android:layout_width="match_parent"    android:layout_height="match_parent"></FrameLayout>

示例Activity的布局及其简单，就是定义一个FrameLayout，作为Fragment布局的容器。

对应的Activity代码如下：

//定义一个抽象的父类public abstract class SingleFragmentActivity extends FragmentActivity {    @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.activity_fragment);        //FragmentManager管理fragment队列等        FragmentManager fm = getSupportFragmentManager();        //R.id.fragment_container是fragment容器的id        //先从Fragment队列中查找是否有容器id对应的fragment        Fragment fragment = fm.findFragmentById(R.id.fragment_container);        if (fragment == null) {            //由子类实现，创建Fragment            fragment = createFragment();            //创建一个FragmentTransaction(fragment事务)            fm.beginTransaction()                    //告诉fm, fragment应该放置的位置，同时用容器id作为fragment的标识符                    //当需要向Activity添加多个fragment时，通常要分别为每个fragment创建具有不同资源ID的容器                    .add(R.id.fragment_container, fragment)                    .commit();        }    }    protected abstract Fragment createFragment();}

从上面的代码可以看出，FragmentManager首先利用findFragmentById接口，
利用容器视图的资源ID，在fragment队列中查找对应的fragment。
当利用容器视图的资源ID找不到对应的fragment时，才创建新的fragment。

这是因为，当设备旋转或回收内存时，Android可能销毁当前的Activity。
当Activity被销毁时，它的FragmentManager会将fragment队列保存下来。

当Activity重建时，会再次调用其onCreate方法。
此时新的FragmentManager会首先获取保存的队列，然后重建fragment队列，从而恢复到原来的状态。

在SingleFragmentActivity的基础上，使用Fragment就变得很容易了。示例如下：

public class CrimeActivity extends SingleFragmentActivity {    private static final String EXTRA_CRIME_ID =            "stark.a.is.zhang.criminalintentapp.crime_id";    @Override    //子类只需要实现createFragment方法即可    protected Fragment createFragment() {        ...............        return CrimeFragment.newInstance(crimeId);    }    ...........}

看看CrimeFragment的实现：

public class CrimeFragment extends Fragment{    ...........    public static CrimeFragment newInstance(UUID crimeId) {        ..............        CrimeFragment crimeFragment = new CrimeFragment();        ..............        return crimeFragment;    }    @Override    public void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        .............    }    @Override    public View onCreateView(LayoutInflater inflater, ViewGroup container,            Bundle savedInstanceState) {        //加载Fragment自己的视图        View v = inflater.inflate(R.layout.fragment_crime, container, false);        .............        return v;    }}

Activity的FragmentManager负责调用队列中fragment的生命周期方法。
Activity添加fragment供FragmentManager管理时，Fragment的onAttach、onCreate以及onCreateView方法会被调用。
托管Activity的onCreate方法执行后，Fragment的onActivityCreated方法也会被调用。

FragementManager将保证fragment与Activity的运行状态保持一致。
例如，在运行态的Activity中添加Fragment时，FragmentManager将立即调用Fragment的
onAttach、onCreate、onCreateView、onActivityCreated、onStart和onResume方法，使Fragment的运行状态“追赶”上Activity。
一旦fragment的状态与Activity保持了一致，FragmentManager就会接受操作系统的指示，
按照Activity的状态，调用Fragment的其他生命周期方法。

以上是Fragment的基本用法，接下来看看Fragment之间的参数传递。

二、Fragment通过Activity进行参数传递
Fragment可以利用startActivity的方式启动另一个Activity，并在Intent中携带额外的信息。
假设另一个Activity，也是由Fragment来完成界面的布局，那么目的Fragment可以从对应的托管Activity获取传递的参数。
例如：

public class CrimeFragment extends Fragment {    .......    @Override    public void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        //从托管Activity中获取Intent，然后再获取额外信息        UUID crimeId = (UUID) getActivity().getIntent().getSerializable(ARG_CRIME_ID);        ................    }}

这种做法比较简单，但破坏了Fragment的封装性。
Fragment与特定的Activity绑定了，不再是可复用的构建单元。

针对上述问题，一种比较好的解决方案是使用Fragment的argument。
每个fragment实例都可以附带一个Bundle对象。
该Bundle对象包含键值对，一个键值对就是一个argument。
要附加argument给fragment，需要调用Fragment.setArguments方法，
且必须在fragment创建后、添加到activity前完成。

对于上面代码中例子，可以在Fragment的构造函数中，完成argument的设置：

public class CrimeActivity extends SingleFragmentActivity {    .................    @Override    //父类在将fragment加入到FragmentManager前，先调用该方法构造Fragment    protected Fragment createFragment() {        //获取启动的Intent，从中得到消息        UUID crimeId = (UUID) getIntent().getSerializableExtra(CrimeActivity.EXTRA_CRIME_ID);        //调用Fragment提供的接口，设置arguments        return CrimeFragment.newInstance(crimeId);    }    .....}

再看看Fragment的完整实现：

public class CrimeFragment extends Fragment{    ...........    //个人觉得，CrimeFragment可以提供多种newInstance函数，以满足不同Activity的使用需求    //达到Fragment与Activity解耦的目的    public static CrimeFragment newInstance(UUID crimeId) {        //在Fragment创建时，创建bundle        Bundle args = new Bundle();        args.putSerializable(ARG_CRIME_ID, crimeId);        CrimeFragment crimeFragment = new CrimeFragment();        //利用fragment的setArguments方法，将bundle设置到arguments中        crimeFragment.setArguments(args);        return crimeFragment;    }    @Override    //fragment被Activity加入到FragmentManager后，onCreate函数被调用    public void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        //利用getArguments函数，得到Bundle对象，于是可以获取之前存入的数据        //如果被多个Activity使用，那么获取参数时就需要对应的判断了        UUID crimeId = (UUID) getArguments().getSerializable(ARG_CRIME_ID);        ................    }}

通过上述的方式，可以一定程度上实现Fragment与托管Activity的解耦的目的。

在本文的最后，稍微提一点：
Fragment可以覆盖Activity的startActivityForResult方法和onActivityResult方法，于是可以处理启动Activity后的返回值。

不过Fragment没有定义setResult方法，因此目的Fragment如果需要设置返回结果，
需要调用托管Activity的setResult方法，即在Fragment中，需要调用类似如下代码：

...........getActivity.seResult(Activity.RESULT_OK, data);...........

三、同一个Activity托管Fragment之间的参数传递
源Fragment向目的Fragment传递参数时，与上文一样，仍然需要利用Fragment的arguments。
不过，由于是同一个Activity托管的两个Fragment，因此可以将它们之间的通信关系确定下来。
如下面的示例代码所示：

.............mDateButton.setOnClickListener(new View.OnClickListener() {    @Override    public void onClick(View view) {        FragmentManager fm = getFragmentManager();        //目的Fragment为DatePickerFragment，在newInstance时，源Fragment将参数写入到其arguments中        DatePickerFragment dialog = DatePickerFragment.newInstance(mCrime.getDate());        //调用目的Fragment的setTargetFragment方法，此时就将源、目的Fragment之间的关系确定下来了        //REQUEST_DATE与startActivityForResult中的request_code一致        dialog.setTargetFragment(CrimeFragment.this, REQUEST_DATE);        //显示目的Fragment        dialog.show(fm, DIALOG_DATE);    }});...............

源Fragment和目的Fragment之间的关系确定后，目的Fragment就可以通过如下方式，将消息发送给源Fragment：

...............private void sendResult(int resultCode, Date date) {     //判断是否有绑定的源Fragment     if (getTargetFragment() == null) {         return;     }     Intent intent = new Intent();     intent.putExtra(EXTRA_DATE, date);    //直接调用源Fragment的onActivityResult返回结果     getTargetFragment().onActivityResult(            getTargetRequestCode(), resultCode, intent);}..........