Android打造ListView和GridView万能适配器

本篇博客是我学习过慕课网的《Android-打造万能适配器》课程后的学习笔记

一、传统方式分析

  传统写法下，我们几乎每个ListView都会单独写一个Adapter和一个ViewHolder，分析代码可以发现，传统的Adapter里有很多的重复性代码，比如说getCount()、getItem(int position)、getItemId(int position)，传统Adapter写法如下：

package com.gcy.universal_adapter.utils;

import android.content.Context;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.BaseAdapter;
import android.widget.TextView;

import com.gcy.universal_adapter.Bean;
import com.gcy.universal_adapter.R;

import java.util.List;

/**
* Created by gcy71 on 2016/9/27.
*/

public class MyAdapter extends BaseAdapter {
private Context mContext;
private List<Bean> mDatas;
private LayoutInflater mInflater;
public MyAdapter(Context context , List<Bean> datas){
this.mContext = context;
this.mDatas = datas;
this.mInflater = LayoutInflater.from(mContext);
}

@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_listview , parent , false);
viewHolder = new ViewHolder();

viewHolder.mTilte = (TextView) convertView.findViewById(R.id.id_title);
viewHolder.mInfo = (TextView) convertView.findViewById(R.id.id_info);
viewHolder.mTime = (TextView) convertView.findViewById(R.id.id_time);
Bean bean = mDatas.get(position);
viewHolder.mTilte.setText(bean.getTitle());
viewHolder.mInfo.setText(bean.getInfo());
viewHolder.mTime.setText(bean.getTime());

convertView.setTag(viewHolder);
}else{
viewHolder = (ViewHolder) convertView.getTag();
Bean bean = mDatas.get(position);
viewHolder.mTilte.setText(bean.getTitle());
viewHolder.mInfo.setText(bean.getInfo());
viewHolder.mTime.setText(bean.getTime());
}
return convertView;
}

class ViewHolder{
TextView mTilte;
TextView mInfo;
TextView mTime;

}
}

二、封装ViewHolder

分析传统Adapter的getView方法可以知道我们需要position、convertView、parent、mContext、layoutID(布局文件的ID)这几个参数，这些参数都应该出现在BaseAdapter的构造方法中,由于创建ViewHolder的时候convertView为空，所以可以省略不传。

由于我们不需要每次都重新创建一个BaseViewHolder对象，在传统Adapter我的们做法是将ViewHolder放在convertView的Tag中，这里我们也可以参照这种方式，向用户抛出一个getViewHolder方法，当convertView不为空的时候我们便不再重新new一个BaseViewHolder。

一个ListView（GridView）通常都包含多个控件，所以我们需要一个容器来存储这些控件，而这个容器我们很容易就会想到用Map，在本例中我们使用SparseArray充当这个容器，SparseArray继承自Map，而且效率比我们常用的HashMap更高，这也是我们选择它的理由。

在Adapter的getView方法中我们将convertView作为返回值，所以我们还需要向用户抛出一个获取convertView的方法分别getConvertView。

由于用户还需要为控件设置值和点击事件，所以我们需要向用户抛出一个通过ID获取控件的方法，称之为getView，这个方法的参数为控件的ID

为了减少用户为控件设置值的代码，我们还可以为用户添加一些辅助方法，例如本例中的setText2TextView ，用户可根据自己的需要在BaseViewHolder类中增添多个辅助方法（例如：为ImageView设置图片等）。

BaseViewHolder.java

package com.gcy.universal_adapter.utils;

import android.content.Context;
import android.util.SparseArray;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.TextView;

/**
* Created by gcy71 on 2016/9/26.
*/

public class BaseViewHolder {

/*用于存储各类控件的容器*/
private SparseArray<View> mViews;

private View mConvertView;

private int mPosition;

public BaseViewHolder(Context context , ViewGroup parent , int layoutID , int position) {
mViews = new SparseArray<View>();
mPosition = position;
mConvertView = LayoutInflater.from(context).inflate(layoutID , parent ,false);
mConvertView.setTag(this);
}

/*抛出一个get方法,不用每次都new一个ViewHolder,可通过此方法来获取一个*/
public static BaseViewHolder getViewHolder(Context context , ViewGroup parent , int layoutID , int position , View convertView){
if(convertView == null){
return new BaseViewHolder(context , parent , layoutID , position);
}else{
BaseViewHolder holder = (BaseViewHolder) convertView.getTag();
holder.mPosition = position;
return holder;
}
}

/*用户可通过View的ID来获取控件，替代传统Adapter中利用convertView.findViewByID()获取控件*/
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;
}

/**
* 辅助方法，减少用户为控件设置值的代码
*/
//为了实现链式编程我们此处将返回值的类型设置为BaseViewHolder，返回本身即可
public BaseViewHolder setText2TextView(int ViewID , String text){
((TextView)getView(ViewID)).setText(text);
return this;
}
}

三、封装Adapter

  经过对ViewHolder的封装后我们会发现我们将传统Adapter中的getView方法的代码量缩减了不少，如下所示 :

public View getView(int position, View convertView, ViewGroup parent) {
BaseViewHolder viewHolder = BaseViewHolder.getViewHolder(mContext , parent , R.layout.item_listview , position , convertView);
Bean bean = mDatas.get(position);
((TextView)viewHolder.getView(R.id.id_title)).setText(bean.getTitle());
((TextView)viewHolder.getView(R.id.id_info)).setText(bean.getInfo());
((TextView)viewHolder.getView(R.id.id_time)).setText(bean.getTime());

return viewHolder.getConvertView();
}

  但是我们发现，上面提到的传统Adapter中的重复方法并没有被封装，再仔细看一下还会发现，在上方的getView方法中初始化BaseViewHolder和最后返回返回值的语句基本上保持一致，所以我们对Adapter也进行封装

package com.gcy.universal_adapter.utils;

import android.content.Context;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.BaseAdapter;

import com.gcy.universal_adapter.R;

import java.util.List;

/**
* Created by gcy71 on 2016/9/27.
*/

public abstract class MyBaseAdapter<T> extends BaseAdapter {

private Context mContext;
private List<T> mDatas;
private LayoutInflater mInflater;

public MyBaseAdapter(Context context , List<T> datas) {
this.mContext = context;
this.mDatas = datas;
this.mInflater = LayoutInflater.from(mContext);
}

@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) {
BaseViewHolder viewHolder = BaseViewHolder.getViewHolder(mContext , parent , R.layout.item_listview , position , convertView);
convert(viewHolder , mDatas.get(position));
return viewHolder.getConvertView();
}

public abstract void convert(BaseViewHolder viewHolder , T t);
}

  这里的MyBaseAdapter是一个抽象类，包含了convert(BaseViewHolder viewHolder , T t)这个抽象方法,该方法抛给用户自己实现，是为了让用户设置控件值和点击事件，使用泛型T是因为每个ListView(GridView)都有可能是用不同的数据类型，到此我们的万能适配器已经基本实现。

四、测试

以下为本例的测试效果：

activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/activity_main"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:paddingBottom="@dimen/activity_vertical_margin"
android:paddingLeft="@dimen/activity_horizontal_margin"
android:paddingRight="@dimen/activity_horizontal_margin"
android:paddingTop="@dimen/activity_vertical_margin">
<ListView
android:id="@+id/id_listview"
android:layout_width="match_parent"
android:layout_height="wrap_content">

</ListView>

</RelativeLayout>

item_listview.xml

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/activity_main"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:paddingBottom="@dimen/activity_vertical_margin"
android:paddingLeft="@dimen/activity_horizontal_margin"
android:paddingRight="@dimen/activity_horizontal_margin"
android:paddingTop="@dimen/activity_vertical_margin">
<TextView
android:id="@+id/id_title"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:textSize="16sp"
android:text="我是标题"
android:textColor="#444"/>
<TextView
android:id="@+id/id_info"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_below="@id/id_title"
android:minLines="1"
android:maxLines="2"
android:text="Android打造万能的ListView和GridView适配器"
android:textColor="#898989"
android:textSize="16sp"/>

<TextView
android:id="@+id/id_time"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_below="@id/id_info"
android:minLines="1"
android:maxLines="2"
android:text="2016-09-26"
android:textColor="#898989"
android:textSize="12sp"/>

</RelativeLayout>

Bean.java（本例所使用的实体类）

package com.gcy.universal_adapter;

/**
* Created by gcy71 on 2016/9/26.
*/

public class Bean {

private String title;
private String info;
private String time;

public Bean(String title, String info, String time) {
this.title = title;
this.info = info;
this.time = time;
}

public Bean() {
}

public String getTitle() {
return title;
}

public void setTitle(String title) {
this.title = title;
}

public String getInfo() {
return info;
}

public void setInfo(String info) {
this.info = info;
}

public String getTime() {
return time;
}

public void setTime(String time) {
this.time = time;
}
}

MainActivity.java

package com.gcy.universal_adapter;

import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.ListView;

import com.gcy.universal_adapter.utils.ListViewAdapter;

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

public class MainActivity extends AppCompatActivity {

private List<Bean> mDatas;
private ListView mListView;

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
initData();
initListView();
}

private void initListView() {
mListView = (ListView) findViewById(R.id.id_listview);
mListView.setAdapter(new ListViewAdapter(this , mDatas));
}

private void initData() {
mDatas = new ArrayList<Bean>();
for(int i=1 ; i<=10 ; i++){
mDatas.add(new Bean("我是标题 " + i, "Android打造ListView和GridView万能适配器" , "2016-09-27"));
}
}
}

ListViewAdapter.java

package com.gcy.universal_adapter.utils;

import android.content.Context;
import android.widget.TextView;

import com.gcy.universal_adapter.Bean;
import com.gcy.universal_adapter.R;

import java.util.List;

/**
* Created by gcy71 on 2016/9/27.
*/

public class ListViewAdapter extends MyBaseAdapter<Bean> {
public  ListViewAdapter(Context context , List<Bean> datas){
super(context , datas);
}
@Override
public void convert(BaseViewHolder viewHolder, Bean bean) {
viewHolder.setText2TextView(R.id.id_title , bean.getTitle())
.setText2TextView(R.id.id_info , bean.getInfo())
.setText2TextView(R.id.id_time , bean.getTime());
}
}

  由此可见我们的Adapter被缩减了不少代码，如果没有点击事件，仅仅只是为了展示信息的话，我们甚至可以使用匿名内部类来实现，而不用单独写一个Adapter

项目源码：https://github.com/Sunrise7878/Universal_adapter/tree/master/universal_adapter_listview%26gridview