Android打造ListView和GridView万能适配器

最新推荐文章于 2026-04-12 11:22:21 发布

原创最新推荐文章于 2026-04-12 11:22:21 发布 · 984 阅读

0 ·

本内容遵循CC 4.0 BY-SA版权协议

收录于

Android

本文介绍了一种基于Android的万能适配器设计方案，通过对传统Adapter和ViewHolder的封装，大幅减少了代码量并提高了复用性。

本篇博客是我学习过慕课网的《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());
    }
}