Introducing RecyclerView(二)

文／poberWong（简书作者）
原文链接：http://www.jianshu.com/p/7fdfea845937
著作权归作者所有，转载请联系作者获得授权，并标注“简书作者”。

正文：

RecyclerView的优势：

它自带ViewHolder来实现View的复用机制，再也不用ListView那样在getView()里自己写了
使用LayoutManager可以实现ListView，GridView以及流式布局的列表效果
通过setItemAnimator(ItemAnimator animator)可以实现增删动画（懒的话，可以使用默认的ItemAnimator对象，效果也不错）
控制item的间隔，可以使用addItemDecoration(ItemDecoration decor)，不过里边的ItemDecoration是一个抽象类，需要自己去实现...

用法介绍：

导入RecyclerView的v7库:
RecyclerView是一个android.support.v7库里的控件，因此在使用的时候我们需要在gradle配置文件里加上compile 'com.android.support:recyclerview-v7:22.2.1'来引入google官方的这个库

xml布局中，使用常规的控件引入方式，来引入RecyclerView，如下：

 <android.support.v7.widget.RecyclerView

  android:id="@+id/recyclerview_content"

  style="?recyclerview_style"

  android:scrollbars="vertical"

  android:fadeScrollbars="true"

  android:layout_width="match_parent"

  android:layout_height="match_parent"

  android:layout_marginBottom="-55dp" />

代码中的写法基本和ListView相差无几，但还是要重点说一下：
1. 在实例化RecyclerView之后，我们需要使用setLayoutManager()给它设置布局管理器，其中的实参即就是LayoutManager，这里总共有两种LayoutManager：
  1. StaggeredGridLayoutManager，是我们之前提到的流式布局：
    它有一个构造方法StaggeredGridLayoutManager(int spanCount, int orientation)，第一个是网格的列数，第二个参数是数据呈现的方向
    （如果是竖直，那么第一个参数的意义就是列数，反之为行数。而且第二个参数在StaggeredGridLayoutManager里也有同样名称的常量，请同学们自行采纳［这里还是建议大家使用库里自带的常量，因为他们一般都是整型值，这样可以避免各个类里所判别的常量值不一样而导致的其他问题］）；
  2. GridLayoutManager，网格布局（流式布局应该是它的一个特殊情况）：
    GridLayoutManager(Context context, int spanCount）或
    GridLayoutManager(Context context, int spanCount, int orientation, boolean reverseLayout)需要说明的是，最后一个参数表示的是是否逆向布局（意思是将数据反向显示，原先从左向右，从上至下。设为true之后全部逆转）。
    小提示：在这两个LayoutManager中，默认的orientation为vertical，reverseLayout为false。对应的参数在GridLayoutManager中都有对应的方法来进行补充设置。而在StaggeredGridLayoutManager中所有的方法都针对reverseLayout做了判断，然而它并没有给出这个参数设定值的api。
  3. 线性布局, LinearLayoutManager
    LinearLayoutManager(Context context)构建一个默认布局方向为VERTICAL的RecyclerView，这种样式也是ListView默认的。
    LinearLayoutManager(Context context, int orientation, boolean reverseLayout)。发现没有，线性布局和网格布局几乎是一样的。只是少了一个spanCount参数。
2. 和ListView一样，为RecyclerView设置Adapter
```
 class HomeAdapter extends RecyclerView.Adapter<HomeAdapter.MyViewHolder>

 {

 @Override

 public MyViewHolder onCreateViewHolder(ViewGroup parent, int viewType)

 {

     MyViewHolder holder = new MyViewHolder(LayoutInflater.from(

             HomeActivity.this).inflate(R.layout.item_home, parent,

             false));

     return holder;

 }

 @Override

 public void onBindViewHolder(MyViewHolder holder, int position)

 {

     holder.tv.setText(mDatas.get(position));

 }

 @Override

 public int getItemCount()

 {

     return mDatas.size();

 }

 class MyViewHolder extends ViewHolder

 {

     TextView tv;

     public MyViewHolder(View view)

     {

         super(view);

         tv = (TextView) view.findViewById(R.id.id_num);

     }

 }

}
```
  如上，即就是Adapter的写法。其中的ViewHolder就是拿来负责View的回收和复用的，这样就不需要我们自己写完ViewHolder之后，还要在getView(int position, View convertView, ViewGroup parent)里一顿判断，一顿绑定，一顿find了。而且这里的ViewHolder成为了RecyclerView中必须继承的一部分，重写完后就需要放入 RecyclerView.Adapter< >这里来对基类的范型初始化。
在这里，Recyclerview已经为你封装好了：

getItemCount()就不必多说了，和ListView是一样的

getItemViewType(int position)是用来根据position的不同来实现RecyclerView中对不同布局的要求。从这个方法中所返回的值会在onCreateViewHolder中用到。比如头部，尾部，等等的特殊itemView（这里说成ViewHolder比较好）都可以在这里进行判断。

onCreateViewHolder(ViewGroup parent, int viewType)是用来配合写好的ViewHolder来返回一个ViewHolder对象。这里也涉及到了条目布局的加载。viewType则表示需要给当前position生成的是哪一种ViewHolder，这个参数也说明了RecyclerView对多类型ItemView的支持。

onBindViewHolder(MyViewHolder holder, int position)专门用来绑定ViewHolder里的控件和数据源中position位置的数据。
这里，会有人问，那么item的子控件findViewById 去哪儿了？我们把它交给了ViewHolder的构造方法（其他方法也可以），它的本质是在onCreateViewHolder方法里生成ViewHolder的时候执行的。

提升:

代码重构:
在上边看了这么多，有木有觉得，ViewHolder的功能并不是非常明确？它既负责了子控件的查询，又负责了子控件的装载工作。而布局加载和数据绑定却交给了Adapter......
我们来看看掘金的做法：
首先，它把Adapter和ViewHolder的功能以一种较为低耦合的方式进行了职能分离，让ViewHolder里所有的逻辑代码全部都只出现在ViewHolder中。我们现在就对前边提到的代码进行重构：

ViewHodler：

class MyViewHolder extends ViewHolder{

   TextView tv;

   public MyViewHolder(Context context, View view){

          super(view);

          tv = (TextView) view.findViewById(R.id.id_num);

          //当然，我们也可以在这里使用view来对RecyclerView的一个item进行事件监听,也可以使用

          //tv等子控件来实现item的子控件的事件监听。这也是我之所以要传context的原因之一呢～

          ......

   }

   public static MyViewHolder newInstance(Activity context, ViewGroup parent){

           View view = LayoutInflater.from(

              context).inflate(R.layout.item_home, parent,false);

         return new MyViewHolder(context, view);

   }

  }    

  //你没看错，数据绑定也被整合进来了，

  //将adapter里的数据根据position获取到后传进来。当然，也可以根据具体情况来做调整。

   public void onBinViewHolder(String data){

       tv.setText(data);//既然这里也有子控件，那么这里也可以做item子控件的事件监听喽

}

RecyclerView

class HomeAdapter extends RecyclerView.Adapter<MyViewHolder>{

  @Override

  public MyViewHolder onCreateViewHolder(ViewGroup parent, int viewType){//如需要，还要对viewType做判断

      return MyViewHolder.newInstance(this, parent)

  }

  @Override

  public void onBindViewHolder(MyViewHolder holder, int position){

      holder.onBindViewHolder(mDatas.get(position));

  }

  @Override

  public int getItemCount(){

      return mDatas.size();

  }

}

抽取一个条目点击事件，让它更像ListView:

class HomeAdapter extends RecyclerView.Adapter<MyViewHolder>{

  private OnItemClickListener mOnItemClickListener;

  public void setOnItemClickLitener(OnItemClickLitener mOnItemClickLitener)

  {

      this.mOnItemClickLitener = mOnItemClickLitener;

  } 

  @Override

  public MyViewHolder onCreateViewHolder(ViewGroup parent, int viewType){//如需要，还要对viewType做判断

      return MyViewHolder.newInstance(this, parent)

  }

  @Override

  public void onBindViewHolder(MyViewHolder holder, int position){

      holder.onBindViewHolder(mDatas.get(position));

      //如果设置了回调，则设置点击事件

      if (mOnItemClickLitener != null) {

          viewHolder.itemView.setOnClickListener(new OnClickListener() {

              @Override

              public void onClick(View v) {

                 mOnItemClickLitener.onItemClick(viewHolder.itemView, i);

              }

          });

      }

  }

  @Override

  public int getItemCount(){

      return mDatas.size();

  }

  public interface OnItemClickLitener {

      void onItemClick(View view, int position);

  }

}

接口调用

  mAdapter.setOnItemClickLitener(new OnItemClickLitener() {

  @Override

  public void onItemClick(View view, int position) {

      ......

  }

});

External

上边提到了

控制item的间隔，可以使用addItemDecoration(ItemDecoration decor)，不过里边的ItemDecoration是一个抽象类，需要自己去实现...

这个问题，那我们来实际解决一下：

这是羊神实现的一个子类

package com.zhy.sample.demo_recyclerview;

/*

 * Copyright (C) 2014 The Android Open Source Project

 *

 * Licensed under the Apache License, Version 2.0 (the "License");

 * limitations under the License.

 */

import android.content.Context;

import android.content.res.TypedArray;

import android.graphics.Canvas;

import android.graphics.Rect;

import android.graphics.drawable.Drawable;

import android.support.v7.widget.LinearLayoutManager;

import android.support.v7.widget.RecyclerView;

import android.support.v7.widget.RecyclerView.State;

import android.util.Log;

import android.view.View;

/**

 * This class is from the v7 samples of the Android SDK. It's not by me!

 * <p/>

 * See the license above for details.

 */

public class DividerItemDecoration extends RecyclerView.ItemDecoration {

    private static final int[] ATTRS = new int[]{

            android.R.attr.listDivider

    };

    public static final int HORIZONTAL_LIST = LinearLayoutManager.HORIZONTAL;

    public static final int VERTICAL_LIST = LinearLayoutManager.VERTICAL;

    private Drawable mDivider;

    private int mOrientation;

    public DividerItemDecoration(Context context, int orientation) {

        final TypedArray a = context.obtainStyledAttributes(ATTRS);

        mDivider = a.getDrawable(0);

        a.recycle();

        setOrientation(orientation);

    }

    public void setOrientation(int orientation) {

        if (orientation != HORIZONTAL_LIST && orientation != VERTICAL_LIST) {

            throw new IllegalArgumentException("invalid orientation");

        }

        mOrientation = orientation;

    }

    @Override

    public void onDraw(Canvas c, RecyclerView parent) {

        Log.v("recyclerview - itemdecoration", "onDraw()");

        if (mOrientation == VERTICAL_LIST) {

            drawVertical(c, parent);

        } else {

            drawHorizontal(c, parent);

        }

    }

    public void drawVertical(Canvas c, RecyclerView parent) {

        final int left = parent.getPaddingLeft();

        final int right = parent.getWidth() - parent.getPaddingRight();

        final int childCount = parent.getChildCount();

        for (int i = 0; i < childCount; i++) {

            final View child = parent.getChildAt(i);

            android.support.v7.widget.RecyclerView v = new android.support.v7.widget.RecyclerView(parent.getContext());

            final RecyclerView.LayoutParams params = (RecyclerView.LayoutParams) child

                    .getLayoutParams();

            final int top = child.getBottom() + params.bottomMargin;

            final int bottom = top + mDivider.getIntrinsicHeight();

            mDivider.setBounds(left, top, right, bottom);

            mDivider.draw(c);

        }

    }

    public void drawHorizontal(Canvas c, RecyclerView parent) {

        final int top = parent.getPaddingTop();

        final int bottom = parent.getHeight() - parent.getPaddingBottom();

        final int childCount = parent.getChildCount();

        for (int i = 0; i < childCount; i++) {

            final View child = parent.getChildAt(i);

            final RecyclerView.LayoutParams params = (RecyclerView.LayoutParams) child

                    .getLayoutParams();

            final int left = child.getRight() + params.rightMargin;

            final int right = left + mDivider.getIntrinsicHeight();

            mDivider.setBounds(left, top, right, bottom);

            mDivider.draw(c);

        }

    }

    @Override

    public void getItemOffsets(Rect outRect, int itemPosition, RecyclerView parent) {

        if (mOrientation == VERTICAL_LIST) {

            outRect.set(0, 0, 0, mDivider.getIntrinsicHeight());

        } else {

            outRect.set(0, 0, mDivider.getIntrinsicWidth(), 0);

        }

    }

}

然后就是为我们的RecyclerView实例添加分割线

addItemDecoration(new DividerItemDecoration(this,

DividerItemDecoration.VERTICAL_LIST));

系统默认的分割线往往达不到我们产品和设计师的要求，怎么办呢？
```
<item name="android:listDivider">@drawable/your_custom_divider</item>
```

通过以上xml属性，将系统的listDivider设为自己画出来的分割线，只需要放在你对应activity的主题下即可。
（不会画的，请自行google,关键字：android shape）