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

Posted 2020-09-12 wgwyanfs

转载请标明出处：http://blog.csdn.net/lmj623565791/article/details/38902805 ，本文出自【张鸿洋的博客】

1、概述

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

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

2、常见的样例

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

1、布局文件

主布局文件：

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent" >

    <ListView
        android:id="@+id/id_lv_main"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent" />

</RelativeLayout>

Item的布局文件：

<?
xml version="1.0" encoding="utf-8"?>
<TextView xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/id_tv_title"
    android:layout_width="match_parent"
    android:layout_height="50dp"
    android:background="#aa111111"
    android:gravity="center_vertical"
    android:paddingLeft="15dp"
    android:textColor="#ffffff"
    android:text="hello"
    android:textSize="20sp"
    android:textStyle="bold" >

</TextView>

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<String> mDatas;

	public MyAdapter(Context context, List<String> 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<String> mDatas = new ArrayList<String>(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<View> mViews;
	private View mConvertView;

	private ViewHolder(Context context, ViewGroup parent, int layoutId,
			int position)
	{
		this.mViews = new SparseArray<View>();
		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 extends View> 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<T> extends BaseAdapter
{
	protected LayoutInflater mInflater;
	protected Context mContext;
	protected List<T> mDatas;

	public CommonAdapter(Context context, List<T> 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<T> extends CommonAdapter<T>
{
	public MyAdapter(Context context, List<T> 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<T> extends BaseAdapter
{
	protected LayoutInflater mInflater;
	protected Context mContext;
	protected List<T> mDatas;
	protected final int mItemLayoutId;

	public CommonAdapter(Context context, List<T> 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<String>(
				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<View> mViews;
	private int mPosition;
	private View mConvertView;

	private ViewHolder(Context context, ViewGroup parent, int layoutId,
			int position)
	{
		this.mPosition = position;
		this.mViews = new SparseArray<View>();
		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 extends View> 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<String>(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<String>(
				getApplicationContext(), mDatas, R.layout.item_single_str)
		{
			@Override
			public void convert(ViewHolder helper, String item)
			{
				helper.setText(R.id.id_tv_title,item);
			}

		});

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

2、来个复杂点的布局

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:background="#ffffff"
    android:orientation="vertical"
    android:padding="10dp" >

    <TextView
        android:id="@+id/tv_title"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:singleLine="true"
        android:text="红色钱包"
        android:textSize="16sp"
        android:textColor="#444444" >
    </TextView>

    <TextView
        android:id="@+id/tv_describe"
        android:layout_width="match_parent"