ListView通用Adapter

728 阅读4分钟
原文链接: www.fqxyi.com

本文用于实现一个通用的BaseAdapter类,统一产品的Adapter类,作为一个工具类,减少重复性工作,增加开发效率。

我们在开发项目的过程中,经常会用到ListView、GridView这一类的控件,从而不可避免的会用到BaseAtapter。然后我们必须实现那四个方法(getCount、getItem、getItemId、getView),编写类似的代码,实在是太繁琐了。因此,我们需要创建一个通用的BaseAdapter来解决我们的难题。

继承BaseAdapter

既然我们想要创建一个通用的BaseAdapter,那肯定需要继承于BaseAdapter,然后由于需要从外部传递data到adapter中进行处理,data的格式又是多样化的,所以我们需要使用泛型来解决这个问题,于是有了这样的代码:

public class CommonAdapter extends BaseAdapter {
    @Override
    public int getCount() {
        return 0;
    }

    @Override
    public Object getItem(int position) {
        return null;
    }

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

    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        return null;
    }
}

创建构造方法

接着就是同样的套路了,即创建构造方法,接收最为基本的上下文data。于是有了这样的代码:

protected Context context;
protected List<T> data;

public CommonAdapter(Context context, List<T> data) {
    this.context = context;
    this.data = data;
}

差点忘了还有布局文件了,如果你的SDK支持LayoutRes注解的话,那就再好不过了,只需要一行代码就可以搞定了:

public abstract @LayoutRes int getLayoutId();

如果不支持的话,也没有关系,从构造方法传入即可,但是这样其实不太好。

数据处理

得到外部传入的数据之后,我们需要在那四个方法中进行一些基本的操作了,如判空操作:

/**
 * @see android.widget.Adapter#getCount()
 */
@Override
public int getCount() {
    return null == data ? 0 : data.size();
}

/**
 * @see android.widget.Adapter#getItem(int)
 */
@Override
public T getItem(int position) {
    if (null == data || data.size() <= position) {
        return null;
    }
    return data.get(position);
}

/**
 * @see android.widget.Adapter#getItemId(int)
 */
@Override
public long getItemId(int position) {
    return position;
}

getView方法比较复杂,相对于其他三个方法而言,所以在这里就单独讲解,由于getView方法是需要ViewHolder类来进行协助管理的,所以在执行getView方法中的具体操作之前,需要先创建一个ViewHolder类

创建ViewHolder

获得ViewHolder实例

首先因为holder的相关操作都是在getView方法中执行的,所以,我们需要的参数有这么几个:position、convertView、parent,又因为我们之后需要在ViewHolder类中进行数据展示,所以必不可少的参数还有这两个:context、layoutId。有了这5个参数之后,我们就可以大干一场了:

我们可以创建一个静态方法,用于获取ViewHolder的实例,如下代码:

public static ViewHolder get(Context context, View convertView,
        ViewGroup parent, int layoutId, int position) {
    if (null == convertView) {
        return new ViewHolder(context, parent, layoutId, position);
    } else {
        ViewHolder holder = (ViewHolder) convertView.getTag();
        holder.mPosition = position;

        return holder;
    }
}

创建构造方法

根据上述代码,我们显然已经知道了构造方法的内容了,如下所示:

public ViewHolder(Context context, ViewGroup parent, int layoutId, int position) {
    this.mPosition = position;
    this.mConvertView = LayoutInflater.from(context).inflate(layoutId, parent, false);
    this.mConvertView.setTag(this);
}

getView

既然我们已经处理好了ViewHolder类,那么现在就让我们来解决getView这个问题吧!其实我们只需要执行以下三步就可以了:

  1. 获得ViewHolder实例;
  2. 将需要传递出去的ViewHolder实例、指定位置的数据传递出去;
  3. 返回ViewHolder中获得的mConvertView

即如下代码:

/**
 * @see android.widget.Adapter#getView(int, View, ViewGroup)
 */
@Override
public View getView(int position, View convertView, ViewGroup parent) {
    ViewHolder holder = ViewHolder.get(context, convertView, parent, getLayoutId(), position);

    convert(holder, getItem(position), position);

    return holder.getConvertView();
}

public abstract void convert(ViewHolder holder, T t, int position);

显示数据

最后让我们重新回到ViewHolder类中,之前我已经说过了,我们需要在ViewHolder类中展示数据,所以我们需要创建一个方法,用于支持通过viewId获取控件

这意味着我们需要将通过mConvertView.findViewById(viewId)获得的数据存储起来,然后在需要用到的地方取出来,这个时候你也许想起了,这不就是map么,是的,不过我不建议用map进行操作,这里我使用的SparseArray

存储View

这里我们首先需要在构造方法中创建SparseArray的实例,并将其定义为全局变量。

public <T extends View>T getView(int viewId) {
    View view = mViews.get(viewId);

    if (null == view) {
        view = mConvertView.findViewById(viewId);
        mViews.put(viewId, view);
    }

    return (T) view;
}

获取View

进行数据展示的操作有很多种,这里我就以最简单的显示文字内容为例:

public ViewHolder setText(int viewId, String text) {
    TextView tv = getView(viewId);
    tv.setText(text);
    return this;
}

这句话表明当我们在自己的adapter类中重写了convert方法后,只需要使用holder实例,调用setText方法,并传递viewId和text内容就可以正常显示文本了!

总结

对于获取View那一节,你可能会觉得比较麻烦,因为之后想要显示图片,我要在ViewHolder类中添加一个显示图片方法;想要设置背景,还需要在ViewHolder类中添加一个设置背景的方法......我想说这其实并没有什么,因为这对于整个项目都是通用的,只要设置一遍就可以了,如果你不想让ViewHoder类发生变化,也可以使用下面的方式试试提取出来:

/**
 * 通过viewId获取控件
 * @param viewId
 * @param <T>
 * @return
 */
public <T extends View>T findViewById(int viewId) {
    View view = mViews.get(viewId);

    if (null == view) {
        view = mConvertView.findViewById(viewId);
        mViews.put(viewId, view);
    }

    return (T) view;
}