Android快速开发之设计通用的ListView，GridView的适配器

概述

在Android开发的时候，经常会使用ListView或GridView来显示数据，这时就需要写对应的适配器Adapter。如果针对每个ListView或者GridView都去创建一个适配器时，那么就会出现一大堆的重复的代码。为了体现代码的简洁性，我们可以设计一个通用的适配器来避免里面重复的逻辑。

常规实现

我们先列出常规适配器的使用方法，通过分析常见的使用方式，来分析设计出通用的适配器。
1.布局文件first_activity.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="horizontal" >

    <ListView
        android:id="@+id/listView"
        android:layout_width="match_parent"
        android:layout_height="match_parent" >
    </ListView>

</LinearLayout>

2.Activity类中代码

package com.yuminfeng.test;

import java.util.ArrayList;
import java.util.List;
import com.yuminfeng.adapter.MyAdapter;
import android.app.Activity;
import android.os.Bundle;
import android.widget.ListView;

public class FirstActivity extends Activity{

    private ListView listView;
    private List<String> datas; //listview中的数据源
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.first_activity);

        listView = (ListView) findViewById(R.id.listView);
        datas = new ArrayList<String>();
        for (int i = 0; i < 5; i++) {
            datas.add("Hello "+i);
        }
        MyAdapter adapter = new MyAdapter(this);
        adapter.setDataSource(datas);
        listView.setAdapter(adapter);
    }

}

3.ListView中item的布局文件item_listview.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
        android:id="@+id/textView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="10dp"
        android:textSize="20sp" />

</LinearLayout>

4.ListView的自定义Adapter类MyAdapter.java

package com.yuminfeng.adapter;

import java.util.ArrayList;
import java.util.List;

import com.yuminfeng.test.R;
import android.content.Context;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.BaseAdapter;
import android.widget.TextView;

public class MyAdapter extends BaseAdapter{

    private Context context;

    private List<String> datas = new ArrayList<String>();

    public MyAdapter(Context context){
        this.context = context;
    }

    /**
     * 添加数据源
     * @param datas
     */
    public void setDataSource(List<String> datas) {
        setDataSource(datas,true);
    }

    /**
     * 添加数据源
     * @param datas
     * @param isClear true：清除之前的数据源，false：追加数据源
     */
    public void setDataSource(List<String> datas,boolean isClear) {
        if(isClear){
            this.datas.clear();
        }
        this.datas.addAll(datas);
        notifyDataSetChanged();
    }

    @Override
    public int getCount() {
        return datas.size();
    }

    @Override
    public Object getItem(int position) {
        return datas.get(position);
    }

    @Override
    public long getItemId(int position) {
        return position;
    }

    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        ViewHolder viewHolder = null;
        if(convertView == null){
            convertView = LayoutInflater.from(context).inflate(R.layout.item_listview, parent,false);
            viewHolder = new ViewHolder(convertView);
            convertView.setTag(viewHolder);
        }else{
            viewHolder = (ViewHolder) convertView.getTag();
        }
        viewHolder.textView.setText(datas.get(position));
        return convertView;
    }

    public class ViewHolder{
        private TextView textView;
        public ViewHolder(View convertView){
            this.textView = (TextView) convertView.findViewById(R.id.textView);
        }
    }
}

以上就是实现ListView显示数据的基本写法，如果有10个ListView那么就会有10个这样的适配器，这10个适配器中存在大量重复的代码。为了避免这种情况，我们需要设计出一个通用的适配器，在这个通用的适配器的基础上，我们在进行不同的业务操作。

设计通用的适配器

首先分析Adapter中的包含元素：
填充布局时，需要用到Context；
需要List来存储显示的数据源；
需要布局文件来作为ListView的item；
需要ViewHolder类来优化ListView的性能；
以上几项，都是根据不同的ListView，来做不同的处理，其他重写的BaseAdapter的方法都是固定的。所以只要抽出上述的参数，灵活的进行处理，这就是设计通用的适配器的思想。
了解完了之后，我们的代码如下：

package com.yuminfeng.adapter;

import java.util.ArrayList;
import java.util.List;
import android.content.Context;
import android.util.SparseArray;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.BaseAdapter;

public abstract class CommonAdapter<E> extends BaseAdapter {

    //context
    private Context context;
    //数据源
    private List<E> mDatas = new ArrayList<E>();
    //item的layout布局 id
    private int layoutResId;

    public CommonAdapter(Context context,int layoutResId) {
        this.context = context;
        this.layoutResId = layoutResId;
    }

    /**
     * 添加数据源
     * @param data
     */
    public void setDataSource(List<E> data) {
        setDataSource(data, true);
    }

    /**
     * 添加数据源
     * @param data
     * @param isClear true:清除之前的数据源，false:追加数据源
     */
    public void setDataSource(List<E> data, boolean isClear) {
        if(isClear){
            mDatas.clear();
        }
        mDatas.addAll(data);
        notifyDataSetChanged();
    }

    /**
     * 只添加一个数据
     * @param data
     */
    public void addData(E data){
        mDatas.add(data);
        notifyDataSetChanged();
    }

    /**
     * 移除对象data的数据
     * @param data
     */
    public void removeData(E data){
        mDatas.remove(data);
        notifyDataSetChanged();
    }

    /**
     * 通过对象移除一条数据
     * @param position
     */
    public void removeData(int position){
        mDatas.remove(position);
        notifyDataSetChanged();
    }

    @Override
    public int getCount() {
        return mDatas.size();
    }

    @Override
    public E getItem(int position) {
        return mDatas.get(position);
    }

    @Override
    public long getItemId(int position) {
        return position;
    }

    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        BaseViewHolder viewHolder = null;
        if(convertView == null){
            viewHolder = createViewHolder(parent,layoutResId);
            if(viewHolder == null || viewHolder.getConvertView() == null){
                throw new NullPointerException("createViewHolder不能返回null");
            }
            convertView = viewHolder.getConvertView();
            convertView.setTag(viewHolder);
        }else{
            viewHolder = (BaseViewHolder) convertView.getTag();
        }
        bindViewHolder(viewHolder, position, getItem(position));

        return viewHolder.getConvertView();
    }

    private BaseViewHolder createViewHolder(ViewGroup parent,int layoutResId){
        View convertView = LayoutInflater.from(context).inflate(layoutResId, parent,false);
        return new BaseViewHolder(convertView);
    }

    protected abstract void bindViewHolder(BaseViewHolder viewHolder,int position,E data);

    public static class BaseViewHolder{
        private View convertView;
        private SparseArray<View> views = new SparseArray<View>();

        public BaseViewHolder(View convertView){
            this.convertView = convertView;
        }

        public View getConvertView(){
            return convertView;
        }

        /**
         * 根据View的id，取到View的对象
         * @param viewId
         * @return
         */
        @SuppressWarnings("unchecked")
        public <V> V getView(int viewId){
            View view = views.get(viewId);
            if(view == null){
                view = convertView.findViewById(viewId);
                views.put(viewId, view);
            }
            return (V) view;
        }
    }

}

上面便是设计的一个通用的适配器类，这是个抽象类。
实现时，首先继承这个类，然后重写里面的抽象方法bindViewHolder。这个方法是开放给外部的回调方法，用来设置具体的item数据。还有在创建这个子类的对象时，传入两个参数：上下文context，和布局item的id。
我们来看它的子类对象，如下：

package com.yuminfeng.adapter;

import java.util.Map;
import com.yuminfeng.test.R;
import android.content.Context;
import android.widget.ImageView;
import android.widget.TextView;

public class MyAdapter extends CommonAdapter<Map<String, Object>>{

    public MyAdapter(Context context, int layoutResId) {
        super(context, layoutResId);
    }

    @Override
    protected void bindViewHolder(BaseViewHolder viewHolder,int position, Map<String, Object> data) {
        TextView title = viewHolder.getView(R.id.title);
        TextView content = viewHolder.getView(R.id.content);
        TextView time = viewHolder.getView(R.id.time);
        ImageView image = viewHolder.getView(R.id.imageView);

        title.setText((String)data.get("title"));
        content.setText((String)data.get("content"));
        time.setText((String)data.get("time"));
        image.setImageResource((Integer)data.get("icon"));
    }

}

上面的类非常简单，就是给具体的item中的View设置值，其它继承CommonAdapter类的子类，也是一样的操作。
我们再看Activity中的调用，如下：

package com.yuminfeng.test;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import com.yuminfeng.adapter.MyAdapter;
import android.app.Activity;
import android.os.Bundle;
import android.widget.ListView;

public class FirstActivity extends Activity{

    private ListView listView;
    private List<Map<String, Object>> datas; //listview中的数据源
    private int[] imageIds = new int[]{R.drawable.pic1,R.drawable.pic2,R.drawable.pic3,R.drawable.pic4,R.drawable.pic5};
     @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.first_activity);

        listView = (ListView) findViewById(R.id.listView);
        datas = new ArrayList<Map<String, Object>>();

        for (int i = 0; i < imageIds.length; i++) {
            Map<String, Object> map = new HashMap<String, Object>();
            map.put("icon",imageIds[i] );
            map.put("title","美女"+i+"只");
            map.put("content","这是内容，这是内容");
            map.put("time","20160428");
            datas.add(map);
        }
        MyAdapter adapter = new MyAdapter(this, R.layout.item_listview_more);
        adapter.setDataSource(datas);

        listView.setAdapter(adapter);
    }
}

以上也是非常简单的逻辑，创建MyAdapter类，传入context和布局item。然后设置数据源后，直接使用即可。
这样就将之前重复的逻辑全部封装到抽象类CommonAdapter中，现在不需要关心了，继承该类后，只需绑定item中每个View的数据就可以了。