基于BaseRecyclerViewAdapterHelper封裝的多條目Adapter，方便快捷，便于維護(hù)

??項(xiàng)目地址： https://github.com/chaychan/MultipleItemRvAdapter

??已提交并整合到BaseRecyclerViewAdapterHelper，下面介紹如何使用改進(jìn)后的多條目adapter。

??效果圖，我之前做過(guò)的精仿今日頭條,新聞列表中有好幾種布局：

home.jpg

Apk下載地址

[點(diǎn)擊下載體驗(yàn)]

??MultipleItemRvAdapter是在BaseRecyclerViewAdapterHelper的基礎(chǔ)上對(duì)BaseQuickAdapter進(jìn)行封裝，在包含BaseRecyclerViewAdapterHelper所有功能的基礎(chǔ)上，對(duì)其中的多條目布局處理邏輯進(jìn)行了封裝，將adapter中每種子條目單獨(dú)出對(duì)應(yīng)的ItemProvider，這樣方便相應(yīng)條目做相關(guān)的業(yè)務(wù)邏輯。

項(xiàng)目介紹

BaseRecyclerViewAdapterHelper

image

??BaseRecyclerViewAdapterHelper是一個(gè)封裝好的萬(wàn)能RecyclerView的適配器，可以方便快捷地完成adapter的編寫(xiě)，包含一種或多種子條目的處理且擁有許多強(qiáng)大的功能，比如上拉加載更多、支持添加動(dòng)畫(huà)、可以添加子條目的點(diǎn)擊、長(zhǎng)按事件、添加頭部和底部等，現(xiàn)擁有12.6K多的star數(shù)，受到不少Android開(kāi)發(fā)者的青睞，我在項(xiàng)目的開(kāi)發(fā)中也使用BaseRecyclerViewAdapterHelper，是一名忠實(shí)的粉絲。

BaseRecyclerViewAdapterHelper 多條目布局的不足之處

??BaseRecyclerViewAdapterHelper中對(duì)多條目布局的邏輯都放在convert()方法中，通過(guò)判斷對(duì)應(yīng)的itemViewTyper來(lái)進(jìn)行相應(yīng)子條目的處理，當(dāng)條目特別多以及擁有復(fù)雜業(yè)務(wù)邏輯的情況，convert()中的處理將會(huì)特別多，不便于往后項(xiàng)目的維護(hù)，比如IM里面的消息列表，有文本、圖片、語(yǔ)音、位置、紅包、轉(zhuǎn)賬等，有很多種不同布局，對(duì)應(yīng)的邏輯也比較多，在只使用BaseRecyclerViewAdapterHelper的情況下，對(duì)應(yīng)消息列表的adapter代碼就已經(jīng)破一千行，全部條目的邏輯都在一個(gè)adapter種，覺(jué)得不是特別合理，如下是消息列表的adapter:

public class MessageListAdapter extends BaseQuickAdapter<Message,BaseViewHolder>{

public static final int TYPE_TEXT = 0;
public static final int TYPE_IMG = 1;

public MessageListAdapter(int layoutResId, @Nullable List<Message> data) {
        super(layoutResId, data);

        setMultiTypeDelegate(new MultiTypeDelegate<Message>() {
            @Override
            protected int getItemType(Message message) {
                if (message instanceof TextMessage){
                    return TYPE_TEXT;
                }else if (message instanceof ImageMessage){
                    return TYPE_IMG;
                }
                // else if(){
                //     //還有其他消息類(lèi)型，比如語(yǔ)音、位置、紅包、轉(zhuǎn)賬等
                // }

                return 0;
            }
        });

        getMultiTypeDelegate()
                .registerItemType(TYPE_TEXT, R.layout.item_text_message)
                .registerItemType(TYPE_IMG, R.layout.item_image_message);
                //還有其他消息類(lèi)型，比如語(yǔ)音、位置、紅包、轉(zhuǎn)賬等
    }

    @Override
    protected void convert(BaseViewHolder helper, Message item) {
        int viewType = helper.getItemViewType();
        switch (viewType){
            case TYPE_TEXT:
                //文本消息的業(yè)務(wù)邏輯

                break;
            case TYPE_IMG:
                //圖片消息的業(yè)務(wù)邏輯

                break;
             // case 語(yǔ)音、位置、紅包、轉(zhuǎn)賬等
            // break;
        }
    }
}

??當(dāng)子條目有許多種的時(shí)候，convert()中的邏輯將會(huì)很多，不便于項(xiàng)目的維護(hù)，故而封裝了MultipleItemRvAdapter，將每個(gè)條目的邏輯處理都交給創(chuàng)建的ItemProvider來(lái)處理，這樣可以在對(duì)應(yīng)條目的ItemProvider寫(xiě)相應(yīng)的邏輯，方便維護(hù)。

如何使用MultipleItemRvAdapter

一、創(chuàng)建對(duì)應(yīng)條目的ItemProvider，繼承BaseItemProvider，注解ItemProviderTag中填寫(xiě)對(duì)應(yīng)的viewType的值（建議在對(duì)應(yīng)的adapter中定義常量，每種條目的viewType必須唯一）, layout指定對(duì)應(yīng)條目的布局id。

比如文本消息條目的provider：

/**
 * @author ChayChan
 * @description 文本消息條目的provider
 * @date 2018/3/21  14:43
 */
@ItemProviderTag(
    viewType = MessageListAdapter.TYPE_TEXT,
    layout = R.layout.item_text_message
)
public class TextMessageItemProvider extends BaseItemProvider<TextMessage> {

    @Override
    public void convert(BaseViewHolder helper, TextMessage data, int position) {
        //處理相關(guān)業(yè)務(wù)邏輯
        helper.setText(R.id.tv_text, data.text);
    }

    @Override
    public void onClick(BaseViewHolder helper, TextMessage data, int position) {
        //單擊事件
        Toast.makeText(mContext, "Click: " + data.text, Toast.LENGTH_SHORT).show();
    }

    @Override
    public boolean onLongClick(BaseViewHolder helper, TextMessage data, int position) {
        //長(zhǎng)按事件
        Toast.makeText(mContext, "longClick: " + data.text, Toast.LENGTH_SHORT).show();
        return true;
    }
}

圖片消息條目的provider：

/**
 * @author ChayChan
 * @description 圖片消息條目的provider
 * @date 2018/3/21  14:43
 */
@ItemProviderTag(
        viewType = MessageListAdapter.TYPE_IMG,
        layout = R.layout.item_image_message
)
public class ImageMessageItemProvider extends BaseItemProvider<ImageMessage> {

    @Override
    public void convert(BaseViewHolder helper, ImageMessage data, int position) {
        //處理相關(guān)業(yè)務(wù)邏輯
        ImageView iv = helper.getView(R.id.iv_img);
        Glide.with(mContext).load(data.imgUrl).into(iv);
    }

    @Override
    public void onClick(BaseViewHolder helper, ImageMessage data, int position) {
        //單擊事件
        Toast.makeText(mContext, "Click: " + data.imgUrl, Toast.LENGTH_SHORT).show();
    }

    @Override
    public boolean onLongClick(BaseViewHolder helper, ImageMessage data, int position) {
        //長(zhǎng)按事件
        Toast.makeText(mContext, "longClick: " + data.imgUrl, Toast.LENGTH_SHORT).show();
        return true;
    }
}

ItemProvider的convert()方法中用于處理相應(yīng)的業(yè)務(wù)邏輯，onClick()中用于處理?xiàng)l目的單擊事件，onLongClick()中用于處于條目的長(zhǎng)按事件；盡管單擊和長(zhǎng)按事件adapter中可以通過(guò)ssetOnItemClick(）和setOnItemLongClick()來(lái)處理，但是這里還是有將這兩個(gè)事件交于itemProvider,開(kāi)發(fā)者可以根據(jù)具體需要選擇使用其中一種方式。

二、創(chuàng)建對(duì)應(yīng)的adapter，繼承MultiItemRvAdapter，如MessageListAdapter:

/**
 * @author ChayChan
 * @description: 消息列表的adapter
 * @date 2018/3/21  14:40
 */

public class MessageListAdapter extends MultipleItemRvAdapter<Message> {

    public static final int TYPE_TEXT = 0;
    public static final int TYPE_IMG = 1;

    public MessageListAdapter(@Nullable List<Message> data) {
        super(data);

        //構(gòu)造函數(shù)若有傳參可以在調(diào)用finishInitialize()之前進(jìn)行賦值，賦值給全局變量
        //這樣getViewType()和registerItemProvider()方法中可以獲取到傳過(guò)來(lái)的值
        //getViewType()中可能因?yàn)槟承I(yè)務(wù)邏輯，需要將某個(gè)值傳遞過(guò)來(lái)進(jìn)行判斷，返回對(duì)應(yīng)的viewType
        //registerItemProvider()中可以將值傳遞給ItemProvider
        
        finishInitialize();//調(diào)用該方法告知MultipleItemRvAdapter1?已初始化完構(gòu)造函數(shù)參數(shù)的傳遞
    }

    @Override
    protected int getViewType(Message message) {
        //返回對(duì)應(yīng)的viewType
        if (message instanceof TextMessage) {
            return TYPE_TEXT;
        } else if (message instanceof ImageMessage) {
            return TYPE_IMG;
        }
        return 0;
    }


    @Override
    public void registerItemProvider() {
        //注冊(cè)相關(guān)的條目provider
        mProviderDelegate.registerProvider(new TextMessageItemProvider()); //注冊(cè)文本消息條目的itemProvider
        mProviderDelegate.registerProvider(new ImageMessageItemProvider());//注冊(cè)圖片消息條目的itemProvider
    }

}

??adapter中需要實(shí)現(xiàn)getViewType()和registerItemProvider()兩個(gè)方法。getViewType()通過(guò)判斷相關(guān)邏輯返回不同的viewType,registerItemProvider()用于注冊(cè)自己所定義的所有子條目的ItemProvider。

三、為RecyclerView設(shè)置相應(yīng)的adapter:

    mRvMessages = findViewById(R.id.rv_message);

    mRvMessages.setHasFixedSize(true);
    mRvMessages.setLayoutManager(new LinearLayoutManager(this));

    String imgUrl1 = "https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1521627479112&di=7b109af49f8c1c193c3173306cf58680&imgtype=0&src=http%3A%2F%2Fimg.xgo-img.com.cn%2Fpics%2F1538%2F1537620.jpg";
    String imgUrl2 = "https://timgsa.baidu.com/timg?image&quality=80&size=b10000_10000&sec=1521617426&di=d6537bb0ef71984e4a1d14e4b18ba169&src=http://img1d.xgo-img.com.cn/pics/789/788784.jpg";

    mMessages.add(new TextMessage("你好呀，哈哈哈哈，嗚啦啦啦啦"));
    mMessages.add(new ImageMessage(imgUrl1));
    mMessages.add(new TextMessage("嗯嗯，今天天氣真不錯(cuò)！"));
    mMessages.add(new ImageMessage(imgUrl2));

    mRvMessages.setAdapter(new MessageListAdapter(mMessages));

效果圖：

image

??由于該庫(kù)中包含BaseRecyclerViewAdapterHelper庫(kù)，所以BaseRecyclerViewAdapterHelper擁有的它也具有。

導(dǎo)入方式

在項(xiàng)目根目錄下的build.gradle中的allprojects{}中，添加jitpack倉(cāng)庫(kù)地址，如下：

allprojects {
    repositories {
        jcenter()
        maven { url 'https://jitpack.io' }//添加jitpack倉(cāng)庫(kù)地址
    }
}

打開(kāi)app的module中的build.gradle，在dependencies{}中，添加依賴(lài)，如下：

dependencies {
        compile 'com.github.chaychan:MultipleItemRvAdapter:1.0.2' //建議使用最新版本
}

最新發(fā)布的版本可以查看

https://github.com/chaychan/MultipleItemRvAdapter/releases

支持和鼓勵(lì)

??如果覺(jué)得對(duì)你有幫助，請(qǐng)幫忙star一下，讓更多人可以看到，謝謝！這樣我會(huì)更加有動(dòng)力去完善好這個(gè)項(xiàng)目；

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書(shū)系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容