Fragment详解

 与创建Activity类似，开发者实现的Fragment必须继承Fragment基类，Android提供了如图4.26所示的Fragment继承体系。

   开发者实现的Fragment，可以根据需要继承图4.26所示的Fragment基类或它的任意子类。接下来，实现Fragment与实现Activity非常相似，它们都需要实现与Activty类似的回调方法，例如onCreate()、onCreateView()、onStart()、onResume()、onPause()、onStop()等。

   通常来说，创建FragmentFragment通常需要实现如下三个方法。

• onCreate()：系统创建Fragment对象后回调该方法，实现代码中只初始化想要在Fragment中保持的必要组件，当 fragment被暂停或者停止后可以恢复。
• onCreateView()：当Fragment绘制界面组件时会回调该方法。该方法必须返回一个View，该View也就是该Fragment所显示的View。
• onPause()：当用户离开该Fragment时将会回调该方法。 

   对于大部分Fragment而言，通常都会重写上面这三个方法。但是实际上开发者可以根据需要重写Fragment的任意回调方法，后面将会详细介绍Fragment的生命周期及其回调方法。

   为了控制Fragment显示的组件，通常都会重写onCreateView()方法，该方法返回的View将作为该Fragment显示的View组件。当Fragment绘制界面组件时将会回调该方法。

  例如如下片段：

//重写该方法，该方法返回的View将作为Fragment显示的组件
    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container,
            Bundle savedInstanceState) {
        // TODO Auto-generated method stub
        //加载/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;
    }

上面的方法中第一行粗体字代码使用LayoutInflater加载了/res/layout/目录下的fragment_book_detail.xml布局文件，最后一行粗体字代码返回该布局文件对应的View组件，这表明该Fragment将会显示该View组件。

   实例：开发显示图书详情的Fragment

   下面Fragment将会显示加载一份简单的界面布局文件，并根据传入的参数来更新界面组件。该Fragment的代码如下。

package com.example.studyactivity;

import com.example.Modle.BookContent;

import android.app.Fragment;
import android.os.Bundle;
import android.view.LayoutInflater;
import android.view.View;
import android.widget.TextView;
import android.view.ViewGroup;

public class BookDetailFragment extends Fragment {
    public static final String ITEM_ID="item_id";
    //保存该Fragment显示的Book对象
    BookContent.Book book;
    @Override
    public void onCreate(Bundle savedInstanceState) {
        // TODO Auto-generated method stub
        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) {
        // TODO Auto-generated method stub
        //加载/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;
    }
}

 

   上面的Fragment将会加载并显示res/layout/目录下的fragment_book_detail.xml界面布局文件。上面①号代码获取启动该Fragment时传入的ITEM_ID参数，并根据该ID获取BookContent的ITEM_MAP中的图书信息。
    BookContent类用于模拟系统的数据模型，该模拟类的代码如下。

  

package com.example.Modle;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

public class BookContent {
    //定义一个内部类作为系统的业务对象
    public static class Book
    {
        public Integer id;
        public String title;
        public String desc;
        public Book(Integer id,String title,String desc)
        {
            this.id=id;
            this.title=title;
            this.desc=desc;
        }
        @Override
        public String toString() {
            // TODO Auto-generated method stub
            return title;
        }
    }
     
    //使用List集合记录系统所包含的Book对象
    public static List<Book> ITEMS=new ArrayList<Book>();
    //使用Map集合记录系统所包含的Book对象
    public static Map<Integer,Book> ITEM_MAP=new HashMap<Integer,Book>();
    static
    {
        //使用静态初始代码，将Book对象添加到List集合、Map集合中
        addItem(new Book(1,"疯狂Java讲义","一本全面、深入的Java学习图书，已被多家高校选作教材。"));
        addItem(new Book(2,"疯狂Android讲义","Android学习者的首选图书，常年占据京东、当当、"
        +"亚马逊3大网站Android销量排行榜的榜首。"));
        addItem(new Book(3,"轻量级Java EE企业应用实战","全面介绍Java EE开发的Struts 2、Spring 3、Hibernate 4框架"));
        
    }
    
    private static void addItem(Book book)
    {
        ITEMS.add(book);
        ITEM_MAP.put(book.id, book);
        
    }
    
}

 BookDetailFragment只是加载并显示一份简单的布局文件，这份布局文件中通过LinearLayout包含两个文本框。该fragment_book_detail.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来显示图书标题 -->
    <TextView
        android:id="@+id/book_title"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:padding="16dp"
        style="?android:attr/textAppearanceLarge" />
     <!-- 定义一个TextView来显示图片描述  -->
       <TextView
        android:id="@+id/book_desc"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:padding="16dp"
        style="?android:attr/textAppearanceMedium" />
</LinearLayout>

 实例：创建ListFragment

  如果开发ListFragment的子类，则无须重写onCreateView()方法——与ListActivity类似的是，只要调用ListFragment的setAdapter()方法为该Fragment设置Adapter即可。该ListFragment将会显示该Adapter提供的列表项。

       下面的实例开发了一个ListFragment的子类。

package com.example.studyactivity;

import android.app.Activity;
import android.app.ListFragment;
import android.os.Bundle;
import android.view.View;
import android.widget.ArrayAdapter;
import android.widget.ListView;

import com.example.Modle.BookContent;

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) {
        // TODO Auto-generated method stub
        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) {
        // TODO Auto-generated method stub
        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() {
        // TODO Auto-generated method stub
        super.onDetach();
        //将mCallbacks赋为null
        mCallbacks=null;
    }
    //当用户单击某列表项时激发该回调方法
    @Override
    public void onListItemClick(ListView l, View v, int position, long id) {
        // TODO Auto-generated method stub
        super.onListItemClick(l, v, position, id);
        //激发mCallbacks的onItemSelected方法
        mCallbacks.onItemSelected(BookContent.ITEMS.get(position).id);
    }
    public void setActivatedOnItemClick(boolean activateOnItemClick)
    {
        getListView().setChoiceMode(activateOnItemClick?ListView.CHOICE_MODE_SINGLE:ListView.CHOICE_MODE_NONE);
        
    }
    
}

 为了控制ListFragment显示的列表项，只要调用ListFragment提供的setAdapter()方法即可，这样即可让该ListFragment显示该Adapter所提供的多个列表项。

Fragment与Activity通信

    为了在Activity中显示Fragment，还必须将Fragment添加到Activity中。将Fragment添加到Activity中有如下两种方式：

• 在布局文件中使用<fragment.../>元素添加Fragment，<fragment.../>元素的android:name属性指定Fragment的实现类。
• 在Java代码中通过FragmentTransaction对象的add()方法来添加Fragment。   

提示：Activity的getFragmentManager()的方法可返回FragmentManager，Fragment-Manager对象的beginTransaction()方法即可开启并返回FragmentTransaction对象。

    下面Activity首先通过如下布局文件来使用前面定义的BookListFragment。

   

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    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="com.example.studyactivity.BookListFragment"
    android:id="@+id/book_list"
    android:layout_width="0dp"
    android:layout_height="match_parent"
    android:layout_weight="1"
    />
 <!-- 添加一个FragmentLayout容器 -->
 <FrameLayout android:id="@+id/book_detail_container"
     android:layout_width="0dp"
     android:layout_height="match_parent"
     android:layout_weight="3"/>
</LinearLayout>

上面的布局文件中粗体字代码使用<fragment.../>元素添加了BookListFragment，该Activity的左边将会显示一个ListFragment，右边只是一个FrameLayout容器，该FrameLayout容器将会动态更新其中显示的Fragment。下面是该Activity的代码。

package com.example.studyactivity;

import android.os.Bundle;
import android.app.Activity;
import android.content.Intent;
import android.view.Menu;

public class SelectBookActivity extends Activity implements BookListFragment.Callbacks {
     //定义一个旗杆，用于标识该应用是否支持大屏幕
      @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        //加载/res/layout目录下的activity_select_book.xml布局文件
              setContentView(R.layout.activity_select_book);
        //如果加载的界面布局文件中包含ID为book_detail_container的组件
       ((BookListFragment)getFragmentManager().findFragmentById(R.id.book_list))
            .setActivatedOnItemClick(true);
            
     }

    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        // Inflate the menu; this adds items to the action bar if it is present.
        getMenuInflater().inflate(R.menu.select_book, menu);
        return true;
    }
     //实现Callbacks接口必须实现的方法
    @Override
    public void onItemSelected(Integer id) {
      // TODO Auto-generated method stub
        //创建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();//①
    }

}

 上面的程序中①号粗体字代码就调用了FragmentTransaction的replace()方法动态更新了ID为book_detail_container容器（也就是前面布局文件中的FrameLayout容器）中显示的Fragment。

      将Fragment添加到Activity之后，Fragment必须与Activity交互信息，这就需要Fragment能获取它所在的Activity，Activity也能获取它所包含的任意的Fragment。可按如下方法进行。

• Fragment获取它所在的Activity：调用Fragment的getActivity()方法即可返回它所在的Activity。
• Activity获取它所包含的Fragment：调用Activity关联的FragmentManager的findFragmentById(int id)或findFragmentByTag(String tag)方法即可获取指定的Fragment。

     除此之外，Fragment与ActivityActivity可能还需要互相传递数据，可按如下方式进行。

•  Activity向Fragment传递数据：在Activity中创建Bundle数据包，并调用Fragment的setArguments(Bundle bundle)方法即可将Bundle数据包传给Fragment。
• Fragment向Activity传递数据或Activity需要在Fragment运行中进行实时通信：在Fragment中定义一个内部回调接口，再让包含该Fragment的Activity实现该回调接口，这样Fragment即可调用该回调方法将数据传给Activity。     

    上面实例定义了两个Fragment，并使用了一个Activity来“组合”这两个Activity，该实例的运行界面如图4.27所示。

    Fragment管理与Fragment事务

前面介绍了Activity与Fragment交互相关的内容，其实Activity管理Fragment主要依靠FragmentManager。

   FragmentManager可以完成如下几方面的功能。

•  使用findFragmentById()或findFragmentByTag()方法来获取指定Fragment。
•  调用popBackStack()方法将Fragment从后台栈中弹出（模拟用户按下BACK按键）。
•  调用addOnBackStackChangeListener()注册一个监听器，用于监听后台栈的变化。

    如果需要添加、删除、替换Fragment，则需要借助于FragmentTransaction对象，FragmentTransaction代表Activity对Fragment执行的多个改变。

    开发者可通过FragmentManager来获得FragmentTansaction，代码片段如下：

 FragmentManager fragmentManager=getFragmentManager();

 FragmentTransaction   fragmentTransaction=fragmentManager.beginTransaction();  

  每个FragmentTransaction可以包含多个对Fragment修改，比如包含调用了多个add()、remove()、和replace()操作，最后还调用commit()方法提交事务即可。

   在调用commit()之前，开发者也可调用addToBackStack()将事务添加到back栈，该栈由Activity负责管理，这样允许用户按BACK按键返回到前一个Fragment状态。

   实例：开发兼顾屏幕分辨率的应用

   为了开发兼顾屏幕分辨率的应用，可以考虑在res/目录下为大屏幕、600dpi的屏幕建立相应的资源文件夹：values-large、values-sw600dp，在该文件夹下建立一个名为refs.xml的引用资源文件。该引用资源文件专门用于定义各种引用项。

    本实例的引用资源文件只有一项，下面是该引用资源文件的代码。

<?xml version="1.0" encoding="utf-8"?>
<resources>
   <!-- 定义activity_book_list实际引用@layout/activity_select_book资源 --> 
   <item type="layout" name="activity_book_list">
       @layout/activity_select_book
   </item>
</resources>

 上面引用资源文件中指定acitivity_book_list引用/res/layout/目录下的activity_select_book.xml界面布局文件。

     接下来在Activity加载R.layout.activity_book_list时将会根据运行平台的屏幕大小自动选择界面布局文件：在大屏幕的平板电脑上，R.layout.activity_book_list将会变成/res/layout/目录下的activity_select_book界面布局文件；在小屏幕手机上，R.layout.activity_book_list依然引用/res/layout/目录下的activity_book_list.xml界面布局文件。

     下面是activity_book_list.xml界面布局文件的代码。

<?xml version="1.0" encoding="utf-8"?>
<!-- 直接使用BookListFragment作为界面组件 -->
<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    android:name="com.example.studyactivity.BookListFragment"
    android:id="@+id/book_list"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:layout_marginLeft="16dp"
    android:layout_marginRight="16dp" >
</fragment>

该布局文件只显示图书列表

接下来加载该布局文件的Activity将会根据不同屏幕分辨率分别进行处理。下面是该Activity的代码。

package com.example.studyactivity;

import android.os.Bundle;
import android.app.Activity;
import android.content.Intent;
import android.view.Menu;

public class SelectBookActivity extends Activity implements BookListFragment.Callbacks {
     //定义一个旗杆，用于标识该应用是否支持大屏幕
    private boolean mTwoPane;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        //指定加载R.layout.activity_book_list对应的界面布局文件
        //但实际上该应用会根据屏幕分辨率加载不同的界面布局文件
        setContentView(R.layout.activity_book_list);
        //如果加载的界面布局文件中包含ID为book_detail_container的组件
    
        if(findViewById(R.id.book_detail_container)!=null)
        {
            mTwoPane=true;
            ((BookListFragment)getFragmentManager().findFragmentById(R.id.book_list))
            .setActivatedOnItemClick(true);
            
    }
    }

    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        // Inflate the menu; this adds items to the action bar if it is present.
        getMenuInflater().inflate(R.menu.select_book, menu);
        return true;
    }
     //实现Callbacks接口必须实现的方法
    @Override
    public void onItemSelected(Integer id) {
        if(mTwoPane)
        {
        // TODO Auto-generated method stub
        //创建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();//①
        
        }
        else
        {
            //创建启动BookDetailActivity的Intent
            Intent detailIntent=new Intent(this,BookDetailActivity.class);
            //设置传给BookDetailActivity的参数
            detailIntent.putExtra(BookDetailFragment.ITEM_ID, id);
            //启动Activity
            startActivity(detailIntent);
        }
    }

}

由于该实例为大屏幕设备定义了引用资源文件，因此该应用将会根据大屏幕加载对应的界面布局文件，因此上面程序中第一段粗体字代码会判断界面布局中是否包含ID为book_detail_container的组件，如果包含该组件则表明是适应大屏幕的“双屏”界面。否则，该程序中只包含一个简单的BookListFragment列表组件。此时当用户单击列表项时，程序不再是简单地更换Fragment，而是启动BookDetailActivity来显示指定图书的详细信息。

    BookDetailActivity只是一个简单的封装，它将直接复用前面已有的BookDetailFragment。

BookDetailActivty加载的布局文件activity_book_detail.xml布局文件如下：

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/book_detail_container"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
   >
</FrameLayout>

BookDetailActivty的Java代码如下：

package com.example.studyactivity;

import android.os.Bundle;
import android.app.Activity;
import android.content.Intent;
import android.view.Menu;
import android.view.MenuItem;

public class BookDetailActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        //指定加载/res/layout/目录下的activity_book_detail.xml布局文件
        //该界面布局文件内只定义了一个名为book_detail_container的FrameLayout
        setContentView(R.layout.activity_book_detail);
        //将ActionBar上应用图标转换成可点击的按钮
        getActionBar().setDisplayHomeAsUpEnabled(true);
        if(savedInstanceState==null)
        {
            //创建BookDetailFragment对象
            BookDetailFragment fragment=new BookDetailFragment();
            //创建Bundle对象
            Bundle arguments=new Bundle();
            arguments.putInt(BookDetailFragment.ITEM_ID, getIntent().getIntExtra(BookDetailFragment.ITEM_ID
                    , 0));
            //向Fragment传入参数
            fragment.setArguments(arguments);
            //将指定fragment添加到book_detail_container容器中
            getFragmentManager().beginTransaction().add(R.id.book_detail_container, fragment).commit();
        }
    }

    @Override
    public boolean onOptionsItemSelected(MenuItem item) {
        // TODO Auto-generated method stub
        if(item.getItemId()==android.R.id.home)
        {
            //创建启动SelectBookActivity的Intent
            Intent intent=new Intent(this,SelectBookActivity.class);
            //添加额外的Flag,将Activity栈中处于FirstActivity之上的Activity弹出
            intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
            //启动intent对应的Activity
            startActivity(intent);
        }
        return super.onOptionsItemSelected(item);
    }

    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        // Inflate the menu; this adds items to the action bar if it is present.
        getMenuInflater().inflate(R.menu.book_detail, menu);
        return true;
    }

}

   上面的粗体字代码创建了BookDetailFragment，并让该Activity显示该Fragement即可。
   除此之外，该Activity还启用了ActionBar上的应用程序图标，允许用户点击点击该图标返回程序的主Activity。

运行程序将会看到图4.29 所示效果。

 

单击图4.29中的列表将看到图4.30所示界面