RecyclerView使用以及避坑指南

基本使用

• 继承RecyclerView.Adapter,并在内部自定义对应的ViewHolder

  public class HelloRecyclerAdapter extends RecyclerView.Adapter {
    private List dataList = new ArrayList();
  
    public HelloRecyclerAdapter(List dataList) {
        this.dataList = dataList;
    }
  
    @NonNull
    @Override
    public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
        View view = LayoutInflater.from(parent.getContext())
                .inflate(R.layout.item_hello_recycler, parent, false);
        return new ViewHolder(view);
    }
  
    @Override
    public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
        Object data = dataList.get(position);
        //把data的数据赋值到holder对应的View中
    }
  
    @Override
    public int getItemCount() {
        return dataList.size();
    }
  
    class ViewHolder extends RecyclerView.ViewHolder {
        public ViewHolder(View itemView) {
            super(itemView);
        }
    }
  }
  

• Activity中新建adapter并赋值给recycler

  recyclerView.setLayoutManager(new LinearLayoutManager(this));
  //list是已赋值数据
  recyclerView.setAdapter(new HelloRecyclerAdapter(list));
  

  以上，一个recyclerView的列表就出来了。

RecyclerView中添加header

• 先定义两个常量，用来区分header和普通情况

  private static final int HEADER = 1;
  private static final int NORMAL = 2;
  

• 建立另一个HeaderViewHolder

  class HeaderViewHolder extends RecyclerView.ViewHolder {
    public HeaderViewHolder(View itemView) {
      super(itemView);
    }
  }
  

• 然后onCreateViewHolder中分情况创建

  public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
    View view;
    if (viewType == HEADER) {
      view = LayoutInflater.from(parent.getContext())
        .inflate(R.layout.item_hello_recycler, parent, false);
    } else {
      view = LayoutInflater.from(parent.getContext())
        .inflate(R.layout.item_hello_recycler_head, parent, false)
    }
  
    return new ViewHolder(view);
  }
  

• getItemCount中增加对应数量

  @Override
  public int getItemCount() {
  //增加header节点
  return dataList.size() + 1;
  }
  

• onBindViewHolder中分情况绑定数据

  @Override
  public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
    Object data = dataList.get(position);
    if (holder instanceof HeaderViewHolder) {
      //绑定header数据
    } else {
      //绑定普通数据
    }
  }
  

---

当然这只是最基本的能用了，在使用过程中会遇到一些奇奇怪怪的问题，接下来我们一一解决

---

recyclerView中数据错乱问题

• 数据来源固定

  这种情况很好解决，主要就是每个item在赋值时候，要把各个情况都覆盖到，不能只覆盖一种情况。

  假设item内有收藏功能，收藏后会用UI的变化，我们可以用如下方法实现：

  @Override
  public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
    Object data = dataList.get(position);
    //这里一定不能只写if而不写else,否则会出现颜色错乱
    if(data.isCollection()){
      holder.collectionView.setTextColor(RED)
    }else{
      holder.collectionView.setTextColor(BLACK)
    }
  }
  

• 数据来自网络

  这类情况的常见情景是加载图片，当网络环境较差时，图片加载完后，你可能已经翻页了，这时候再去显示图片会出现错乱的情况。

  针对这一情况，我们可以给图片添加一个TAG，显示图片时候判断对应的TAG是否一致

  holder.ivCameraImages.setBackground(R.drawable.place_holder);
  
  holder.ivCameraImages.setTag(imageURL);
  
  @Override
  public void handleMessage(Message msg) {
    super.handleMessage(msg);
    if (msg.what == MSG_IMAGE) {
      Bitmap bm = (Bitmap) msg.obj;
      if (bm != null) {
        if (TextUtils.equals((String) imageView.getTag(), imageURL)){
          imageView.setBackground(new BitmapDrawable(bm));
        }
      }
    }
  }
  

  当然，目前的主流图片框架会把url作为对应的TAG添加到ImageView中，省了我们重复造轮子的时间。

RecyclerView中的局部刷新

还是回到那个收藏的问题，如果点击收藏按钮，只更新当前的item这个需求如何实现？

• 当列表中没有图片时候

  public void collectionSuccess(String id) {
    //当header的收藏数量变化时候
    //通过ID找到下标
    int position = findPositionForId(id);
    //更新数量
    dataList.get(position)
      .setCollectionNum(data.getCollectionNum()+1);
    //更新对应UI
    notifyItemChanged(position);
  }
  

• 列表中存在图片时

  当有图片时候，使用notifyItemChanged()方法会导致图片闪烁。

  解决这个问题呢就需要进行一些大的改动了。

  首先，放弃使用两个参数的onBindViewHolder方法，使用三个参数的方法：

  @Override
  public void onBindViewHolder(@NonNull RecyclerView.ViewHolder holder, int position) {
    //不去覆写这个方法
  }
  
  @Override
  public void onBindViewHolder(RecyclerView.ViewHolder holder, int position, List