Android 快速开发系列打造万能的ListView GridView 适配器

阅读量：5820 次

发布时间：2019-06-18

本文共 13933 字，大约阅读时间需要 46 分钟。

转载请标明出处：，本文出自

1、概述

相信做Android开发的写得最多的就是ListView，GridView的适配器吧，记得以前开发一同事开发项目，一个项目下来基本就一直在写ListView的Adapter都快吐了~~~对于Adapter一般都继承BaseAdapter复写几个方法，getView里面使用ViewHolder模式，其实大部分的代码基本都是类似的。

本篇博客为快速开发系列的第一篇，将一步一步带您封装出一个通用的Adapter。

2、常见的例子

首先看一个最常见的案例，大家一目十行的扫一眼

1、布局文件

主布局文件：

Item的布局文件：

2、Adapter

package com.example.zhy_baseadapterhelper;import java.util.List;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 LayoutInflater mInflater;	private Context mContext;	private List
    
      mDatas;	public MyAdapter(Context context, List
     
       mDatas)	{		mInflater = LayoutInflater.from(context);		this.mContext = context;		this.mDatas = mDatas;	}	@Override	public int getCount()	{		return mDatas.size();	}	@Override	public Object 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)	{		ViewHolder viewHolder = null;		if (convertView == null)		{			convertView = mInflater.inflate(R.layout.item_single_str, parent,					false);			viewHolder = new ViewHolder();			viewHolder.mTextView = (TextView) convertView					.findViewById(R.id.id_tv_title);			convertView.setTag(viewHolder);		} else		{			viewHolder = (ViewHolder) convertView.getTag();		}		viewHolder.mTextView.setText(mDatas.get(position));		return convertView;	}	private final class ViewHolder	{		TextView mTextView;	}}

3、Activity

package com.example.zhy_baseadapterhelper;import java.util.ArrayList;import java.util.Arrays;import java.util.List;import android.app.Activity;import android.os.Bundle;import android.widget.ListView;public class MainActivity extends Activity{	private ListView mListView;	private List
    
      mDatas = new ArrayList
     
      (Arrays.asList("Hello",			"World", "Welcome"));	private MyAdapter mAdapter;	@Override	protected void onCreate(Bundle savedInstanceState)	{		super.onCreate(savedInstanceState);		setContentView(R.layout.activity_main);		mListView = (ListView) findViewById(R.id.id_lv_main);		mListView.setAdapter(mAdapter = new MyAdapter(this, mDatas));	}}

上面这个例子大家应该都写了无数遍了，MyAdapter集成BaseAdapter，然后getView里面使用ViewHolder模式；一般情况下，我们的写法是这样的：对于不同布局的ListView，我们会有一个对应的Adapter，在Adapter中又会有一个ViewHolder类来提高效率。

这样出现ListView就会出现与之对于的Adapter类、ViewHolder类；那么有没有办法减少我们的编码呢？

下面首先拿ViewHolder开刀~

3、通用的ViewHolder

首先分析下ViewHolder的作用，通过convertView.setTag与convertView进行绑定，然后当convertView复用时，直接从与之对于的ViewHolder(getTag)中拿到convertView布局中的控件，省去了findViewById的时间~

也就是说，实际上们每个convertView会绑定一个ViewHolder对象，这个viewHolder主要用于帮convertView存储布局中的控件。

那么我们只要写出一个通用的ViewHolder，然后对于任意的convertView，提供一个对象让其setTag即可；

既然是通用，那么我们这个ViewHolder就不可能含有各种控件的成员变量了，因为每个Item的布局是不同的，最好的方式是什么呢？

提供一个容器，专门存每个Item布局中的所有控件，而且还要能够查找出来；既然需要查找，那么ListView肯定是不行了，需要一个键值对进行保存，键为控件的Id，值为控件的引用，相信大家立刻就能想到Map；但是我们不用Map，因为有更好的替代类，就是我们android提供的SparseArray这个类，和Map类似，但是比Map效率，不过键只能为Integer.

下面看我们的ViewHolder类：

package com.example.zhy_baseadapterhelper;import android.content.Context;import android.util.Log;import android.util.SparseArray;import android.view.LayoutInflater;import android.view.View;import android.view.ViewGroup;public class ViewHolder{	private final SparseArray
    
      mViews;	private View mConvertView;	private ViewHolder(Context context, ViewGroup parent, int layoutId,			int position)	{		this.mViews = new SparseArray
     
      ();		mConvertView = LayoutInflater.from(context).inflate(layoutId, parent,				false);		//setTag		mConvertView.setTag(this);					}	/**	 * 拿到一个ViewHolder对象	 * @param context	 * @param convertView	 * @param parent	 * @param layoutId	 * @param position	 * @return	 */	public static ViewHolder get(Context context, View convertView,			ViewGroup parent, int layoutId, int position)	{			if (convertView == null)		{			return new ViewHolder(context, parent, layoutId, position);		}		return (ViewHolder) convertView.getTag();	}	/**	 * 通过控件的Id获取对于的控件，如果没有则加入views	 * @param viewId	 * @return	 */	public 
      
        T getView(int viewId)	{				View view = mViews.get(viewId);		if (view == null)		{			view = mConvertView.findViewById(viewId);			mViews.put(viewId, view);		}		return (T) view;	}	public View getConvertView()	{		return mConvertView;	}	}

与传统的ViewHolder不同，我们使用了一个SparseArray<View>用于存储与之对于的convertView的所有的控件，当需要拿这些控件时，通过getView(id)进行获取；

下面看使用该ViewHolder的MyAdapter；

@Override	public View getView(int position, View convertView, ViewGroup parent)	{		//实例化一个viewHolder		ViewHolder viewHolder = ViewHolder.get(mContext, convertView, parent,				R.layout.item_single_str, position);		//通过getView获取控件		TextView tv = viewHolder.getView(R.id.id_tv_title);		//使用		tv.setText(mDatas.get(position));		return viewHolder.getConvertView();	}

只看getView，其他方法都一样；首先调用ViewHolder的get方法，如果convertView为null，new一个ViewHolder实例，通过使用mInflater.inflate加载布局，然后new一个SparseArray用于存储View，最后setTag(this)；

如果存在那么直接getTag

最后通过getView(id)获取控件，如果存在则直接返回，否则调用findViewById，返回存储，返回。

好了，一个通用的ViewHolder写好了，以后一个项目几十个Adapter一个ViewHolder直接hold住全场~~大家可以省点时间斗个小地主了~~

4、打造通用的Adapter

有了通用的ViewHolder大家肯定不能满足，怎么也得省出dota的时间，人在塔在~~

下面看如何打造一个通过的Adapter，我们叫做CommonAdapter

继续分析，Adapter一般需要保持一个List对象，存储一个Bean的集合，不同的ListView，Bean肯定是不同的，这个CommonAdapter肯定需要支持泛型，内部维持一个List<T>，就解决我们的问题了；

于是我们初步打造我们的CommonAdapter

package com.example.zhy_baseadapterhelper;import java.util.List;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 abstract class CommonAdapter
    
      extends BaseAdapter{	protected LayoutInflater mInflater;	protected Context mContext;	protected List
     
       mDatas;	public CommonAdapter(Context context, List
      
        mDatas)	{		mInflater = LayoutInflater.from(context);		this.mContext = context;		this.mDatas = mDatas;	}	@Override	public int getCount()	{		return mDatas.size();	}	@Override	public Object getItem(int position)	{		return mDatas.get(position);	}	@Override	public long getItemId(int position)	{		return position;	}}

我们的CommonAdapter依然是一个抽象类，除了getView以外我们把其他的代码都实现了，这样的话，在使用我们的Adapter只要实现一个getView，然后getView里面再使用我们打造的通过的ViewHolder是不是感觉还不错~

现在我们的MyAdapter是这样的：

package com.example.zhy_baseadapterhelper;import java.util.List;import android.content.Context;import android.view.View;import android.view.ViewGroup;import android.widget.TextView;public class MyAdapter
    
      extends CommonAdapter
     
      {	public MyAdapter(Context context, List
      
        mDatas)	{		super(context, mDatas);	}	@Override	public View getView(int position, View convertView, ViewGroup parent)	{		ViewHolder viewHolder = ViewHolder.get(mContext, convertView, parent,				R.layout.item_single_str, position);		TextView mTitle = viewHolder.getView(R.id.id_tv_title);		mTitle.setText((String) mDatas.get(position));		return viewHolder.getConvertView();	}}

所有的代码加起来也就10行左右，是不是神清气爽~~稍等，我先去dota一把~

但是我们是否就这样满足了呢？显然还可以简化。

5、进一步铸造

注意我们的getView里面的代码，虽然只有4行，但是我觉得所有的Adapter的

第一行（ViewHolder viewHolder = getViewHolder(position, convertView,parent);）和

最后一行：return viewHolder.getConvertView();一定是一样的。

那么我们可以这样做：我们把第一行和最后一行写死，把中间变化的部分抽取出来，这不就是OO的设计原则嘛。现在CommonAdapter是这样的：

package com.example.zhy_baseadapterhelper;import java.util.List;import android.content.Context;import android.view.LayoutInflater;import android.view.View;import android.view.ViewGroup;import android.widget.BaseAdapter;public abstract class CommonAdapter
    
      extends BaseAdapter{	protected LayoutInflater mInflater;	protected Context mContext;	protected List
     
       mDatas;	protected final int mItemLayoutId;	public CommonAdapter(Context context, List
      
        mDatas, int itemLayoutId)	{		this.mContext = context;		this.mInflater = LayoutInflater.from(mContext);		this.mDatas = mDatas;		this.mItemLayoutId = itemLayoutId;	}	@Override	public int getCount()	{		return mDatas.size();	}	@Override	public T 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)	{		final ViewHolder viewHolder = getViewHolder(position, convertView,				parent);		convert(viewHolder, getItem(position));		return viewHolder.getConvertView();	}	public abstract void convert(ViewHolder helper, T item);	private ViewHolder getViewHolder(int position, View convertView,			ViewGroup parent)	{		return ViewHolder.get(mContext, convertView, parent, mItemLayoutId,				position);	}}

对外公布了一个convert方法，并且还把viewHolder和本Item对于的Bean对象给传出去，现在convert方法里面需要干嘛呢？

通过ViewHolder把View找到，通过Item设置值；

现在我觉得代码简化到这样，我已经不需要单独写一个Adapter了，直接MainActivity匿名内部类走起~

@Override	protected void onCreate(Bundle savedInstanceState)	{		super.onCreate(savedInstanceState);		setContentView(R.layout.activity_main);		mListView = (ListView) findViewById(R.id.id_lv_main);		//设置适配器		mListView.setAdapter(mAdapter = new CommonAdapter
    
     (				getApplicationContext(), mDatas, R.layout.item_single_str)		{			@Override			public void convert(ViewHolder c, String item)			{				TextView view = viewHolder.getView(R.id.id_tv_title);				view.setText(item);			}		});	}

可以看到效果咋样，不错吧。你觉得还能简化么？我觉得还能改善。

6、Adapter最后的封魔

我们现在在convertView里面需要这样:

@Override

public void convert(ViewHolder viewHolder, String item)

{

TextView view = viewHolder.getView(R.id.id_tv_title);

view.setText(item);

}

我们细想一下，其实布局里面的View常用也就那么几种：ImageView,TextView,Button,CheckBox等等；

那么我觉得ViewHolder还可以封装一些常用的方法，比如setText(id,String)；setImageResource(viewId, resId)；setImageBitmap(viewId, bitmap)；

那么现在ViewHolder是：

package com.example.zhy_baseadapterhelper;import android.content.Context;import android.graphics.Bitmap;import android.util.SparseArray;import android.view.LayoutInflater;import android.view.View;import android.view.ViewGroup;import android.widget.ImageView;import android.widget.TextView;import com.example.zhy_baseadapterhelper.ImageLoader.Type;public class ViewHolder{	private final SparseArray
    
      mViews;	private int mPosition;	private View mConvertView;	private ViewHolder(Context context, ViewGroup parent, int layoutId,			int position)	{		this.mPosition = position;		this.mViews = new SparseArray
     
      ();		mConvertView = LayoutInflater.from(context).inflate(layoutId, parent,				false);		// setTag		mConvertView.setTag(this);	}	/**	 * 拿到一个ViewHolder对象	 * 	 * @param context	 * @param convertView	 * @param parent	 * @param layoutId	 * @param position	 * @return	 */	public static ViewHolder get(Context context, View convertView,			ViewGroup parent, int layoutId, int position)	{		if (convertView == null)		{			return new ViewHolder(context, parent, layoutId, position);		}		return (ViewHolder) convertView.getTag();	}	public View getConvertView()	{		return mConvertView;	}	/**	 * 通过控件的Id获取对于的控件，如果没有则加入views	 * 	 * @param viewId	 * @return	 */	public 
      
        T getView(int viewId)	{		View view = mViews.get(viewId);		if (view == null)		{			view = mConvertView.findViewById(viewId);			mViews.put(viewId, view);		}		return (T) view;	}	/**	 * 为TextView设置字符串	 * 	 * @param viewId	 * @param text	 * @return	 */	public ViewHolder setText(int viewId, String text)	{		TextView view = getView(viewId);		view.setText(text);		return this;	}	/**	 * 为ImageView设置图片	 * 	 * @param viewId	 * @param drawableId	 * @return	 */	public ViewHolder setImageResource(int viewId, int drawableId)	{		ImageView view = getView(viewId);		view.setImageResource(drawableId);		return this;	}	/**	 * 为ImageView设置图片	 * 	 * @param viewId	 * @param drawableId	 * @return	 */	public ViewHolder setImageBitmap(int viewId, Bitmap bm)	{		ImageView view = getView(viewId);		view.setImageBitmap(bm);		return this;	}	/**	 * 为ImageView设置图片	 * 	 * @param viewId	 * @param drawableId	 * @return	 */	public ViewHolder setImageByUrl(int viewId, String url)	{		ImageLoader.getInstance(3, Type.LIFO).loadImage(url,				(ImageView) getView(viewId));		return this;	}	public int getPosition()	{		return mPosition;	}}

现在的MainActivity只需要这么写：

mAdapter = new CommonAdapter
    
     (getApplicationContext(),				R.layout.item_single_str, mDatas)		{			@Override			protected void convert(ViewHolder viewHolder, String item)			{				viewHolder.setText(R.id.id_tv_title, item);			}		};

convertView里面只要一行代码了~~~

好了，到此我们的通用的Adapter已经一步一步铸造完毕~咋样，以后写项目省下来的时间是不是可以陪我切磋dota了（ps:11昵称：血魔哥404）~~

注：关于ViewHolder里面的setText，setImageResource这类的方法，大家可以在使用的过程中不断的完善，今天发现这个控件可以这么设置值，好，放进去；时间长了，基本就完善了。还有那个ImageLoader是我另一篇博客里的，大家可以使用UIL，Volley或者自己写个图片加载器；

7、实践

说了这么多，还是得拿出来让我们的实践检验检验，顺便来几张套图，俗话说，没图没正相。

1、我们的实例代码的图是这样的：

关于Adapter和ViewHolder的代码是这样的：

// 设置适配器		mListView.setAdapter(mAdapter = new CommonAdapter
    
     (				getApplicationContext(), mDatas, R.layout.item_single_str)		{			@Override			public void convert(ViewHolder helper, String item)			{				helper.setText(R.id.id_tv_title,item);			}		});

哎哟，我是不是只要贴一行；

2、来个复杂点的布局

效果图是这样的：

布局是不是挺复杂的了~~

但是代码是这样的：

// 设置适配器		mListView.setAdapter(mAdapter = new CommonAdapter
    
     (				getApplicationContext(), mDatas, R.layout.item_list)		{			@Override			public void convert(ViewHolder helper, Bean item)			{				helper.setText(R.id.tv_title, item.getTitle());				helper.setText(R.id.tv_describe, item.getDesc());				helper.setText(R.id.tv_phone, item.getPhone());				helper.setText(R.id.tv_time, item.getTime());				//				helper.getView(R.id.tv_title).setOnClickListener(l)			}		});

从一个字符串的布局到这样的布局，Adapter加ViewHolder的改变就这么多，加起来3行左右代码~~~

到此，Android 快速开发系列打造万能的ListView GridView 适配器结束；

最后给大家推荐一个gitHub项目：https://github.com/JoanZapata/base-adapter-helper ,这个项目所做的，和我上面写的基本一致。

还有上面的布局文件来自网络，感谢Bmob的提供~

好了，我要去快乐的玩耍了~~