RecyclerView（一）

RecyclerView实现简单列表

1.简介

强大的滚动控件，集合了ListView和GirdView的优点，并且可以优化两者，实现横向滑动的效果

同时可以通过设置显示规则来实现ListView和GirdView

recyclerview.setLayoutManager(new LinearLayoutManager(
this, LinearLayoutManager.VERTICAL, false));

RecyclerView 将所有的显示规则交给一个叫 LayoutManager 的类去完成了。
LayoutManager 是一个抽象类，系统已经为我们提供了三个默认的实现类，分别是 LinearLayoutManager 、 GridLayoutManager 、 StaggeredGridLayoutManager，从名字我们就能看出来了，分别是，线性显示、网格显示、瀑布流显示。当然你也可以通过继承这些类来扩展实现自己的 LayoutManager。

2.使用

（1）引进依赖

在app/build.gradle中引进如下语句然后同步

dependencies {
    ...
    implementation 'com.android.support:recyclerview-v7:28.0.0'
}

其实还有另一种方式，毕竟这个包那么多，不能全都记住，可以用File->Project Structure->点击左边Modules的App->Dependencies->点击下图中右边的绿色加号->Library dependency->找到对应RecyclerView的库，点击，然后OK，这样就进来了，系统还会自动同步。如下面第二张图

改版后 这次搜索是正则表达式形式的

（2）定义一个模型

import java.util.ArrayList;

public class Contact {
    private  String mName;
    private  boolean mOnline;

    public Contact(String mName, boolean mOnline) {
        this.mName = mName;
        this.mOnline = mOnline;
    }

    public String getName() {
        return mName;
    }

    public boolean isOnline() {
        return mOnline;
    }

    private  static int lastContactId=0;
    public static ArrayList<Contact> createContactsList(int numContacts){
        ArrayList<Contact> contacts=new ArrayList<Contact>();
        for(int i=1;i<=numContacts;i++){
            contacts.add(new Contact("Person "+ ++lastContactId,i<=numContacts/2));
        }
        return contacts;
    }
}

这里用一个数组集合类来存Contact对象，一个返回值为 ArrayList的静态方法createContactsList，用来进行数据初始化

（3）创建RecyclerView的布局

在activity_main.xml布局里,创建RecyclerView的布局

<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <android.support.v7.widget.RecyclerView
        android:id="@+id/rvContacts"
        android:layout_width="0dp"
        android:layout_height="0dp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

</android.support.constraint.ConstraintLayout>

layout_constraintBottom_toBottomOf表示参照约束布局的底部，其他按英文同理

（4）创建用于展示的布局

在res/layout目录下，点击new->XML->Layout XML Files，在新建文件里写入如下内容

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="horizontal"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:paddingTop="10dp"
    android:paddingBottom="10dp"
    >

    <TextView
        android:id="@+id/contact_name"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        />

    <Button
        android:id="@+id/message_button"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:paddingLeft="16dp"
        android:paddingRight="16dp"
        android:textSize="10sp"
        />
</LinearLayout>

在这里我用TextView承接文字，也就是上面定义的mName，用Button来承接boolean类型的mOnline。

（5）创建适配器

public class ContactsAdapter extends RecyclerView.Adapter<ContactsAdapter.ViewHolder> {
    //适配器都要继承自RecyclerView.Adapter，在这里给他指定一个泛型VH.ViewHolder,
    // 而ViewHolder这里也是我自定义出来的
    public class ViewHolder extends RecyclerView.ViewHolder{
        //静态抽象方法 RecyclerView.ViewHolder
        public TextView nameTextView;
        public Button messageButton;
        public ViewHolder(View itemView){
            super(itemView);
            nameTextView=(TextView)itemView.findViewById(R.id.contact_name);
            messageButton=(Button)itemView.findViewById(R.id.message_button);
        }
    }
    private List<Contact> mContacts;
    ContactsAdapter(List<Contact> contacts){
        mContacts=contacts;
    }


    @Override
    public ContactsAdapter.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        Context context = parent.getContext();
        LayoutInflater inflater = LayoutInflater.from(context);
        // 加载自定义布局
        View contactView = inflater.inflate(R.layout.item_contact, parent, false);
        //返回新的holder实例
        ViewHolder viewHolder = new ViewHolder(contactView);
        return viewHolder;
    }

    // Involves populating data into the item through holder
    @Override
    public void onBindViewHolder(ContactsAdapter.ViewHolder viewHolder, int position) {
        // 根据位置得到数据模型
        Contact contact = mContacts.get(position);
        // 根据你的视图和数据模型设置项
        TextView textView = viewHolder.nameTextView;
        textView.setText(contact.getName());
        Button button = viewHolder.messageButton;
        button.setText(contact.isOnline() ? "Message" : "Offline");
        button.setEnabled(contact.isOnline());
    }

    // 返回有多少列表项
    @Override
    public int getItemCount() {
        //list的get方法
        return mContacts.size();
    }
}

（1）ContactsAdapter是一个适配器类，继承自RecyclerView.Adapter<ContactsAdapter.ViewHolder>抽象类， 此类指定泛型为ContactsAdapter.ViewHolder，其中ViewHolder是我们定义的一个内部类，它继承自RecyclerView.ViewHolder，然后再ViewHolder的构造函数里传入一个view参数，这个参数通常就是RecycleView子项的最外层布局。然后就可以通过findViewById来获取布局中的TextView和Button。

（2）RecyclerView里面是一群ViewHolder，每个自己组装的用于显示的一条数据项就是就是一个ViewHolder，这里就是我自己定义的Contact里面的成员变量。

（3）接下来此构造器继承于RecyclerView.Adapter抽象类，就要实现里面的这三个方法

onCreateViewHolder：用于创建ViewHolder实例，在这个方法中把我们定义的contact布局加载进来，然后创建一个ViewHolder实例,并把加载的布局传入到构造函数当中，最后将ViewHolder实例返回。

**onBindViewHolder：**用于对RecyclerView子项的数据进行赋值，会在每个子项被滚动到屏幕内的时候执行，我们通过position参数得到当前项的Contact实例，然后将数据设置到ViewHolder的TextView和Button中

getItemCount：用于计算RecyclerView一共有多少子项，直接返回数据源的长度。

源码中是这样的

 public abstract VH onCreateViewHolder(@NonNull ViewGroup var1, int var2);

 public abstract void onBindViewHolder(@NonNull VH var1, int var2);

 public abstract int getItemCount();

（4） LayoutInflater布局加载框架，参见https://blog.csdn.net/guolin_blog/article/details/12921889

通常加载布局的任务通常都是在Activity中调用setContentView()方法来完成的。其实setContentView()方法的内部也是使用LayoutInflater来加载布局。

使用：

获取实例 LayoutInflater layoutInflater = LayoutInflater.from(context);

加载布局 layoutInflater.inflate(resourceId, root); inflate()方法一般接收两个参数，第一个参数就是要加载的布局id，第二个参数是指给该布局的外部再嵌套一层父布局，如果不需要就直接传null，有时还有第三个参数，boolean类型的，用法是：

I. 如果root为null，attachToRoot将失去作用，设置任何值都没有意义。

II.如果root不为null，attachToRoot设为true，则会给加载的布局文件的指定一个父布局，即root。

III.如果root不为null，attachToRoot设为false，则会将布局文件最外层的所有layout属性进行设置，当该view被添加到父view当中时，这些layout属性会自动生效。

IV.在不设置attachToRoot参数的情况下，如果root不为null，attachToRoot参数默认为true。

（6）绑定Adapter和RecyclerView

public class MainActivity extends AppCompatActivity {
    ArrayList<Contact> contacts;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        // 找到recyclerview 
        RecyclerView rvContacts = (RecyclerView) findViewById(R.id.rvContacts);
        // 初始化自定义的模型类contacts
        contacts = Contact.createContactsList(20);
        // 通过模型类创建一个适配器
        ContactsAdapter adapter = new ContactsAdapter(contacts);
        //联系adapter与recyclerview的填充项 
        rvContacts.setAdapter(adapter);
        //设置列表项显示规则  线性，瀑布，网格
        rvContacts.setLayoutManager(new LinearLayoutManager(this));
    }
}

这个操作就是先找到RecyclerView的布局，然后把我自定义的模型进行一个初始化，然后创建适配器，再把适配器和 RecyclerView连接起来，setLayoutManager来管理所创建的线性布局new LinearLayoutManager(this)

要哭了，太难懂了。。。