Fragment详解，以开发"显示图书详情的Fragment"为例

Fragment是学习Android以来觉得最麻烦的一个知识点，涉及的内容比较多，在书本上不好记录，所以决定写一篇博文来梳理内容。

Fragment的难点重点是消息传递，本文中的图书详情案例中的消息顺序是：1、用户点击图书的标题（BookListFragment） 2、通知activity 3、activity通知显示图书详细信息（BookDetailFragment）

部分内容参考博文：http://www.cnblogs.com/mengdd/archive/2013/01/11/2856374.html

1、界面

创建Activity的界面。左边为一个fragment，id为book_list，对应的类为org.crazyit.app.BookListFragment。右边为FrameLayout，id为book_detail_container。
发现他们的layout_width都为0dp，Layout_weight分别为1和3，所以两者显示的界面区域大小为1：3，Layout_weight的理解可以参考博文中的Layout_weight详解。

activity_book_twopane.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- 定义一个水平排列的LinearLayout，并指定使用中等分隔条 -->
<LinearLayout
xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="horizontal"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:layout_marginLeft="16dp"
android:layout_marginRight="16dp"
android:divider="?android:attr/dividerHorizontal"
android:showDividers="middle">
<!-- 添加一个Fragment -->
<fragment
android:name="org.crazyit.app.BookListFragment"
android:id="@+id/book_list"
android:layout_width="0dp"
android:layout_height="match_parent"
android:layout_weight="1" />
<!-- 添加一个FrameLayout容器 -->
<FrameLayout
android:id="@+id/book_detail_container"
android:layout_width="0dp"
android:layout_height="match_parent"
android:layout_weight="3" />
</LinearLayout>

2、创建ListFragment

在BookListFragment类中定义一个接口——Callbacks（ 内有onItemSelected(Interger id方法) ），该Fragment所在Activity需要实现该接口，Fragment将通过该接口与它所在的Activity交互。
ListFragment显示的数据，使用ArrayAdapter适配器，数据类型为BookContent.Book,ITEMS为List<Book>!!!!。原因：ArrayAdapter为什么可以处理对象类型的数据呢？其实，ArrayAdapter是使用数组中对象的toString()方法来填充指定的TextView，所以我们可以通过重写对象的toString()方法来自定义ListView的显示。而Book的toString()方法显示的是第一个字符串，即书本的标题。
onAttach方法在该Fragment被添加、显示到Activity时回调该方法。
onDetach方法在该Fragment从它所属的Activity中被删除时回调该方法。
onLIstItemClick为用户单机某列表时激发该回调方法，传入选中页面的书本id。
为什么创建接口CalBacks？

一些情况下，可能需要fragment和activity共享事件，一个比较好的做法是在fragment里面定义一个回调接口，然后要求宿主activity实现它。当activity通过这个接口接收到一个回调，它可以同布局中的其他fragment分享这个信息。

例如，一个新闻显示应用在一个activity中有两个fragment，一个fragment A显示文章题目的列表，一个fragment B显示文章。所以当一个文章被选择的时候，fragment A必须通知activity，然后activity通知fragment B，让它显示这篇文章。这个情况下，在fragment A中声明一个这样的接口OnArticleSelectedListener：

public static class FragmentA extends ListFragment {
...
// Container Activity must implement this interface
public interface OnArticleSelectedListener {
public void onArticleSelected(Uri articleUri);
}
...
}

之后包含这个fragment的activity实现这个OnArticleSelectedListener接口，用覆写的onArticleSelected()方法将fragment A中发生的事通知fragment B。
为了确保宿主activity实现这个接口，fragment A的onAttach() 方法（这个方法在fragment
被加入到activity中时由系统调用）中通过将传入的activity强制类型转换，实例化一个OnArticleSelectedListener对象：

public static class FragmentA extends ListFragment {
OnArticleSelectedListener mListener;
...
@Override
public void onAttach(Activity activity) {
super.onAttach(activity);
try {
mListener = (OnArticleSelectedListener) activity;
} catch (ClassCastException e) {
throw new ClassCastException(activity.toString() + " must implement OnArticleSelectedListener");
}
}
...
}

如果activity没有实现这个接口，fragment将会抛出ClassCastException异常，如果成功了，mListener将会是activity实现OnArticleSelectedListener接口的一个引用，所以通过调用OnArticleSelectedListener接口的方法，fragment
A可以和activity共享事件。
　　比如，如果fragment A是ListFragment的子类，每一次用户点击一个列表项目，系统调用fragment中的onListItemClick() 方法，在这个方法中可以调用onArticleSelected()方法与activity共享事件。

public static class FragmentA extends ListFragment {
OnArticleSelectedListener mListener;
...
@Override
public void onListItemClick(ListView l, View v, int position, long id) {
// Append the clicked item's row ID with the content provider Uri
Uri noteUri = ContentUris.withAppendedId(ArticleColumns.CONTENT_URI, id);
// Send the event and Uri to the host activity
mListener.onArticleSelected(noteUri);
}
...
}

BookListFragment.java

public class BookListFragment extends ListFragment
{
private Callbacks mCallbacks;
// 定义一个回调接口，该Fragment所在Activity需要实现该接口
// 该Fragment将通过该接口与它所在的Activity交互
public interface Callbacks
{
public void onItemSelected(Integer id);
}

@Override
public void onCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);
// 为该ListFragment设置Adapter
setListAdapter(new ArrayAdapter<BookContent.Book>(getActivity(),
android.R.layout.simple_list_item_activated_1,
android.R.id.text1, BookContent.ITEMS));
}
// 当该Fragment被添加、显示到Activity时，回调该方法
@Override
public void onAttach(Activity activity)
{
super.onAttach(activity);
// 如果Activity没有实现Callbacks接口，抛出异常
if (!(activity instanceof Callbacks))
{
throw new IllegalStateException(
"BookListFragment所在的Activity必须实现Callbacks接口!");
}
// 把该Activity当成Callbacks对象
mCallbacks = (Callbacks)activity;
}
// 当该Fragment从它所属的Activity中被删除时回调该方法
@Override
public void onDetach()
{
super.onDetach();
// 将mCallbacks赋为null。
mCallbacks = null;
}
// 当用户点击某列表项时激发该回调方法
@Override
public void onListItemClick(ListView listView
, View view, int position, long id)
{
super.onListItemClick(listView, view, position, id);
// 激发mCallbacks的onItemSelected方法
mCallbacks.onItemSelected(BookContent
.ITEMS.get(position).id);
}

public void setActivateOnItemClick(boolean activateOnItemClick)
{
getListView().setChoiceMode(
activateOnItemClick ? ListView.CHOICE_MODE_SINGLE
: ListView.CHOICE_MODE_NONE);
}
}

3、图书详细信息显示的Fragment

每次BookDetailFragment切换时系统会调用onCreate方法，根据activity中传入的参数获取book信息。
Fragment每次切换时显示的界面也会发生变化，onCreateView方法返回显示的View，使用的布局文件为R.layout.fragment_book_detail,显示标题和描述内容。
获取activity传入的参数，通过getArguments方法

BookDetailFragment.java

public class BookDetailFragment extends Fragment
{
public static final String ITEM_ID = "item_id";
// 保存该Fragment显示的Book对象
BookContent.Book book;
@Override
public void onCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);
// 如果启动该Fragment时包含了ITEM_ID参数
if (getArguments().containsKey(ITEM_ID))
{
book = BookContent.ITEM_MAP.get(getArguments()
.getInt(ITEM_ID)); //①
}
}

// 重写该方法，该方法返回的View将作为Fragment显示的组件
@Override
public View onCreateView(LayoutInflater inflater
, ViewGroup container, Bundle savedInstanceState)
{
// 加载/res/layout/目录下的fragment_book_detail.xml布局文件
View rootView = inflater.inflate(R.layout.fragment_book_detail,
container, false);
if (book != null)
{
// 让book_title文本框显示book对象的title属性
((TextView) rootView.findViewById(R.id.book_title))
.setText(book.title);
// 让book_desc文本框显示book对象的desc属性
((TextView) rootView.findViewById(R.id.book_desc))
.setText(book.desc);
}
return rootView;
}

}

4、编写activity

设置activity_book_twopane为布局文件，即左边是Fragment，右边是FrameLayout。
实现Callbacks接口的onItemSelected方法，用户点击Fragment时激发mCallbacks的onItemSelected方法，通知BookDetailFragment这个描述书本详细信息的Fragment类，更新内容。
Activity的getFragmentManager()方法可以返回FragmentManager，FragmentManager对象的beginTransaction()方法即可开启并返回FragmentTransaction对象，使用Fragment替换book_detail_container容器当前显示的Fragment。
通过setArguments方法传入参数。

SelectBookActivity.java

public class SelectBookActivity extends Activity implements
BookListFragment.Callbacks
{
@Override
public void onCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);
// 加载/res/layout目录下的activity_book_twopane.xml布局文件
setContentView(R.layout.activity_book_twopane);
}
// 实现Callbacks接口必须实现的方法
@Override
public void onItemSelected(Integer id)
{
// 创建Bundle，准备向Fragment传入参数
Bundle arguments = new Bundle();
arguments.putInt(BookDetailFragment.ITEM_ID, id);
// 创建BookDetailFragment对象
BookDetailFragment fragment = new BookDetailFragment();
// 向Fragment传入参数
fragment.setArguments(arguments);
// 使用fragment替换book_detail_container容器当前显示的Fragment
getFragmentManager().beginTransaction()
.replace(R.id.book_detail_container, fragment)
.commit();  //①
}
}