listview-android：打造万能通用适配器(转)

2022-10-11 11:56:30

转载：https://blog.csdn.net/q649381130/article/details/51781921；

1、前言

listview作为安卓项目中一个的明星控件，它的适配器的写法是广大安卓开发者需要掌握和优化的技巧。

本文旨在介绍一个通用的适配器BaseCommAdapter<T>写法，它使用非常简单，封装完美。可以极大的精简子类代码，加快开发效率。

我们使用多个时候只需要继承该BaseCommAdapter<T>，利用泛型传入item对应数据的javabean类，我们只需要重写3个方法即可（其中有一个还是构造方法）。

先看下demo演示的效果图：

listview-android：打造万能通用适配器(转)

从效果图可以看出布局很简单，在activity中使用listview，将它绑定一个适配器adapter即可，item的布局就是一个imageview显示用户头像，俩个textview分别显示用户名和用户性别。

2、一般的适配器写法

为了实现该图片展示的页面效果，我们一般会直接写一个适配器继承baseAdapter，我们先看下代码。

NomarlAdapter适配器:

public class NomarlAdapter extends BaseAdapter
{

    private List<User> mUsers;

    public NomarlAdapter(List<User> users)
    {
        this.mUsers = users;
    }

    @Override
    public int getCount()
    {
        return mUsers == null ? 0 : mUsers.size();
    }

    @Override
    public User getItem(int position)
    {
        return mUsers.get(position);
    }

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

    @Override
    public View getView(int position, View convertView, ViewGroup parent)
    {
        if (convertView == null)
        {
            convertView = View.inflate(parent.getContext(), R.layout.item_user_list, null);
        }

        setUI(position, convertView);

        return convertView;
    }

    private void setUI(int position, View convertView)
    {
        ViewHolder holder = ViewHolder.newsInstance(convertView);

        User item = getItem(position);

        holder.setUserHead(item.headId);
        holder.setUserName(item.name);
        holder.setUserSex(item.sex);
    }

   private static class ViewHolder
    {
        private ImageView iv_head;
        private TextView tv_name;
        private TextView tv_sex;

        public static ViewHolder newsInstance(View convertView)
        {
            ViewHolder holder = (ViewHolder) convertView.getTag();

            if (holder == null)
            {
                holder = new ViewHolder();

                holder.iv_head = (ImageView) convertView.findViewById(R.id.iv_head_use_item);
                holder.tv_name = (TextView) convertView.findViewById(R.id.tv_name_use_item);
                holder.tv_sex = (TextView) convertView.findViewById(R.id.tv_sex_use_item);

                convertView.setTag(holder);
            }

            return holder;
        }

        public void setUserHead(int headResourceId)
        {
            iv_head.setImageResource(headResourceId);
        }

        public void setUserName(String userName)
        {
            tv_name.setText(userName);
        }

        public void setUserSex(String userSex)
        {
            tv_sex.setText(userSex);
        }
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92

以上就是一个继承自BaseAdapter的普通适配器，通过构造器传入一个user集合，使用一个viewholder保存conventerView的节点view，并封装了ui设置方法，代码很清晰简单，也没有复杂逻辑，这里就不详细解释了。

用户实体类，有三个属性，分别是用户名，用户头像的资源id、性别，代码如下。

public class User
{
    public String name; //用户名
    public int headId;  //用户头像资源
    public String sex; //性别

    public User(String name, int headId, String sex)
    {
        super();
        this.name = name;
        this.headId = headId;
        this.sex = sex;
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14

在mainactivi中的用法：

   private void initData()
    {
        mUsers = new ArrayList<User>();
        mUsers.add(new User("小红", R.drawable.head_1, "女"));
        mUsers.add(new User("剑圣", R.drawable.head_2, "男"));
        mUsers.add(new User("刀锋战士", R.drawable.head_3, "男"));
        mUsers.add(new User("张飞", R.drawable.head_3, "男"));
        mUsers.add(new User("雅典娜", R.drawable.head_4, "女"));
        mUsers.add(new User("稻草人", R.drawable.head_5, "未知"));
    }
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10

我们先定义几个用户数据添加到集合中,然后通过如下代码将数据与listview绑定。

        mListView = (ListView) findViewById(R.id.lv_main);

        // NomarlAdapter mAdapter = new NomarlAdapter(mUsers);
        UserAdapter mAdapter = new UserAdapter(mUsers);

        mListView.setAdapter(mAdapter);
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6

以上就是一个普通的adapter的写法与使用。

3、万能适配器

BaseCommAdapter的封装

下面我们来一步一步来打造本文的主角：万能通用适配器`BaseCommAdapter“。

public abstract class BaseCommAdapter<T> extends BaseAdapter
{
    private List<T> mDatas;

    public BaseCommAdapter(List<T> datas)
    {
        mDatas = datas;
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9

BaseCommAdapter<T>也是继承自BaseAdapter,传入一个泛型T表示需要绑定的javabean。外部通过构造器传入需要展示在listview中的javabean的数据集合就可以轻松实现数据的绑定并显示。

@Override
    public int getCount()
    {
        return mDatas == null ? 0 : mDatas.size();
    }

    @Override
    public T getItem(int position)
    {
        return mDatas.get(position);
    }

    @Override
    public long getItemId(int position)
    {
        return position;
    }
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17

在BaseAdapter中，有几个方法没必要每次都需要子类来实现，我们将它们封装到BaseCommAdapter<T>中。

    @Override
    public View getView(int position, View convertView, ViewGroup parent)
    {
        ViewHolder holder = ViewHolder
                .newsInstance(convertView, parent.getContext(), getLayoutId());

        setUI(holder,position,parent.getContext());

        return holder.getConverView();
    }

     protected abstract void setUI(ViewHolder holder, int position, Context context);

    protected abstract int getLayoutId();
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15

接下来是的getview方法，通过ViewHolder的静态方法newsInstance创建一个viewholder实例，需要传入三个参数，分别是convertView，上下文对象，以及item的布局id（由于布局id并不是一成不变的，我们抽成一个getLayoutId()的抽象方法让子类实现），setUI（）用来执行UI的显示设置。注意，convertView已经保存在viewholder中了，所以我们只需要从中取出再返回就可。

上面代码中，我们把子类特有的行为，比如item布局id，ui的设置方法都抽离出getview封装成抽象方法，子类就可以不用再去重写getview方法。

这样BaseAdapter的四个抽象方法都被我们封装到BaseCommAdapter<T>中了。

viewholder类

在BaseCommAdapter<T>的getview方法中我们调用Viewholder的静态方法newsInstance创建了一个viewHolder对象，那么这个方法执行了哪些操作呢，国际惯例，先上代码：

 public static ViewHolder newsInstance(View convertView, Context context, int layoutId)
    {
        if (convertView == null)
        {
            return new ViewHolder(context, layoutId);

        } else
        {
            return (ViewHolder) convertView.getTag();
        }
    }
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11

newsInstance方法的代码很少，简单介绍下，convertView加载逻辑从适配器的getview方法中移动到这里了，当它不为空时，直接取出保存在tag里面的holder实例返回给adapter，如果为空我们创建一个holder。

接下来看下构造方法是如何实现的：

    private SparseArray<View> mViews;

    private View mConvertView;

    private ViewHolder(Context context, int layoutId)
    {
        mConvertView = View.inflate(context, layoutId, null);
        mConvertView.setTag(this);

        mViews = new SparseArray<>();
    }
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11

在构造方法中，首先先加载布局文件到mConvertView，并把当前的viewholder对象设置为tag。

同时我们使用用了一个稀疏数组SparseArray来保存mConvertView中的节点view，它是谷歌在utils包中提供的一个工具类，效果类似于一个key为integer值为object的map集合，但是性能比map要好。mViews的key就是节点view的id。

下面是viewholder的完整代码：

public class ViewHolder
{
    /**
     * 保存所有itemview的集合
     */
    private SparseArray<View> mViews;

    private View mConvertView;

    private ViewHolder(Context context, int layoutId)
    {
        mConvertView = View.inflate(context, layoutId, null);
        mConvertView.setTag(this);

        mViews = new SparseArray<>();
    }

    public static ViewHolder newsInstance(View convertView, Context context, int layoutId)
    {
        if (convertView == null)
        {
            return new ViewHolder(context, layoutId);

        } else
        {
            return (ViewHolder) convertView.getTag();
        }
    }

    /**
     * 获取根view
     * @author 漆可
     * @date 2016-6-28 下午3:29:21  
     * @return
     */
    public View getConverView()
    {
        return mConvertView;
    }

    /**
     * 获取节点view
     * @author 漆可
     * @date 2016-6-28 下午4:24:26  
     * @param id
     * @return
     */
    @SuppressWarnings("unchecked")
    public <T extends View> T getItemView(int id)
    {
        View view =  mViews.get(id);
        if (view == null)
        {
            view = mConvertView.findViewById(id);
            mViews.append(id, view);
        }

        return (T) view;
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60

4、如何使用

使用的时候只需要继承BaseCommAdapter<T>，泛型中传入数据类型，重写setUI、getLayoutId俩个方法就可,下面是完整代码

public class UserAdapter extends BaseCommAdapter<User>
{
    public UserAdapter(List<User> datas)
    {
        super(datas);
    }

    @Override
    protected void setUI(ViewHolder holder, int position, Context context)
    {
        User item = getItem(position);

        TextView tv_name = holder.getItemView(R.id.tv_name_use_item);
        tv_name.setText(item.name);

        TextView tv_sex = holder.getItemView(R.id.tv_sex_use_item);
        tv_sex.setText(item.sex);

        ImageView iv_head = holder.getItemView(R.id.iv_head_use_item);
        iv_head.setImageResource(item.headId);
    }

    @Override
    protected int getLayoutId()
    {
        return R.layout.item_user_list;
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29

4、结束

最后附上demo下载地址：http://download.csdn.net/detail/q649381130/9562153

--------------------- 本文来自 卜可 的CSDN 博客 ，全文地址请点击：https://blog.csdn.net/q649381130/article/details/51781921?utm_source=copy 

listview-android：打造万能通用适配器(转)

上一篇：[React] {svg, css module, sass} support in Create React App 2.0


下一篇：SpringMvc HandlerMethodResolver 的 handlerMethods & ServletHandlerMethodResolver 的 mappings 在哪里初始化的 ？