Android ListFragment

    Android是在Android 3.0（API level 11）开始引入Fragment的（为了兼容较低版本的设备使用支持库类）。可以把Fragment看成Activity中的模块，这个模块有自己的布局，有自己的生命周期（由托管activity调用其周期方法），单独处理自己的输入，在Activity运行的时候可以加载或者移除Fragment模块。

    ListFragment是Fragment的子类，内置列表显示支持功能。ListFragment通过内置的ListView显示绑定在其上面的数据。下面就通过例子了解具体的用法：

1、模型层  Day类和DayLab类

通过DayLab对象的getDays()方法获取用来绑定的数据。

Day.java                                 

package com.example.showdays;
import java.util.ArrayList;

public class Day {
	private String mTitle;

	public String getTitle() {
		return mTitle;
	}

	public void setTitle(String mTitle) {
		this.mTitle = mTitle;
	}
}

DayLab.java                           

package com.example.showdays;
import java.util.ArrayList;

public class DayLab {
	private ArrayList<Day> mDays;

	public DayLab() {
		mDays = new ArrayList<Day>();
		for (int i = 1; i <= 10; i++) {
			Day day = new Day();
			day.setTitle("Title #" + i);
			mDays.add(day);
		}
	}

	public ArrayList<Day> getDays() {
		return mDays;
	}
}

2、创建DayListFragment类

继承ListFragment类。并给其内置的ListView设置Adapter

DayListFragment.java            

package com.example.showdays;
import java.util.ArrayList;
import android.os.Bundle;
import android.support.v4.app.ListFragment;
import android.widget.ArrayAdapter;

public class DayListFragment extends ListFragment {
	private ArrayList<Day> days;

	public void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		DayLab dayLab = new DayLab();
		this.days = dayLab.getDays();
		ArrayAdapter<Day> adapter = new ArrayAdapter(getActivity(),
				android.R.layout.simple_list_item_1, days);
		// 第一个参数： Context对象,使用第二个参数的资源ID需要该Context对象
		// 第二个参数： 资源ID,可定位ArrayAdapter用来创建View对象的布局,这里的实参是 Android SDK提供的预定义布局资源
		// 第三个参数： 数据集
		setListAdapter(adapter);// 给DayListFragment内置的ListView设置adapter
	}
}

3、创建DayActivity类

继承FragmentActivity类。托管DayListFragment对象

其布局如下：

activity_day.xml                      

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

DayActivity.java                      

package com.example.showdays;
import android.support.v4.app.Fragment;
import android.support.v4.app.FragmentActivity;
import android.support.v4.app.FragmentManager;
import android.os.Bundle;
import android.util.Log;
import android.view.Menu;
import android.view.MenuItem;

public class DayActivity extends FragmentActivity {
	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_day);

		FragmentManager fm = getSupportFragmentManager();
		// 继承支持库类FragmentActivity获取FragmentManager对象的方法
		// 若继承Activity使用getFragmentManager()
		Fragment fragment = fm.findFragmentById(R.id.fragmentContainer);
		if (fragment == null) { // 查看fragment事务队列中是否存在此事物
			fragment = new DayListFragment();
			fm.beginTransaction().add(R.id.fragmentContainer, fragment)
					.commit();
			// 提交事务（资源ID作为唯一标识符且通知视图位置）
		}
	}

}

至此程序就可以正常运行了，运行效果如下图：

可以看到，已经呈现出列表形式，但是要显示的内容却不是我想要的。

那是因为 Android SDK提供的预定义布局资源（android.R.layout.simple_list_item_1）布局如下：

<TextView xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/text1"
    style="?android:attr/listItemFirstLineStyle"
    android:paddingTop="2dip"
    android:paddingBottom="3dip"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" >
</TextView>

这样在ListView被实例化后与adapter会话时，ArrayAdapter<Day>.getView()方法会调用Day对象的toString()方法，然后将返回值传递给TextView。

所以覆盖Day对象toString()方法：

Day.java                                 

package com.example.showdays;
import java.util.ArrayList;

public class Day {
	private String mTitle;

	public String getTitle() {
		return mTitle;
	}
	public void setTitle(String mTitle) {
		this.mTitle = mTitle;
	}

	@Override
	public String toString() {
		return mTitle;
	}
}

4、自定义列表项

上面使用的是Android SDK提供的预定义布局资源，直接把数据放置在TextView组件中来显示。

下面我就自定义一个列表项布局，将要显示的信息用Button组件来显示，布局如下：

my_list_item.xml                     

<Button xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/button"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:enabled="false" >
</Button>

DayListFragment.java            

package com.example.showdays;
import java.util.ArrayList;
import android.os.Bundle;
import android.support.v4.app.ListFragment;
import android.view.View;
import android.view.ViewGroup;
import android.widget.ArrayAdapter;
import android.widget.Button;

public class DayListFragment extends ListFragment {
	private ArrayList<Day> days;

	public void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		DayLab dayLab = new DayLab();
		this.days = dayLab.getDays();
		DayAdapter adapter = new DayAdapter(days);
		setListAdapter(adapter);
	}

	private class DayAdapter extends ArrayAdapter<Day> {
		public DayAdapter(ArrayList<Day> days) {
			super(getActivity(), 0, days);
		}

		@Override
		public View getView(int position, View convertView, ViewGroup parent) {
			if (convertView == null) { // 此列表项是否存在,不存在则创建一个
				convertView = getActivity().getLayoutInflater().inflate(
						R.layout.my_list_item, null);
			}
			Day day = getItem(position); // 获取当前位置的Day对象
			Button button = (Button) convertView.findViewById(R.id.button);
			button.setText(day.toString());
			return convertView;
		}
	}
}

#DONE#