首页 > 代码库 > Android学习笔记十四.深入理解fragment(二) 之《图书详情》实战

Android学习笔记十四.深入理解fragment(二) 之《图书详情》实战

深入理解fragment(二)
之《图书详情》实战
    通过上一篇博文《深入理解fragment一》,我们学习了Android-Fragment的核心知识点。现在在此基础上,利用Fragment技术开发一款适用于大屏幕手机/平板的查找图书详情的应用软件。该项目主要在于两方面,一是Activity、Fragment的源码实现;二是,布局界面资源文件的实现。
技术分享
1.res/../BookListFragment.java:
    自定义类,继承于ListFragment,无需实现OnCreateView()方法,用于Activity右边显示列表fragment
(1)定义Callbacks接口:定义一个回调接口Callback,用于实现该Fragment与它所在的Activity交互;
(2)实现onCreate(Bundle savedInstanceState)方法:通过Adapter所提供的多个列表项,设置Fragment列表显示的列表项;
(3)实现onAttach(Activity activity)方法:将Fragment添加并显示到Acitvity中,并将传入的activity对象强制类型转化为 Callbacks接口对象,以便调用接口公共方法onItemSelected(Integer id)响应用户单击的某列表项;
(4)实现ListFragment的onListItemClick(ListView l, View v, int position, long id)方法:
    当用户点击Acitivity中的某项列表时,onListItemClick方法被激发。在这个方法中调用接口的onItemSelected来与activity共享事件。onItemSelected()传入的参数id是列表的被选中的行ID,另一个fragment(B)( BookDetailFragment )用这个ID来从程序的ContentProvider中取得标题的内容。
package com.example.android_fragment_1;
import android.app.Activity; 
import android.app.ListFragment;
import android.os.Bundle;
import android.view.View;
import android.widget.ArrayAdapter;
import android.widget.ListView;
public class BookListFragment extends ListFragment { 
  //1.定义一个回调接口Callback,用于实现该Fragment与它所在的Activity交互(注意:该接口的实现需要在Activit中) 
 private Callbacks mCallbacks;	//Callbacks接口对象
 public interface Callbacks
 {
  public void onItemSelected(Integer id);	//参数为Map集合的键
 }
 
 //2.onCreate方法中为该ListFragment设置Adapter,让该ListFragment显示该Adapter所提供的多个列表项
 @Override
 public void onCreate(Bundle savedInstanceState) {
  // TODO Auto-generated method stub
  super.onCreate(savedInstanceState);
  setListAdapter(new ArrayAdapter<BookContent.Book>(getActivity(),//
    android.R.layout.simple_list_item_activated_1,
    android.R.id.text1,
    BookContent.ITEMS));	 //
 }
 
 //3.调用该方法将Fragment添加并显示到Acitvity中
 @Override
 public void onAttach(Activity activity) {
  // TODO Auto-generated method stub
  super.onAttach(activity);
  //a.如果Activity中没有实现Callbacks接口,抛出异常
  if(!(activity instanceof Callbacks))
  {
   throw new IllegalStateException("异常:BookListFragment所在的Activity必须实现Callback接口!");
  }
  //把该Activity当成Callbacks对象(就是这一句导致出现NullPointerException错误)
        mCallbacks=(Callbacks)activity;
 }
 
 //4.当该Fragment从他所属的Acitivity中被删除时,调用该方法
 @Override
 public void onDetach() {
  super.onDetach();
  mCallbacks=null;	//将mCallbacks赋值为null
 }
 
 //5.当用户单击某列表项时激发该回调方法
 @Override
 public void onListItemClick(ListView l, View v, int position, long id) {
  super.onListItemClick(l, v, position, id);
  mCallbacks.onItemSelected(BookContent.ITEMS.get(position).id);//激发mCallbacks接口的onItemSelected方法
 }
public void setActivateOnItemClick(boolean activateOnItemClick) {
getListView().setChoiceMode(activateOnItemClick ? ListView.CHOICE_MODE_SINGLE:ListView.CHOICE_MODE_NONE);
 }
}

2.res/../ BookDetailFragment.java:
      onItemSelected()传入的参数id是列表的被选中的行ID, BookDetailFragment 用这个ID来从程序的ContentProvider中取得标题的内容。  
(1)实现onCreate(Bundle savedInstanceState)方法:
    获取启动该Fragment时传入的ITEM_ID参数并根据该ID获取BookContent的ITEM_MAP中的图书信息
(2)实现onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)方法:
    a.为图书详情Fragment加载一个界面布局文件,为两个文本框;
    b.根据传入的参数ID来更新View容器,使文本框显示不同的内容;
package com.example.android_fragment_1;
import android.app.Fragment;
import android.os.Bundle;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.TextView;
/*功能:
 * 使用Fragment将会显示加载一份简单的界面布局文件,并根据传入的参数来更新
 * 界面组件*/
public class BookDetailFragment extends Fragment {
 public static final String ITEM_ID="item_id";
 BookContent.Book book;	 //保存该Fragment显示的book对象
 
 @Override
 public void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  //如果启动该Fragment时包含了ITEM_ID参数,其中 Map containsKey(String Key) 判断key有没有对应的value值; 有,则返回true 没有,则返回false
  //从Bundle对象中获取传入的参数(键值对)
  if(getArguments().containsKey(ITEM_ID))
  {
       book=BookContent.ITEM_MAP.get(getArguments().getInt(ITEM_ID));
   //获取启动该Fragment时传入的ITEM_ID参数并根据该ID获取BookContent的ITEM_MAP中的图书信息?
  }
 }
 //2.重写该方法:该方法返回的View将作为Fragment显示的组件
 @Override
 public View onCreateView(LayoutInflater inflater, ViewGroup container,
   Bundle savedInstanceState) {
  //a.加载/res/layout/目录下的fragment_book_detail.xml布局文件,返回一个view目的使该fragment的布局显示在Activity中
  View view=inflater.inflate(R.layout.fragment_book_detail, //指明当前fragment的资源文件
         container, //父容器控件
         false);	 //表明是否连接该布局和其父容器控件(这里系统已经插入了布局到父容器中)
  /*将图书信息中的标题、属性显示在容器的两个文本框中*/
  if(book!=null)
  {
  //b.让book_title文本框显示book对象的title属性
   ((TextView) view.findViewById(R.id.book_title)).setText(book.title);
  //c.让book_desc文本框显示book对象的desc属性
   ((TextView) view.findViewById(R.id.book_desc)).setText(book.desc);
  }
  return view;
 }
 
}

其中界面资源布局文件为/res/layout/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
     style="?android:attr/textAppearanceLarge"
     android:id="@+id/book_title"
     android:layout_width="match_parent"
     android:layout_height="wrap_content"
     android:padding="16dp"/>
 <!-- 定义一个TextView来显示图书描述 -->
 <TextView
     style="?android:attr/textAppearanceLarge"
     android:id="@+id/book_desc"
     android:layout_width="match_parent"
     android:layout_height="match_parent"
     android:padding="16dp"/>
</LinearLayout>
3.res/../SelectBookActivity.java:
应用程序主Acitivity
(1)加载activity要显示的布局文件(two panes)
(2)实现Callbacks接口的
onItemSelected(Integer id)方法:
      Activity从FragmentA获取传入的ID,用来启动FragmentB
package com.example.android_fragment_1;
import android.app.Activity; 
import android.os.Bundle;
public class SelectBookActivity extends Activity implements BookListFragment.Callbacks 
{
 @Override
 protected void onCreate(Bundle savedInstanceState) {
  // TODO Auto-generated method stub
  super.onCreate(savedInstanceState);
 //1.加载Activity自己的布局资源/res/layout/main.xml并显示(two panes)
  setContentView(R.layout.activity_book_twopane);
 }
 
 //2.实现Callbacks接口必须实现的方法,用于实现该Fragment与它所在的Activity交互(即选择点击哪个列表项,向Fragment传入参数id)//更新Activity右边内容
 
 @Override
 public void onItemSelected(Integer id) {
  //a.创建Bundle,准备向Fragment传入参数
  Bundle arguments=new Bundle();
  arguments.putInt(BookDetailFragment.ITEM_ID, id);	//装入值id到"item_id"键
  //b.创建BookDetailFragment对象,并项Fragment传入参数
  BookDetailFragment fragment=new BookDetailFragment();
  fragment.setArguments(arguments);
  //c.使用fragment替换book_detail_container容器当前显示的Fragment
  getFragmentManager().beginTransaction()
    .replace(R.id.book_detail_container, fragment)
    .commit();
 
  /*注释:这一句等价于....
   * FragmentManager Manager=getFragmentManager();
   * FragmentTransaction Transaction=Manager.beginTransaction();
   * Transaction.replace(R.id.book_detail_container, Manager);
   * Transaction.commit();
   * */
 }
}

其中界面资源布局文件为/res/layout/activity_book_twopane.xml
<?xml version="1.0" encoding="utf-8"?>
<!-- 定义一个水平排列的LinearLayout,并指定使用中等分隔条 -->
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="horizontal"
    android:layout_marginLeft="16dp"
    android:layout_marginRight="16dp"
    android:divider="?android:attr/dividerHorizontal"
    android:showDividers="middle">
    <!-- 使用资源文件方式:添加一个fragment到Activity中 -->
    <fragment
        android:name="com.example.android_fragment_1.BookListFragment"
        android:id="@+id/book_list"
        android:layout_height="match_parent"
        android:layout_width="0dp"
        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>
<!--说明:这个布局文件就定义了Activity的显示界面:
 左边将会显示一个ListFragment,右边只是一个FrameLayout容器
 其中FrameLayout容器将会动态更新其中显示的Fragment -->

4.res/../BookContent.java:
    用于模拟系统的数据模型
 (1)List集合为左边fragment提供图书(标题)列表项数据
    public static List<Book> ITEMS=new ArrayList<Book>();
对于List集合来说,book为(1,"疯狂Android讲义","个人评价:这本书很好,就是有点厚!"2...3...)
 (2)Map集合为右边fragment提供图书详情(标题、属性)数据
    public static Map<Integer,Book> ITEM_MAP =new HashMap<Integer,Book>();
对应Map集合来说,键book.id<--->值(1.......2.......3......)
package com.example.android_fragment_1;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
public class BookContent {
 //1.定义一个内部类,作为系统的业务对象
 public static class Book
 {
  public Integer id;	 //Map键
  public String title;
  public String desc;
  public Book(Integer id,String title,String desc)//构造函数,初始化图书详情的"map键,标题,内容"
  {
   this.id=id;
   this.title=title;
   this.desc=desc;
  }
  public String toString()
  {
   return title;
  }
 }
 //2.使用List集合记录系统所包含的Book对象ITEMS,利用它调用其add(对象)方法项List集合中添加列表项
 public static List<Book> ITEMS=new ArrayList<Book>();
 //3.使用Map集合记录系统所包含的Book对象ITEM_MAP,利用它调用put(Key,Value)方法向Map集合中添加列表项
 public static Map<Integer,Book> ITEM_MAP =new HashMap<Integer,Book>();
 static{
   //使用静态初始化代码,将Book对象添加到List集合、Map集合中
   addItem(new Book(1,"疯狂Android讲义","个人评价:这本书很好,就是有点厚!"));
   addItem(new Book(2,"数学之美","个人评价:来自自然语音的使者"));
   addItem(new Book(3,"大话数据结构","个人评价:不知道怎样,听说很不错"));
 }
 private static void addItem(Book book) {
  // TODO Auto-generated method stub
  ITEMS.add(book);	 //添加List集合中列表项
  ITEM_MAP.put(book.id,book);//添加Map集合中列表项
 }
}

/*注释:
 * static{},称为static代码块,也叫静态代码块。是在类中独立于类成员的static语句块,可以有多个且位置可以随便放。
 * 它不属于任何的方法体内,JVM加载类时会执行这些静态的代码块,如果有多个则按先后顺序执行且每个代码块智会被执行依次。
 * 比如,我们可以利用静态代码块可以对一些statci变量进行赋值*/
技术分享

Android学习笔记十四.深入理解fragment(二) 之《图书详情》实战