MultiTypeAdapter

提供灵活、便捷以及可插拔的多类型视图。

目前支持

多类型数据
多类型视图
数据与视图一对一组合
数据与视图一对多组合
列表项及子控件点击长按事件
自定义事件
自定义ViewHolder
自定义列表项所占列数
其他
- 头部/底部
- 正在加载/空数据/加载错误/没有网络/自定义状态`
- 加载更多
- 通用分割线

架包引入

1. 添加仓库

maven { url 'https://jitpack.io' }

2. 添加依赖

compile 'com.github.senierr:MultiTypeAdapter:1.1.0'

注意：

MultiTypeAdapter内部依赖了:

compile 'com.android.support:support-annotations:25.3.1'
compile 'com.android.support:recyclerview-v7:25.3.1'

依赖关系如下：

+--- com.github.senierr:MultiTypeAdapter:RELEASE_VERSION
|    |    +--- com.android.support:support-annotations:25.3.1
|    |    +--- com.android.support:recyclerview-v7:25.3.1

如不需要，可通过以下方式关闭传递性依赖：

compile ('com.github.senierr:MultiTypeAdapter:RELEASE_VERSION', {
    transitive = false
})
或者
compile 'com.github.senierr:MultiTypeAdapter:RELEASE_VERSION@aar'

基本使用

// 1. 定义产线
public class FirstWrapper extends ViewHolderWrapper<DataBean> {

    public FirstWrapper() {
        /**
         * 构造函数，指定产线的职能：处理的数据类型和布局类型
         *
         * 注：一条产线只能负责一类数据和一类布局，细分职责粒度，方便重用。
         */
        super(DataBean.class, R.layout.item_first);
    }

    @Override
    public void onBindViewHolder(@NonNull RVHolder holder, @NonNull DataBean item) {
        // 定义如何排版，数据如何写入
        ......
    }
}

// 2. 创建工厂
MultiTypeAdapter multiTypeAdapter = new MultiTypeAdapter();
// 3. 注册产线
multiTypeAdapter.register(new FirstWrapper())
// 4. 设置数据
multiTypeAdapter.setDataList(list);
// 5. 开始装订
recyclerView.setAdapter(multiTypeAdapter);

进阶使用

1. 点击长按事件

// 1. 列表项点击长按事件
setOnItemClickListener(OnItemClickListener onItemClickListener)

// 2. 子控件点击长按事件
setOnItemChildClickListener(int childId, OnItemChildClickListener onItemChildClickListener)

2. 自定义ViewHolder

/**
 * 获取父类创建的RVHolder，实现灵活的自定义事件，或者返回创建的自定义RVHolder。
 */
@Override @NonNull
public RVHolder onCreateViewHolder(@NonNull ViewGroup parent) {
    RVHolder rvHolder = super.onCreateViewHolder(parent);
    ......
    return rvHolder;
}

3. 自定义占据列数

/**
 * 自定义占据列数
 *
 * 默认返回1。
 */
@Override
public int getSpanSize(T item) {
    return 1;
}

4. 协同/一对多

协同/一对多：即多条产线共同处理相同指定类型数据；例如：聊天列表界面，相同的聊天数据（ChatBean），对应不同的布局（当前用户和其他用户）。

/**
 * 处理相同类型数据的产线都会收到询问：是否接受分配任务。
 *
 * 默认返回true。
 */
@Override
public boolean onAcceptAssignment(T item) {
    ......
    return true;
}

其他

头部/底部、状态显示、加载更多等，本质上都是一种数据类型，以及对应的ViewHolderWrapper。

MultiTypeAdapter内部提供了简便的处理方式，详见support包。

1. 头部/底部

只要实现ViewHolderWrapper并重写getSpanSize()，返回总列数即可占满全宽。

2. 状态显示

BaseStateWrapper内部支持正在加载、空数据、加载错误、没有网络及自定义状态状态显示。

注意：调用stateWrapper.show...()时，会清空MultiTypeAdapter内部数据，并增加一条新数据stateBean，重新加载数据时记得先clear()、clear()、clear()!

public class StateWrapper extends BaseStateWrapper {
    public StateWrapper() {
        super(R.layout.item_state);
    }

    @Override
    public void onBindViewHolder(@NonNull RVHolder holder, @NonNull StateBean item) {
        switch (item.getState()) {
            case StateBean.STATE_LOADING:
                ......
                break;
            case StateBean.STATE_EMPTY:
                ......
                break;
            case StateBean.STATE_ERROR:
                ......
                break;
            case StateBean.STATE_NO_NETWORK:
                ......
                break;
        }
    }
}

multiTypeAdapter.register(stateWrapper);
stateWrapper.showLoading();         // 正在加载
stateWrapper.showEmpty();           // 空数据
stateWrapper.showError();           // 加载错误
stateWrapper.showNoNetwork();       // 没有网络
stateWrapper.refreshView(state);    // 自定义状态

3. 加载更多

注意： 要在列表数据末添加加载更多（LoadMoreBean）类型数据。

public class LoadMoreWrapper extends BaseLoadMoreWrapper {
    public LoadMoreWrapper() {
        super(R.layout.item_third);
    }

    @Override
    public void onBindViewHolder(@NonNull RVHolder holder, @NonNull LoadMoreBean item) {
        switch (item.getLoadState()) {
            case LoadMoreBean.STATUS_LOADING:
                ......
                break;
            case LoadMoreBean.STATUS_LOADING_COMPLETED:
                ......
                break;
            case LoadMoreBean.STATUS_LOAD_NO_MORE:
                ......
                break;
            case LoadMoreBean.STATUS_LOAD_FAILURE:
                ......
                break;
        }
    }
}

setOnLoadMoreListener(OnLoadMoreListener onLoadMoreListener)
multiTypeAdapter.register(loadMoreWrapper);
list.add(loadMoreWrapper.getLoadMoreBean());

4. 通用分割线

RVItemDecoration： 详见support包

目前支持

设置宽度、颜色
线性、表格、瀑布流三种类型布局
横竖屏两种方向

混淆

MultiTypeAdapter默认是可以被混淆的，如果仍希望不被混淆：

-dontwarn com.senierr.adapter.**
-keep class com.senierr.adapter.** { *; }

License

Copyright 2017 senierr

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.

budworm / multitypeadapter Goto Github PK