你还在为列表[单选]、[多选]写重复的逻辑吗

一 瞎扯淡

项目中常常性会碰到列表的单选、多选，实现起来好像也不难，可是最近项目有好多个须要单选/多选的页面，看到设计稿的一瞬间，脑子灵光一闪，为啥不把这些简单而又繁琐的逻辑给封装起来呢(懒癌发做)？

因而就有了下面的小东西（开源库）...

二 功能

1.列表单选

• 普通单选
• 预选中
• 不能取消
• 多类型
• 多列表

2.列表多选

• 普通多选
• 预选中
• 全选/取消全选
• 多类型
• 多列表

3.优势

• 简单易用
• 低耦合
• 不用为Bean添加额外字段
• 没有调用 Adapter.notifyItemChange方法，因此不会有闪屏Bug

三 效果

废话少说，先上图：

1.单选

2.多选

四 使用

1.配置

首先在你的工程根目录的 gradle 文件下添加如下配置：

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}
复制代码

接着就能够在你的moudle,通常是 app 的 gradle 文件下添加依赖：

implementation 'com.github.gminibird:CheckHelper:1.0'
复制代码

最后那个1.0是版本号，能够上 GitHub 上看最新的，而后就能够愉快的玩耍啦。

2.使用

• 建立CheckHelper实例

  SingleCheckHelper mCheckHelper = new SingleCheckHelper();
  //or
  MultiCheckHelper mCheckHelper = new MultiCheckHelper();
  复制代码

• 注册选择器

  mCheckHelper.register(String.class, new CheckHelper.Checker<String, LwViewHolder>() 
  @Override
  public void check(String s, LwViewHolder holder) {
      //选中状态
      holder.itemView.setBackgroundColor(0xFF73E0E4); //蓝色
      holder.setChecked(R.id.checkbox, true);
  }
  @Override
  public void unCheck(String s, LwViewHolder holder) {
      //非选中状态
      holder.itemView.setBackgroundColor(0xFFFFFFFF);  //白色
      holder.setChecked(R.id.checkbox, false);
  }
  });
  复制代码

• 绑定到Adapter中

  @Override
  protected void onBind(@NonNull LwViewHolder holder, @NonNull String item) {
      //这里用了本身封装的Adapter，至关于onBindViewHolder方法
      mCheckHelper.bind(item, holder, holder.itemView);
  }
  复制代码

而后，而后就完成了。。。运行就能够看到想要的效果，选中的数据能够调用相应CheckHelper实例的getXXX()获取。

五 实现原理

总的原理其实很简单，就是对应的 CheckHelper 实现类内部维护一些选中的数据。下面细说下具体实现：

1. 模板类 CheckHelper

CheckHelper 是目前两个实现类的基类，提供了一些基础的公共功能，好比设置监听器，注册选择器等，其实就是一个模板模式，把公共部分以及执行顺序都定了，而后交由子类完成具体的数据增改。

里面有两个重要的方法，一个是bind(),另外一个是 select(),分别对应了onBindViewHolder以及onClick(点击)方法：

public final void bind(final Object d, final RecyclerView.ViewHolder v, View clickedView) {
    if (clickedView == null) {
        throw new NullPointerException("ClickedView can not be null!");
    }
    bind(d, v, isChecked(d, v)); //注释1
    clickedView.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View view) {
            select(d, v);  //注释2
        }
    });
}
复制代码

咱们在onBindViewHolder()方法中绑定的 bind() 方法最终会调用这个方法，先看注释1，注释1里的bind方法里面作了一系列的监听器的回调：

public void bind(Object d, RecyclerView.ViewHolder v, boolean toCheck) {
    Checker checker = mCheckerMap.get(d.getClass());
    if (checker != null) {
        if (toCheck) {
            checker.check(d, v);
        } else {
            checker.unCheck(d, v);
        }
    }
    OnCheckListener checkListener = mCheckListenerMap.get(d.getClass());
    if (checkListener != null) {
        checkListener.onCheck(d, v, toCheck);
    }
    onBindListener bindListener = mOnBindListenerMap.get(d.getClass());
    if (bindListener != null) {
        bindListener.onBind(d, v, toCheck);
    }
}
复制代码

其中包括 Checker ,也就是咱们注册为非选中和选中状态设置的选择器会被调用，而后就是 OnCheckListener 以及 onBindListener ，这两个咱们均可以add 进去。

再返回看最上面的bind() 方法里面的注释2，调用了一系列回调后，而后便为 item 的某个 view 设置一个监听，点击后就会执行 select方法，select方法里面也是作了一系列回调，基本和上面的方法一致。因此子类只要重写这两个方法，并实现相应的数据操做便可。

2. SingleCheckHelper 单选

单选其实不难，但有一点比较难搞：

选中后怎么把上一次选中给取消?

若是按照平时的写法，咱们在Bean里面增长一个 isChecked 字段，而后选择这个时将当前选中置为 true,接着将上一个选择的置为 false 最后调用 adapter 刷新一下就能够了。

可是这里没有依赖具体的Bean,也没有新增字段，那怎么弄呢，后来想到了一个小技巧，我没有依赖Bean,可是能够在 ViewHolder 里面存储信息，因此就有下面的代码：

@Override
public void select(Object d, RecyclerView.ViewHolder v, boolean toCheck) {
    if (toCheck) {
        unCheckPre(d);  //注释1
        setTag(v);    //注释2
        this.v = v;
        this.d = d;
    } else {
        if (!canCancel){
            return;
        }
        clearTag(v);  //注释3
        this.d = null;
        this.v = null;
    }
    super.select(d, v, toCheck);
}
复制代码

逻辑也很简单，若是是选中状态，并且存有tag,那么说明是以前已经有选中的，就将以前选中的tag清除，而后再把当前的选中设置一个tag,若是是取消选中，那么就将tag给清除掉:

private void unCheckPre(Object d) {
    if (this.d == null || this.d.equals(d)) {
        return;
    }
    if (this.d != null && this.v != null && this.v.itemView.getTag(TAG) != null) {
        //当上一个选中存在而且可见时置为非选
        bind(d, v, false);
    }
}

private void setTag(RecyclerView.ViewHolder v) {
    if (v != null) {
        v.itemView.setTag(TAG, TAG_VALUE);
    }
}
复制代码

接着就回调父类的一系列回调接口了。

3.MultiCheckHelper 多选

多选类主要是靠一个 Map 来维护选中的数据，每一个数据类型对应一个 Set ,选中和非选中就调用相应的方法更新数据，没有很大难点。

protected HashMap<Class, Set<?>> mMap;

@SuppressWarnings("unchecked")
public void add(Object d) {
    Set<Object> set = (Set<Object>) mMap.get(d.getClass());
    if (set == null) {
        set = new HashSet<>();
        mMap.put(d.getClass(), set);
    }
    set.add(d);
}
public void remove(Object d) {
    Set set = mMap.get(d.getClass());
    if (set != null) {
        set.remove(d);
        if (set.size() == 0) {
            mMap.remove(d.getClass());
        }
    }
}
复制代码

因为做者水平有限，若是有更好的方法欢迎探讨。

written by gminibird

源码戳上面 ^^^

做者介绍

• 曾荣基：广州芦苇科技 APP 团队 Android 开发工程师

内推信息

• 咱们正在招募小伙伴，有兴趣的小伙伴能够把简历发到 app@talkmoney.cn，备注：来自掘金社区
• 详情能够戳这里--> 广州芦苇信息科技