Adapter是连接后端数据和前端显示的适配器接口,是数据和UI之间一个重要的纽带。
Andapter常用的实现类如下:
- ArrayAdapter:简单、易用,常用于将数组或List集合的多个值包装成列表项,每个列表项只能是TextView,只能展示一行字。
- SimpleAdapter:并不简单,功能强大,可用于将List集合的多个对象包装成多个列表项,有最好的扩充性,可以自定义出各种效果。
- SimpleCursorAdapter:与SimpleAdapter基本相似,用来包装Cursor提供的数据,可以适用于简单的纯文字型ListView,它需要Cursor的字段和 UI的id对应起来。
- BaseAdapter:常用于被扩展,继承它需要实现较多的方法,可对各列表项进行最大限度的控制举例说明
1、ArrayAdapter
①在主布局界面(main.xml)中,定义一个ListView,此ListView并没有指定android:entries属性,意味着需要通过Adapter来提供列表项。
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_width="fill_parent"
android:layout_height="fill_parent">
<ListView
android:id="@+id/list1"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:divider="#f00"
android:dividerHeight="2px"
android:headerDividersEnabled="false"
/>
</LinearLayout>
②每个列表项的外观由另一个布局文件(array_item.xml)控制,该布局文件只是一个TextView组件
<?xml version="1.0" encoding="utf-8"?>
<TextView
xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/TextView"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:textSize="24dp"
android:padding="10px"
android:shadowColor="#f0f"
android:shadowDx="4"
android:shadowDy="4"
android:shadowRadius="2"/>
③Activity中为ListView提供Adapter,Adapter决定ListView所显示的列表项。
import android.app.Activity;
import android.os.Bundle;
import android.widget.ArrayAdapter;
import android.widget.ListView;
public class ArrayAdapterTest extends Activity
{
@Override
protected void onCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
ListView list1 = (ListView) findViewById(R.id.list1);
// 定义一个数组
String[] arr1 = { "孙悟空", "猪八戒", "牛魔王" };
// 将数组包装ArrayAdapter
ArrayAdapter<String> adapter1 = new ArrayAdapter<String>(this, R.layout.array_item, arr1);
// 为ListView设置Adapter
list1.setAdapter(adapter1);
}
}
ArrayAdapter<String> adapter1 = new ArrayAdapter<String>(this, R.layout.array_item, arr1);
创建了一个ArrayAdapter,创建时必须制定三个参数:
- Context:它代表了访问整个Android应用的接口,几乎创建所有组件都需要传入Context对象
- textViewResourceId:一个资源ID,代表一个TextView,该TextView组件将作为ArrayAdapter的列表项组件
- 数组或List:负责为多个列表项提供数据。该数组或List包含多少元素,就生成多少列表项,每个列表项都是TextView组件
这个例子,如果程序窗口仅仅需要显示一个列表,我们还可以直接让Activity继承ListActivity来实现,ListActivity的子类就无需调用setContentView()方法来显示某个页面了,可以直接传入一个内容Adapter。效果同上面是一样的
public class ListActivityTest extends ListActivity
{
@Override
public void onCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);
// 无需使用布局文件
String[] arr = { "孙悟空", "猪八戒", "唐僧" };
// 创建ArrayAdapter对象
ArrayAdapter<String> adapter = new ArrayAdapter<String>(this,
android.R.layout.simple_list_item_multiple_choice, arr);
// 设置该窗口显示列表
setListAdapter(adapter);
}
}
需要说明的是,在开发者指定的界面布局文件中应该包含一个id为“@+id/android:list”的ListView。
2、SimpleAdapter
ArrayAdapter的功能比较有限,每个列表项只能是TextView。如果需要实现更复杂的列表项,则需要考虑使用SimpleAdapter。
① 主布局文件(main.xml)定义一个ListView
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="horizontal"
android:layout_width="match_parent"
android:layout_height="wrap_content"
>
<!-- 定义一个List -->
<ListView android:id="@+id/mylist"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
/>
</LinearLayout>
②列表项对应的组件布局(simple_item.xml)
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="horizontal"
android:layout_width="match_parent"
android:layout_height="wrap_content">
<!-- 定义一个ImageView,用于作为列表项的一部分。 -->
<ImageView android:id="@+id/header"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:paddingLeft="10dp"
/>
<LinearLayout
android:orientation="vertical"
android:layout_width="match_parent"
android:layout_height="wrap_content">
<!-- 定义一个TextView,用于作为列表项的一部分。 -->
<TextView android:id="@+id/name"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:textSize="20dp"
android:textColor="#f0f"
android:paddingLeft="10dp"
/>
<!-- 定义一个TextView,用于作为列表项的一部分。 -->
<TextView android:id="@+id/desc"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:textSize="14dp"
android:paddingLeft="10dp"
/>
</LinearLayout>
</LinearLayout>
③Activity代码
public class SimpleAdapterTest extends Activity
{
private String[] names = new String[]
{ "虎头", "弄玉", "李清照", "李白"};
private String[] descs = new String[]
{ "可爱的小孩", "一个擅长音乐的女孩"
, "一个擅长的文学的女性", "浪漫主义诗人"};
private int[] imageIds = new int[]
{ R.drawable.tiger , R.drawable.nongyu
, R.drawable.qingzhao , R.drawable.libai};
@Override
public void onCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
// 创建一个List集合,List集合的元素是Map
List<Map<String, Object>> listItems =
new ArrayList<Map<String, Object>>();
for (int i = 0; i < names.length; i++)
{
Map<String, Object> listItem = new HashMap<String, Object>();
listItem.put("header", imageIds[i]);
listItem.put("personName", names[i]);
listItem.put("desc", descs[i]);
listItems.add(listItem);
}
// 创建一个SimpleAdapter
SimpleAdapter simpleAdapter = new SimpleAdapter(this, listItems,
R.layout.simple_item,
new String[] { "personName", "header" , "desc"},
new int[] { R.id.name, R.id.header , R.id.desc });
ListView list = (ListView) findViewById(R.id.mylist);
// 为ListView设置Adapter
list.setAdapter(simpleAdapter);
// 为ListView的列表项单击事件绑定事件监听器
list.setOnItemClickListener(new OnItemClickListener()
{
// 第position项被单击时激发该方法。
@Override
public void onItemClick(AdapterView<?> parent, View view,
int position, long id)
{
System.out.println(names[position]
+ "被单击了");
}
});
list.setOnItemSelectedListener(new OnItemSelectedListener()
{
// 第position项被选中时激发该方法。
@Override
public void onItemSelected(AdapterView<?> parent, View view,
int position, long id)
{
System.out.println(names[position]
+ "被选中了");
}
@Override
public void onNothingSelected(AdapterView<?> parent)
{
}
});
}
}
SimpleAdapter simpleAdapter = new SimpleAdapter(this, listItems,
R.layout.simple_item,
new String[] { "personName", "header" , "desc"},
new int[] { R.id.name, R.id.header , R.id.desc });
创建了一个SimpleAdapter对象,它需要5个参数,后面4个十分关键:
第2个:应该是一个List< ? extends Map<String,?>>类型的集合对象,该集合中,每个Map<String,?>对象生成一个列表项。
第3个:指定一个列表项组件的布局ID。
第4个:一个String[ ] 类型的参数,该参数决定了提取Map<String,?>对象中哪些Key对应的value来生成列表项。
第5个:一个int[ ] 类型的参数,该参数决定填充哪些组件
运行结果图:
3、BaseAdapter
扩展BaseAdapter可以取得Adapter的最大控制权,程序要创建多少列表项,每个列表项的组件都有开发者来决定。
①布局文件中还是只包含一个简单的ListView,省略
①布局文件中还是只包含一个简单的ListView,省略
②Activity代码:
public class BaseAdapterTest extends Activity
{
ListView myList;
@Override
public void onCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
myList = (ListView) findViewById(R.id.myList);
BaseAdapter adapter = new BaseAdapter()
{
@Override
public int getCount()
{
// 指定一共包含40个选项
return 40;
}
@Override
public Object getItem(int position)
{
return null;
}
// 重写该方法,该方法的返回值将作为列表项的ID
@Override
public long getItemId(int position)
{
return position;
}
// 重写该方法,该方法返回的View将作为列表框
@Override
public View getView(int position
, View convertView , ViewGroup parent)
{
// 创建一个LinearLayout,并向其中添加2个组件
LinearLayout line = new LinearLayout(BaseAdapterTest.this);
line.setOrientation(0);
ImageView image = new ImageView(BaseAdapterTest.this);
image.setImageResource(R.drawable.ic_launcher);
TextView text = new TextView(BaseAdapterTest.this);
text.setText("第" + (position +1 ) + "个列表项");
text.setTextSize(20);
text.setTextColor(Color.RED);
line.addView(image);
line.addView(text);
// 返回LinearLayout实例
return line;
}
};
myList.setAdapter(adapter);
}
}
扩展BaseAdapter对象需要重写4个方法:
- getCount() :该方法返回值控制多少列表项
- getItem(int position) :该方法返回值决定第position处的列表项内容
- getItemId(int position) :该方法返回值决定第position处的列表项的ID
- getView(int position ,View convertView ,ViewGroup parent) :该方法的返回值决定第position处的列表项组件
总之,使用Adapter的步骤:
① 创建Adapter ②调用AdapterView的setAdapter(Adapter)方法设置Adapter