MultiItem進階 實現Head Foot和加載更多-多類型RecyclerView Adapter

前言

本文是MultiItem系列的進階文章，主要講解header footer和下拉刷新加載更多功能的用法與實現詳解，上篇文章MultiItem用法與詳解-優雅的實現多類型RecyclerView Adapter講解了一些基本的用法和依賴方式，沒有看過的同窗能夠點擊查看。
MutliItem主要解決多類型RecyclerView Adapter問題，在正常使用中作到了Adapter零編碼，解放了複雜的Adapter類，提升擴展性。
本庫的定位並非大而全，可是會盡可能作到簡單實用。

源碼地址

Github地址：github.com/free46000/M…，請你們多多關注，更多更新會首先在GitHub上體現，也會在第一時間在本平臺發佈

效果截圖

圖片作過處理一張10幾kb

headfoot

fullspan

loadmore

用法

爲列表添加header和footer

添加header footer提供兩種方式，直接addView或者addItem方式：

//爲XXBean數據源註冊XXManager管理類
adapter.register(TextBean.class, new TextViewManager());

//添加header
TextView headView = new TextView(this);
headView.setText("經過addHeadView增長的head1");
//方式一：方便實際業務使用
adapter.addHeadView(headView);
//方式二：這種方式和直接addDataItem添加數據源原理同樣
adapter.addHeadItem(new TextBean("經過addHeadItem增長的head2"));

//添加footer，方式同添加header
TextView footView = new TextView(this);
footView.setText("經過addFootView增長的foot1");
adapter.addFootView(footView);
adapter.addFootItem(new TextBean("經過addFootItem增長的foot2"));複製代碼

爲表格添加充滿寬度的Item(含header和footer)

充滿寬度詳見ViewHolderManager#isFullSpan返回true便可，適用於head foot或任意數據源Item

//此處爲TextBean數據源註冊FullSpanTextViewManager管理類
adapter.register(TextBean.class, new FullSpanTextViewManager());

//添加header或者footer
TextView headView = new TextView(this);
headView.setText("經過addHeadView增長的head1");
//使用HeadFootHolderManager已經實現isFullSpan方法，默認充滿寬度
adapter.addHeadView(headView);

//添加普通Item,詳見FullSpanTextViewManager，默認充滿寬度
adapter.addDataItem(new TextBean("FullSpanTextViewManager充滿寬度Item"));複製代碼

下拉刷新加載更多功能的用法

下拉刷新採用SwipeRefreshLayout這裏就不在過多介紹，開啓和處理加載更多功能比較簡單，可是須要注意加載更多本質上是一個footer，而且對添加順序敏感，因此須要先去addFoot後在調用開啓方法：

//開啓加載更多視圖
adapter.enableLoadMore(new LoadMoreHolderManager(this::loadData));

//加載完成 isLoadAll:是否所有數據
adapter.setLoadCompleted(boolean isLoadAll);

//加載失敗
adapter.setLoadFailed();複製代碼

經過開啓方法咱們能夠看出依賴於LoadMoreHolderManager,主要是處理不一樣狀態下加載更多界面的變化，下面貼出代碼，更多實現細節請參閱LoadMoreManager：

/** * 加載更多視圖管理類 */
public class LoadMoreHolderManager extends LoadMoreManager {

    public LoadMoreHolderManager(OnLoadMoreListener onLoadMoreListener, boolean isAutoLoadMore) {
        super(onLoadMoreListener, isAutoLoadMore);
    }

    @Override
    protected int getItemLayoutId() {
        return R.layout.item_load_more;
    }

    @Override
    protected void updateLoadInitView() {
        ((TextView) getView(loadMoreView, R.id.text)).setText("");
    }

    @Override
    protected void updateLoadingMoreView() {
        ((TextView) getView(loadMoreView, R.id.text)).setText(R.string.loading_more);
    }

    @Override
    protected void updateLoadCompletedView(boolean isLoadAll) {
        ((TextView) getView(loadMoreView, R.id.text))
                .setText(isLoadAll ? R.string.load_all : R.string.load_has_more);
    }

    @Override
    protected void updateLoadFailedView() {
        ((TextView) getView(loadMoreView, R.id.text)).setText(R.string.load_failed);
    }
}複製代碼

至此本庫的header footer和下拉刷新加載更多功能的用法已經完成，並無修改或繼承RecyclerView Adapter類，徹底使用默認實現BaseItemAdapter便可。

詳解

header和footer

主要利用Multiitem的多類型特性，封裝了實用api而已，在BaseItemAdapter中維護了headItems footItems兩個集合，在getItem的時候根據順序獲取數據，以下：

/** * @param position int * @return 返回指定位置Item */
public Object getItem(int position) {
    if (position < headItems.size()) {
        return headItems.get(position);
    }

    position -= headItems.size();
    if (position < dataItems.size()) {
        return dataItems.get(position);
    }

    position -= dataItems.size();
    return footItems.get(position);
}複製代碼

爲表格添加充滿寬度的Item

在ViewHolderManager中封裝了兩個方法以適配表格佈局的時候填充寬度：

/** * @return 是否填滿父佈局 * @see StaggeredGridLayoutManager.LayoutParams#setFullSpan * @see GridLayoutManager#setSpanSizeLookup */
public boolean isFullSpan() {
    return fullSpan;
}

/** * 根據spanCount獲取當前所佔span大小(適用於表格佈局) * 若是被設置過正整數則返回；若是是fullSpan則返回spanCount；其他返回1 * GridLayoutManager模式下，調整本方法返回值達到不一樣Item佔用不一樣寬度的功能 * * @param spanCount span總數量 * @return 當前所佔span大小 * @see GridLayoutManager#setSpanSizeLookup */
public int getSpanSize(int spanCount) {
    return spanSize > 0 ? spanSize : (isFullSpan() ? spanCount : 1);
}複製代碼

加載更多

加載更多利用onBindViewHolder 這個 RecyclerView Adapter的回調方法實現了對加載更多視圖狀態的模板方法的封裝，並提供了對應的處理方法，詳見LoadMoreManager,這裏貼出關鍵代碼：

@Override
public void onBindViewHolder(@NonNull BaseViewHolder holder, @NonNull Object o) {
    if (isNeeLoadMore(holder)) {
        if (isAutoLoadMore()) {
            //當能夠加載更多數據並開啓自動加載後調用
            onLoadMore();
        }
    } else {
        updateLoadInitView();
    }
}

/** * 避免第一次可見時去加載數據 * 若head和foot的數量小於當前loadMore的位置則證實沒有ItemData數據，即爲RecyclerView加載數據前 * * @param holder * @return 是否須要加載更多 */
protected boolean isNeeLoadMore(@NonNull BaseViewHolder holder) {
    int headFootCount = adapter.getHeadCount() + adapter.getFootCount();
    return headFootCount < holder.getItemPosition();
}複製代碼

但願你們會喜歡，多多留言交流