1024程序节|Android框架之一 BRVAH【BaseRecyclerViewAdapterHelper】使用demo

BRVAH是一个强大的RecyclerAdapter框架(什么是RecyclerView？)，它能节约开发者大量的开发时间，集成了大部分列表常用需求解决方案。为什么会有它？请查看「Android开源框架BRVAH由来篇」该框架于2016年4月10号发布的第1个版本到现在已经一年多了，经历了800多次代码提交，140多次版本打包，修复了1000多个问题，获得了9000多star，非常感谢大家的使用以及反馈。
本篇为BRVAH的使用指南以及包含常见问题会第一时间更新最新的使用方法。最新版本请查看releases,由于持续更新。

下面我们就来看看这个开源框架的使用吧

BRVAH 上部

动态图结果展示

---

myAdapter.java【第一个布局适配器】

package com.example.Adapter;

import com.chad.library.adapter.base.BaseQuickAdapter;
import com.chad.library.adapter.base.viewholder.BaseViewHolder;
import com.example.brvhrecycleviewadapter.R;
import com.example.domain.Person;
import com.example.domain.Pictures;

import org.jetbrains.annotations.NotNull;

import java.util.List;

public class myAdapter extends BaseQuickAdapter<Person, BaseViewHolder> {
    public myAdapter(int layoutResId, List<Person> data) {
        super(layoutResId,data);
    }

    @Override
    protected void convert(@NotNull BaseViewHolder baseViewHolder, Person person) {
        // 链式
        //可链式调用赋值
        baseViewHolder.setText(R.id.textView, "第"+ person.getId() + "条数据")
                .setText(R.id.name2, person.getName())
//                .addOnClickListener(R.id.button)//给按钮添加点击事件
                .setImageResource(R.id.imageView,R.drawable.cm);
     
    }
}

注意

这是错误写法，对于布局中的的那个item对象的子控件监听这种方法已经被干掉了，新的方法需要在主活动MainActivity.class中注册。
例如： adapter2.addChildClickViewIds(R.id.img,R.id.tV);
注册布局中item对象里面的img控件和tV控件

---

youAdapter.java【第二个布局适配器】

package com.example.Adapter;


import com.chad.library.adapter.base.BaseQuickAdapter;
import com.chad.library.adapter.base.viewholder.BaseViewHolder;
import com.example.brvhrecycleviewadapter.R;
import com.example.domain.Pictures;

import org.jetbrains.annotations.NotNull;

import java.util.List;

public class youAdapter extends BaseQuickAdapter<Pictures, BaseViewHolder> {
    public youAdapter(int layoutResId, List<Pictures> pictureData) {
        super(layoutResId,pictureData);
    }


    @Override
    protected void convert(@NotNull BaseViewHolder baseViewHolder, Pictures pictures) {
        baseViewHolder
                .setText(R.id.tV,pictures.getName())
                .setBackgroundResource(R.id.img,pictures.getId());
    }
}

---

MainActivity.java【主活动】

package com.example.brvhrecycleviewadapter;

import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.recyclerview.widget.GridLayoutManager;
import androidx.recyclerview.widget.LinearLayoutManager;
import androidx.recyclerview.widget.RecyclerView;

import android.animation.Animator;
import android.os.Bundle;
import android.view.View;
import android.widget.Toast;

import com.chad.library.adapter.base.BaseQuickAdapter;
import com.chad.library.adapter.base.animation.AlphaInAnimation;
import com.chad.library.adapter.base.animation.BaseAnimation;
import com.chad.library.adapter.base.listener.OnItemChildClickListener;
import com.chad.library.adapter.base.listener.OnItemClickListener;
import com.chad.library.adapter.base.listener.OnItemLongClickListener;
import com.example.Adapter.myAdapter;
import com.example.Adapter.youAdapter;
import com.example.domain.Person;
import com.example.domain.Pictures;

import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.TestOnly;

import java.lang.reflect.Array;
import java.util.ArrayList;
import java.util.List;

public class MainActivity extends AppCompatActivity {

    private RecyclerView recyclerView,recyclerView2;
    private List<Person> datas;
    //    private List pictures;
    private List<Pictures> pictureData;
    private myAdapter adapter;
    private youAdapter adapter2;
    private int[] PictureId;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        recyclerView = findViewById(R.id.RecyclerView);//实例化
        recyclerView2=findViewById(R.id.Recycle2);

        PictureId = new int[]{R.drawable.cm, R.drawable.cz, R.drawable.mht, R.drawable.nyg,
                R.drawable.pg, R.drawable.pt, R.drawable.sl, R.drawable.yt,R.drawable.cm,
                R.drawable.cz, R.drawable.mht, R.drawable.nyg,R.drawable.pg, R.drawable.pt,
                R.drawable.sl, R.drawable.yt};

        pictureData = new ArrayList<>();
        Pictures pictures;
        for (int i = 0; i < 16; i++) {
            pictures=new Pictures();
            pictures.setId(PictureId[i]);
            pictures.setName("第"+i+"个");
            pictureData.add(pictures);
        }





        //模拟数据
        datas = new ArrayList<>();
        Person person;
        for (int i = 0; i < 8; i++) {
            person = new Person();
            person.setId(i);
            person.setName("第" + i + "条内容");
            datas.add(person);
        }


        //todo 创建布局管理【必有】
        LinearLayoutManager layoutManager = new LinearLayoutManager(this);
        layoutManager.setOrientation(LinearLayoutManager.VERTICAL);
        recyclerView.setLayoutManager(layoutManager);


        GridLayoutManager  gridLayoutManager=new GridLayoutManager(this,4);
        recyclerView2.setLayoutManager(gridLayoutManager);







//        GridLayoutManager gridLayoutManager=new GridLayoutManager(this,4);
//        recyclerView.setLayoutManager(gridLayoutManager);


        //创建适配器
        adapter = new myAdapter(R.layout.item, datas);
        adapter2=new youAdapter(R.layout.grid_item,pictureData);
//        adapter2.setAdapterAnimation(new BaseAnimation() {
//            @NotNull
//            @Override
//            public Animator[] animators(@NotNull View view) {
//                return new Animator[0];
//            }
//        });

        // 注册子控件点击事件的  button控件按钮
        adapter.addChildClickViewIds(R.id.button);
        adapter2.addChildClickViewIds(R.id.img,R.id.tV);
        // item 点击监听
        adapter.setOnItemClickListener(new OnItemClickListener() {
            @Override
            public void onItemClick(@NonNull @NotNull BaseQuickAdapter<?, ?> adapter, @NonNull @NotNull View view, int position) {
                Toast.makeText(MainActivity.this, "你点击了第" + (position + 1) + "条信息", Toast.LENGTH_SHORT).show();
            }
        });

        // item长按监听
        adapter.setOnItemLongClickListener(new OnItemLongClickListener() {
            @Override
            public boolean onItemLongClick(@NonNull @NotNull BaseQuickAdapter adapter, @NonNull @NotNull View view, int position) {
                Toast.makeText(MainActivity.this, "你长按了第" + (position + 1) + "条信息", Toast.LENGTH_SHORT).show();
                return false;
            }
        });

        // Listview 中item的点击事件监听
        adapter.setOnItemChildClickListener(new OnItemChildClickListener() {
            @Override
            public void onItemChildClick(@NonNull @NotNull BaseQuickAdapter adapter, @NonNull @NotNull View view, int position) {
                Toast.makeText(MainActivity.this, "你点击了" + (position + 1) + "button按钮", Toast.LENGTH_SHORT).show();
            }
        });


        // 两个   adapter2 事件
        adapter2.setOnItemChildClickListener(new OnItemChildClickListener() {
            @Override
            public void onItemChildClick(@NonNull @NotNull BaseQuickAdapter adapter, @NonNull @NotNull View view, int position) {
                switch (view.getId()){
                    case R.id.img:
                        Toast.makeText(MainActivity.this,"你点击了"+(position+1)+"图片",Toast.LENGTH_SHORT).show();
                        break;

                    case R.id.tV:
                        Toast.makeText(MainActivity.this,"你点击了"+(position+1)+"文字",Toast.LENGTH_SHORT).show();
                        break;
                }
            }
        });


        //给RecyclerView设置适配器
        recyclerView.setAdapter(adapter);
        recyclerView2.setAdapter(adapter2);

        adapter.notifyDataSetChanged();
    }

}

---

Person.java【Person对象类】

package com.example.domain;


public class Person {
    public int id;
    public String name;


    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }


}

---

Pictures.java【Picture对象类】

package com.example.domain;

public class Pictures {
    int id;
    String name;
    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }



}

---

---

BRVAH 下部

---

自定义动画

效果图》》》

// 第二个布局添加自定义动画
        adapter2.setAdapterAnimation(new BaseAnimation() {
            @NotNull
            @Override
            public Animator[] animators(@NotNull View view) {
                return new Animator[]{
                        ObjectAnimator.ofFloat(view, "scaleY", 1, 0.1f, 1),
                        ObjectAnimator.ofFloat(view, "scaleX", 1, 0.1f, 1)
                };
            }
        });

默认执行一次，想要反复执行可以自行设置。记得这段要添加在MainActivity.java的adapter2 new出来之后，setAdapter之前
空余时间别忘记了看看源码~~~

---

空布局

说明：当adapter中数据不为空时，空布局不会生效

通过设置View为空布局
代码如下：

View view = ...
adapter.setEmptyView(view);

通过设置LayoutResId为空布局
代码如下：

adapter.setEmptyView(R.layout.loading_view);

设置是否使用空布局（默认为true）
代码如下：

// java
adapter.setUseEmpty(false);

// kotlin
adapter.isUseEmpty = false

---

头部

说明：此头部并不是item的头部，而是整个Adapter的头部
代码如下：

View view = ...；
adapter.addHeaderView(view);

// 指定添加位置
adapter.addHeaderView(view, 1);

// 替换头部
adapter.setHeaderView(view);
//替换指定位置头部
adapter.setHeaderView(view, 0);

// 移除头部
adapter.removeHeaderView(view);
// 移除全部头部
adapter.removeAllHeaderView();

---

头部

说明：此脚部不是item的脚部，而是整个Adapter的
代码如下：

View view = ...；
adapter.addFooterView(view);

// 指定添加位置
adapter.addFooterView(view, 1);

// 替换脚部
adapter.setFooterView(view);
//替换指定位置脚部
adapter.setFooterView(view, 0);

// 移除脚部
adapter.removeFooterView(view);
// 移除全部脚部
adapter.removeAllFooterView();

---

是不是还是不太尽兴，那就来看看Github的详细解释吧。
BaseRecyclerViewAdapterHelper 使用详情页

BaseQuickAdapter主要属性、方法说明

空	Java	Kotlin	说明
获取Context	getContext()	context
数据相关
获取Adapter中数据	getData()	data	只能get
设置新的数据实例	setNewData()	setNewData()	将会替换List指针引用
添加数据	addData()	addData()
移除数据	remove()	remove()
改变某一位置的数据	setData()	setData()
替换整个数据	replaceData()	replaceData()	不会更改原数据的引用
设置Diff数据（异步，推荐）	setDiffCallback()	setDiffCallback()	配置数据差异化比较的Callback
~	setDiffConfig()	setDiffConfig()	更高程度的自定义化配置
~	setDiffNewData(List)	setDiffNewData(List?)	必须先设置setDiffCallback() 或者 setDiffConfig()，否则不生效
设置Diff数据	setDiffNewData(DiffResult, List)	setDiffNewData(DiffResult, List?)	通过DiffResult设置数据，Adapter内部不关心Diff过程，只要结果。
空布局
设置空布局视图	setEmptyView()	setEmptyView()	仅当 data 为空时，才会显示
是否有空视图	hasEmptyView()	hasEmptyView()
获取空视图	getEmptyLayout()	getEmptyLayout()
是否使用空布局	setUseEmpty()	isUseEmpty
头布局
添加头布局	addHeaderView()	addHeaderView()
设置头布局	setHeaderView()	setHeaderView()
是否有头布局	hasHeaderLayout()	hasHeaderLayout()
移除头布局	removeHeaderView()	removeHeaderView()
移除所有头布局	removeAllHeaderView()	removeAllHeaderView()
脚布局
添加脚布局	addFooterView()	addFooterView()
设置脚布局	setFooterView()	setFooterView()
是否有脚布局	hasFooterLayout()	hasFooterLayout()
移除脚布局	removeFooterView()	removeFooterView()
移除所有脚布局	removeAllFooterView()	removeAllFooterView()
布局其他属性
当显示空布局时，是否显示 头布局	setHeaderWithEmptyEnable()	headerWithEmptyEnable
当显示空布局时，是否显示 脚布局	setFooterWithEmptyEnable()	footerWithEmptyEnable
点击事件
item点击事件	setOnItemClickListener()	同java
item长按事件	setOnItemLongClickListener	同java
item子view的点击事件	setOnItemChildClickListener	同java
item子view的长按事件	setOnItemChildLongClickListener	同java
添加需要响应点击事件的子View id	addChildClickViewIds()	同java	添加以后，setOnItemChildClickListener才会响应
添加需要响应长按事件的子View id	getChildLongClickViewIds()	同java
动画
是否打开动画	setAnimationEnable()	animationEnable	默认:false
动画是否仅第一次执行	setAnimationFirstOnly()	isAnimationFirstOnly
设置自定义动画	setAdapterAnimation()	adapterAnimation
设置使用内置默认动画	setAnimationWithDefault()	setAnimationWithDefault()	参数为枚举

---

---

---

---

---

---

觉得有用的可以给个三连，关注一波！！！带你了解更多的Android框架