共计 14560 个字符，预计需要花费 37 分钟才能阅读完成。
目录介绍
1. 复杂页面库介绍
2. 本库优势亮点
2.1 支持多种状态切换管理
2.2 支持添加多个 header 和 footer
2.3 支持侧滑功能和拖拽移动
2.4 其他亮点介绍
3. 如何使用介绍
3.1 最基础的使用
3.2 添加下拉刷新和加载更多监听
3.3 添加 header 和 footer 操作
3.4 设置数据和刷新
3.5 设置 adapter
3.6 设置条目点击事件
3.7 设置侧滑删除功能[QQ 侧滑删除]
3.8 轻量级拖拽排序与滑动删除
4. 关于状态切换
4.1 关于布局内容
4.2 关于实现思路
4.3 关于状态切换 api 调用
4.4 关于自定义状态布局
4.5 关于自定义布局交互事件处理
5. 常用 api 介绍
5.1 状态切换方法说明
5.2 viewHolder 方法说明
5.3 adapter 方法说明
5.4 分割线方法说明
5.5 swipe 侧滑方法说明
5.6 其他 api 说明
6. 优化实现点
6.1 viewHolder 优化
6.2 状态管理器优化
6.3 recyclerView 滑动卡顿优化
6.4 多线程下插入数据优化
6.5 rv 四级缓存
6.6 异常情况下保存状态
7. 实现效果展示
8. 版本更新说明
9. 参考资料说明
10. 其他内容介绍
开源库地址：https://github.com/yangchong2…
自定义支持上拉加载更多，下拉刷新，可以自定义头部和底部，可以添加多个 header，使用一个原生 recyclerView 就可以搞定复杂界面。支持自由切换状态【加载中，加载成功，加载失败，没网络等状态】的控件，可以自定义状态视图 View。拓展功能【支持长按拖拽，侧滑删除】，轻量级，可以选择性添加。持续更新……
1. 复杂页面库介绍
自定义支持上拉加载更多【加载中，加载失败 [比如没有更多数据]，加载异常[无网络]，加载成功等多种状态】，下拉刷新，可以实现复杂的状态页面，支持自由切换状态【加载中，加载成功，加载失败，没网络等状态】的控件，拓展功能[支持长按拖拽，侧滑删除] 可以选择性添加。具体使用方法，可以直接参考 demo 案例。
支持复杂 type 页面，例如添加自定义头部 HeaderView 和底部布局 FooterView，支持横向滑动 list，还可以支持粘贴头部 list[类似微信好友分组]，支持不规则瀑布流效果，支持侧滑删除功能。
2. 本库优势亮点
2.1 支持多种状态切换管理
支持在布局中或者代码设置自定义不同状态的 view，一行代码既可以切换不同的状态，十分方便。
针对自定义状态 view 或者 layout，可以实现交互功能，比如当切换到网络异常的页面，可以点击页面控件取刷新数据或者跳转设置网络页面
2.2 支持添加多个 header 和 footer
支持添加多个自定义 header 头部布局，可以自定义 footer 底部布局。十分方便实现复杂 type 的布局页面，结构上层次分明，便于维护。
支持复杂界面使用，比如有的页面包含有轮播图，按钮组合，横向滑动 list，还有复杂 list，那么用这个控件就可以搞定。
2.3 支持侧滑功能和拖拽移动
轻量级侧滑删除菜单，直接嵌套 item 布局即可使用，使用十分简单
通过自定义 ItemTouchHelper 实现 RecyclerView 条目 Item 拖拽排序，只是设置是否拖拽，设置拖拽 item 的背景颜色，优化了拖拽效果，比如在拖拽过程中设置 item 的缩放和渐变效果
2.4 其他亮点介绍
支持上拉加载，下拉刷新。当上拉加载更多失败或者异常时，可以设置自定义加载更多失败或者异常布局(比如没有网络时的场景)，同时点击该异常或者失败布局可以恢复加载更多数据；当上拉加载更多没有更多数据时，可以设置自定义加载更多无数据布局。
可以设置上拉加载更多后自动加载下一页数据，也可以上拉加载更多后手动触发加载下一页数据。在上拉加载更多时，可以设置加载更多的布局，支持加载监听。
支持粘贴头部的需求效果，这种效果类似微信好友分组的那种功能界面。
支持插入【插入指定索引】，更新【更新指定索引或者 data 数据】或者删除某条数据，支持删除所有数据。同时在多线程条件下，添加了锁机制避免数据错乱！
支持横向滑动 list 效果，支持瀑布流的效果，还支持与 CoordinatorLayout 结合实现炫酷的效果。这种效果特别不错……
已经用于实际开发项目投资界，新芽，沙丘大学中……且经过近三年时间的迭代与维护，持续更新维护中！
3. 如何使用介绍
3.1 最基础的使用
首先在集成：
implementation ‘org.yczbj:YCRefreshViewLib:2.5.8’
在布局中
<org.yczbj.ycrefreshviewlib.YCRefreshView
xmlns:app=”http://schemas.android.com/apk/res-auto”
android:id=”@+id/recyclerView”
android:layout_width=”match_parent”
android:layout_height=”match_parent”
app:layout_progress=”@layout/view_custom_loading_data”
app:layout_empty=”@layout/view_custom_empty_data”
app:layout_error=”@layout/view_custom_data_error”/>
在代码中，初始化 recyclerView
adapter = new PersonAdapter(this);
recyclerView.setAdapter(adapter);
final LinearLayoutManager linearLayoutManager = new LinearLayoutManager(this);
recyclerView.setLayoutManager(linearLayoutManager);
adapter.addAll(data);
在代码中，创建 adapter 实现 RecyclerArrayAdapter<T>
public class PersonAdapter extends RecyclerArrayAdapter<PersonData> {
public PersonAdapter(Context context) {
super(context);
}
@Override
public BaseViewHolder OnCreateViewHolder(ViewGroup parent, int viewType) {
return new PersonViewHolder(parent);
}
public class PersonViewHolder extends BaseViewHolder<PersonData> {
private ImageView iv_news_image;
PersonViewHolder(ViewGroup parent) {
super(parent, R.layout.item_news);
iv_news_image = getView(R.id.iv_news_image);
}
@Override
public void setData(final PersonData person){
}
}
}
3.2 添加下拉刷新和加载更多监听
下拉刷新监听操作
// 设置刷新 listener
recyclerView.setRefreshListener(new SwipeRefreshLayout.OnRefreshListener() {
@Override
public void onRefresh() {
// 刷新操作
}
});
// 设置是否刷新
recyclerView.setRefreshing(false);
// 设置刷新颜色
recyclerView.setRefreshingColorResources(R.color.colorAccent);
上拉加载更多监听操作
第一种情况，上拉加载更多后自动加载下一页数据
// 设置上拉加载更多时布局，以及监听事件
adapter.setMore(R.layout.view_more, new OnLoadMoreListener() {
@Override
public void onLoadMore() {
// 可以做请求下一页操作
}
});
第二种情况，上拉加载更多后手动触发加载下一页数据
adapter.setMore(R.layout.view_more2, new OnMoreListener() {
@Override
public void onMoreShow() {
// 不做处理
}
@Override
public void onMoreClick() {
// 点击触发加载下一页数据
}
});
在上拉加载更多时，可能出现没有更多数据，或者上拉加载失败，该如何处理呢？
// 设置上拉加载没有更多数据监听
adapter.setNoMore(R.layout.view_no_more, new OnNoMoreListener() {
@Override
public void onNoMoreShow() {
// 上拉加载，没有更多数据展示，这个方法可以暂停或者停止加载数据
adapter.pauseMore();
}
@Override
public void onNoMoreClick() {
// 这个方法是点击没有更多数据展示布局的操作，比如可以做吐司等等
Log.e(“ 逗比 ”,” 没有更多数据了 ”);
}
});
// 设置上拉加载更多异常监听数据监听
adapter.setError(R.layout.view_error, new OnErrorListener() {
@Override
public void onErrorShow() {
// 上拉加载，加载更多数据异常展示，这个方法可以暂停或者停止加载数据
adapter.pauseMore();
}
@Override
public void onErrorClick() {
// 这个方法是点击加载更多数据异常展示布局的操作，比如恢复加载更多等等
adapter.resumeMore();
}
});
3.3 添加 header 和 footer 操作
添加 headerView 操作。至于添加 footerView 的操作，几乎和添加 header 步骤是一样的。
添加普通的布局【非 listView 或者 RecyclerView 布局】
adapter.addHeader(new InterItemView() {
@Override
public View onCreateView(ViewGroup parent) {
View inflate = LayoutInflater.from(context).inflate(R.layout.header_view, null);
return inflate;
}
@Override
public void onBindView(View headerView) {
TextView tvTitle = headerView.findViewById(R.id.tvTitle);
}
});
添加 list 布局【以横向 recyclerView 为例子】
adapter.addHeader(new InterItemView() {
@Override
public View onCreateView(ViewGroup parent) {
RecyclerView recyclerView = new RecyclerView(parent.getContext()){
// 为了不打扰横向 RecyclerView 的滑动操作，可以这样处理
@SuppressLint(“ClickableViewAccessibility”)
@Override
public boolean onTouchEvent(MotionEvent event) {
super.onTouchEvent(event);
return true;
}
};
return recyclerView;
}
@Override
public void onBindView(View headerView) {
// 这里的处理别忘了
((ViewGroup)headerView).requestDisallowInterceptTouchEvent(true);
}
});
注意要点
如果添加了 HeaderView，凡是通过 ViewHolder 拿到的 position 都要减掉 HeaderView 的数量才能得到正确的 position。
3.4 设置数据和刷新
添加所有数据，可以是集合，也可以是数组
// 添加所有数据
adapter.addAll(data);
// 添加单挑数据
adapter.add(data);
插入，刷新和删除数据
// 插入指定索引数据，单个数据
adapter.insert(data, pos);
// 插入指定索引数据，多个数据
adapter.insertAll(data, pos);
// 刷新指定索引数据
adapter.update(data, pos);
// 删除数据，指定数据
adapter.remove(data);
// 删除数据，指定索引
adapter.remove(pos);
// 清空所有数据
3.5 设置 adapter
注意自定义 adapter 需要实现 RecyclerArrayAdapter<T>，其中 T 是泛型，就是你要使用的 bean 数据类型
public class PersonAdapter extends RecyclerArrayAdapter<PersonData> {
public PersonAdapter(Context context) {
super(context);
}
@Override
public BaseViewHolder OnCreateViewHolder(ViewGroup parent, int viewType) {
return new PersonViewHolder(parent);
}
public class PersonViewHolder extends BaseViewHolder<PersonData> {
private TextView tv_title;
private ImageView iv_news_image;
PersonViewHolder(ViewGroup parent) {
super(parent, R.layout.item_news);
iv_news_image = getView(R.id.iv_news_image);
tv_title = getView(R.id.tv_title);
// 添加孩子的点击事件
addOnClickListener(R.id.iv_news_image);
addOnClickListener(R.id.tv_title);
}
@Override
public void setData(final PersonData person){
Log.i(“ViewHolder”,”position”+getDataPosition());
tv_title.setText(person.getName());
}
}
}
3.6 设置条目点击事件
条目单击点击事件，长按事件[省略，可以自己看代码]
adapter.setOnItemClickListener(new OnItemClickListener() {
@Override
public void onItemClick(int position) {
if (adapter.getAllData().size()>position && position>=0){
// 处理点击事件逻辑
}
}
});
条目中孩子的点击事件
// 添加孩子的点击事件，可以看 3.5 设置 adapter
addOnClickListener(R.id.iv_news_image);
addOnClickListener(R.id.tv_title);
// 设置孩子的点击事件
adapter.setOnItemChildClickListener(new OnItemChildClickListener() {
@Override
public void onItemChildClick(View view, int position) {
switch (view.getId()){
case R.id.iv_news_image:
Toast.makeText(HeaderFooterActivity.this,
“ 点击图片了 ”,Toast.LENGTH_SHORT).show();
break;
case R.id.tv_title:
Toast.makeText(HeaderFooterActivity.this,
“ 点击标题 ”,Toast.LENGTH_SHORT).show();
break;
default:
break;
}
}
});
3.7 设置侧滑删除功能[QQ 侧滑删除]
在布局文件中，这里省略部分代码
<org.yczbj.ycrefreshviewlib.swipeMenu.YCSwipeMenu
android:orientation=”horizontal”>
<!–item 内容 –>
<RelativeLayout
</RelativeLayout>
<!– 侧滑菜单 –>
<Button
android:id=”@+id/btn_del”/>
<Button
android:id=”@+id/btn_top”/>
</org.yczbj.ycrefreshviewlib.swipeMenu.YCSwipeMenu>
在代码中设置
在 adapter 中定义接口
private OnSwipeMenuListener listener;
public void setOnSwipeMenuListener(OnSwipeMenuListener listener) {
this.listener = listener;
}
在 adapter 设置点击事件
View.OnClickListener clickListener = new View.OnClickListener() {
@Override
public void onClick(View v) {
switch (v.getId()){
case R.id.btn_del:
if (null != listener) {
listener.toDelete(getAdapterPosition());
}
break;
case R.id.btn_top:
if (null != listener) {
listener.toTop(getAdapterPosition());
}
break;
}
}
};
btn_del.setOnClickListener(clickListener);
btn_top.setOnClickListener(clickListener);
处理置顶或者删除的功能
adapter.setOnSwipeMenuListener(new OnSwipeMenuListener() {
// 删除功能
@Override
public void toDelete(int position) {
}
// 置顶功能
@Override
public void toTop(int position) {
}
});
3.8 轻量级拖拽排序与滑动删除
处理长按拖拽，滑动删除的功能。轻量级，自由选择是否实现。
mCallback = new DefaultItemTouchHelpCallback(new DefaultItemTouchHelpCallback
.OnItemTouchCallbackListener() {
@Override
public void onSwiped(int adapterPosition) {
// 滑动删除的时候，从数据库、数据源移除，并刷新 UI
}
@Override
public boolean onMove(int srcPosition, int targetPosition) {
return false;
}
});
mCallback.setDragEnable(true);
mCallback.setSwipeEnable(true);
mCallback.setColor(this.getResources().getColor(R.color.colorAccent));
ItemTouchHelper itemTouchHelper = new ItemTouchHelper(mCallback);
itemTouchHelper.attachToRecyclerView(recyclerView);
4. 关于状态切换
4.1 关于布局内容
YCRecyclerView 是一个组合自定义控件，其布局如下所示
<!– 刷新控件 省略部分代码 –>
<android.support.v4.widget.SwipeRefreshLayout>
<FrameLayout>
<!–RecyclerView 控件 –>
<android.support.v7.widget.RecyclerView/>
<!– 加载数据为空时的布局 –>
<FrameLayout/>
<!– 正在加载数据中的布局 –>
<FrameLayout/>
<!– 加载错误时的布局：网络错误或者请求数据错误 –>
<FrameLayout/>
</FrameLayout>
</android.support.v4.widget.SwipeRefreshLayout>
4.2 关于实现思路
关于页面状态切换的思路
第一种方式：直接把这些界面 include 到 main 界面中，然后动态去切换界面，后来发现这样处理不容易复用到其他项目中，而且在 activity 中处理这些状态的显示和隐藏比较乱
第二种方式：利用子类继承父类特性，在父类中写切换状态，但有些界面如果没有继承父类，又该如何处理
而本库采用的做法思路
一个帧布局 FrameLayout 里写上 4 种不同类型布局，正常布局，空布局，加载 loading 布局，错误布局[网络异常，加载数据异常]
当然也可以自定义这些状态的布局，通过 addView 的形式，将不同状态布局添加到对应的 FrameLayout 中。而切换状态，只需要设置布局展示或者隐藏即可。
4.3 关于状态切换 api 调用
如下所示
// 设置加载数据完毕状态
recyclerView.showRecycler();
// 设置加载数据为空状态
recyclerView.showEmpty();
// 设置加载错误状态
recyclerView.showError();
// 设置加载数据中状态
recyclerView.showProgress();
4.4 关于自定义状态布局
如下所示
// 设置空状态页面自定义布局
recyclerView.setEmptyView(R.layout.view_custom_empty_data);
recyclerView.setEmptyView(view);
// 获取空页面自定义布局
View emptyView = recyclerView.getEmptyView();
// 设置异常状态页面自定义布局
recyclerView.setErrorView(R.layout.view_custom_data_error);
recyclerView.setErrorView(view);
// 设置加载 loading 状态页面自定义布局
recyclerView.setProgressView(R.layout.view_progress_loading);
recyclerView.setProgressView(view);
4.5 关于自定义布局交互事件处理
有时候，加载页面出现异常情况，比如没有网络会显示自定义的网络异常页面。现在需要点击异常页面按钮等等操作，那么该如何做呢？
// 注意需要
LinearLayout ll_error_view = (LinearLayout) recyclerView.findViewById(R.id.ll_error_view);
ll_error_view.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
// 比如，跳转到网络设置页面，或者再次刷新数据，或者其他操作等等
}
});
5. 常用 api 介绍
状态切换方法说明
// 设置加载数据完毕状态
recyclerView.showRecycler();
// 设置加载数据为空状态
recyclerView.showEmpty();
// 设置加载错误状态
recyclerView.showError();
// 设置加载数据中状态
recyclerView.showProgress();
// 设置自定义布局，其他几个方法同理
recyclerView.setEmptyView(R.layout.view_custom_empty_data);
viewHolder 方法说明
// 子类设置数据方法
setData 方法
//findViewById 方式
iv_news_image = getView(R.id.iv_news_image);
// 获取上下文
Context context = getContext();
// 获取数据索引的位置
int dataPosition = getDataPosition();
// 添加 item 中子控件的点击事件
addOnClickListener(R.id.tv_title);
adapter 方法说明
// 删除索引处的数据
adapter.remove(0);
// 触发清空所有数据
adapter.removeAll();
// 添加数据，注意这个是在最后索引处添加
adapter.add(new PersonData());
// 添加所有数据
adapter.addAll(DataProvider.getPersonList(0));
// 插入数据
adapter.insert(data,3);
// 在某个索引处插入集合数据
adapter.insertAll(data,3);
// 获取 item 索引位置
adapter.getPosition(data);
// 触发清空所有的数据
adapter.clear();
// 获取所有的数据
adapter.getAllData();
// 清除所有 footer
adapter.removeAllFooter();
// 清除所有 header
adapter.removeAllHeader();
// 添加 footerView
adapter.addFooter(view);
// 添加 headerView
adapter.addHeader(view);
// 移除某个 headerView
adapter.removeHeader(view);
// 移除某个 footerView
adapter.removeFooter(view);
// 获取某个索引处的 headerView
adapter.getHeader(0);
// 获取某个索引处的 footerView
adapter.getFooter(0);
// 获取 footer 的数量
adapter.getFooterCount();
// 获取 header 的数量
adapter.getHeaderCount();
// 设置上拉加载更多的自定义布局和监听
adapter.setMore(R.layout.view_more,listener);
// 设置上拉加载更多的自定义布局和监听
adapter.setMore(view,listener);
// 设置上拉加载没有更多数据布局
adapter.setNoMore(R.layout.view_nomore);
// 设置上拉加载没有更多数据布局
adapter.setNoMore(view);
// 设置上拉加载没有更多数据监听
adapter.setNoMore(R.layout.view_nomore,listener);
// 设置上拉加载异常的布局
adapter.setError(R.layout.view_error);
// 设置上拉加载异常的布局
adapter.setError(view);
// 设置上拉加载异常的布局和异常监听
adapter.setError(R.layout.view_error,listener);
// 暂停上拉加载更多
adapter.pauseMore();
// 停止上拉加载更多
adapter.stopMore();
// 恢复上拉加载更多
adapter.resumeMore();
// 获取上下文
adapter.getContext();
// 应该使用这个获取 item 个数
adapter.getCount();
// 设置操作数据 [增删改查] 后，是否刷新 adapter
adapter.setNotifyOnChange(true);
// 设置孩子点击事件
adapter.setOnItemChildClickListener(listener);
// 设置条目点击事件
adapter.setOnItemClickListener(listener);
// 设置条目长按事件
adapter.setOnItemLongClickListener(listener);
分割线方法说明
// 可以设置线条颜色和宽度的分割线
// 四个参数，上下文，方向，线宽，颜色
final RecycleViewItemLine line = new RecycleViewItemLine(this, LinearLayout.HORIZONTAL,
(int)AppUtils.convertDpToPixel(1,this),
this.getResources().getColor(R.color.color_f9f9f9));
recyclerView.addItemDecoration(line);
// 适用于瀑布流中的间距设置
SpaceViewItemLine itemDecoration = new SpaceViewItemLine(
(int) AppUtils.convertDpToPixel(8,this));
itemDecoration.setPaddingEdgeSide(true);
itemDecoration.setPaddingStart(true);
itemDecoration.setPaddingHeaderFooter(true);
recyclerView.addItemDecoration(itemDecoration);
// 可以设置线条颜色和宽度，并且可以设置距离左右的间距
DividerViewItemLine itemDecoration = new
DividerViewItemLine(this.getResources().getColor(R.color.color_f9f9f9)
, LibUtils.dip2px(this, 1f),
LibUtils.dip2px(this, 72), 0);
itemDecoration.setDrawLastItem(false);
recyclerView.addItemDecoration(itemDecoration);
其他 api 说明
7. 实现效果展示
7.1 使用过 YCRefreshView 库的案例代码
可以直接参考 demo，或者直接参考的我其他案例，其中这几个案例中使用到了该库
https://github.com/yangchong2…
https://github.com/yangchong2…
7.2 图片展示效果
7.3 部分案例图展示[部分案例图可以参考 7.1]
8. 版本更新说明
v1.0 更新于 2016 年 11 月 2 日
v1.1 更新于 2017 年 3 月 13 日
v1.3 更新于 2017 年 8 月 9 日
v1.…… 更新于 2018 年 1 月 5 日
v2.2 更新于 2018 年 1 月 17 日
v2.3 更新于 2018 年 2 月 9 日
v2.4 更新于 2018 年 3 月 19 日
v2.5.6 更新于 2018 年 8 月 6 日
v2.5.7 更新于 2019 年 3 月 3 日
v2.5.8 更新于 2019 年 3 月 4 日
9. 参考资料说明
非常感谢前辈大神的封装思路和代码案例，感谢！！！
https://github.com/XRecyclerV…
BGARefreshLayout-Android：https://github.com/bingoogola…
Android-PullToRefresh：https://github.com/chrisbanes…
adapter：https://github.com/CymChad/Ba…
fastAdapter：https://github.com/mikepenz/F…
Jude95/EasyRecyclerView：https://github.com/Jude95/Eas…
UltimateRecyclerView：https://github.com/cymcsg/Ult…
关于 viewHolder 的封装，参考是鸿洋大神的 baseAdapter
关于 RecyclerView 实现条目 Item 拖拽排序与滑动删除，参看是严正杰大神的博客，拖拽排序
关于仿照 QQ 侧滑删除，参考是 SwipeMenu 的案例，具体可以看：SwipeMenu
10. 其他内容介绍
01. 关于博客汇总链接
1. 技术博客汇总
2. 开源项目汇总
3. 生活博客汇总
4. 喜马拉雅音频汇总
5. 其他汇总
02. 关于我的博客
我的个人站点：www.yczbj.org，www.ycbjie.cn
github：https://github.com/yangchong211
知乎：https://www.zhihu.com/people/…
简书：http://www.jianshu.com/u/b7b2…
csdn：http://my.csdn.net/m0_37700275
喜马拉雅听书：http://www.ximalaya.com/zhubo…
开源中国：https://my.oschina.net/zbj161…
泡在网上的日子：http://www.jcodecraeer.com/me…
邮箱：yangchong211@163.com
阿里云博客：https://yq.aliyun.com/users/a… 239.headeruserinfo.3.dT4bcV
segmentfault 头条：https://segmentfault.com/u/xi…
掘金：https://juejin.im/user/593943…
03. 勘误及提问
如果有疑问或者发现错误，可以在相应的 issues 进行提问或勘误。如果喜欢或者有所启发，欢迎 star，对作者也是一种鼓励。
04. 关于 LICENSE
Licensed under the Apache License, Version 2.0 (the “License”);
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an “AS IS” BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
关于开源库地址：https://github.com/yangchong2…
