基于BaseRecyclerViewAdapterHelper封裝的多條目Adapter桨踪,方便快捷掠归,便于維護(hù)

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

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

??效果圖臀脏,我之前做過的精仿今日頭條,新聞列表中有好幾種布局:

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的編寫余境,包含一種或多種子條目的處理且擁有許多強(qiáng)大的功能,比如上拉加載更多灌诅、支持添加動(dòng)畫葛超、可以添加子條目的點(diǎn)擊、長(zhǎng)按事件延塑、添加頭部和底部等绣张,現(xiàn)擁有12.6K多的star數(shù),受到不少Android開發(fā)者的青睞关带,我在項(xiàng)目的開發(fā)中也使用BaseRecyclerViewAdapterHelper侥涵,是一名忠實(shí)的粉絲。

BaseRecyclerViewAdapterHelper 多條目布局的不足之處

??BaseRecyclerViewAdapterHelper中對(duì)多條目布局的邏輯都放在convert()方法中宋雏,通過判斷對(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種径荔,覺得不是特別合理,如下是消息列表的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(){
                //     //還有其他消息類型脆霎,比如語(yǔ)音总处、位置、紅包绪穆、轉(zhuǎn)賬等
                // }

                return 0;
            }
        });

        getMultiTypeDelegate()
                .registerItemType(TYPE_TEXT, R.layout.item_text_message)
                .registerItemType(TYPE_IMG, R.layout.item_image_message);
                //還有其他消息類型辨泳,比如語(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寫相應(yīng)的邏輯摹闽,方便維護(hù)。

如何使用MultipleItemRvAdapter

一褐健、創(chuàng)建對(duì)應(yīng)條目的ItemProvider付鹿,繼承BaseItemProvider,注解ItemProviderTag中填寫對(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中可以通過ssetOnItemClick()和setOnItemLongClick()來(lái)處理,但是這里還是有將這兩個(gè)事件交于itemProvider,開發(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()方法中可以獲取到傳過來(lái)的值
        //getViewType()中可能因?yàn)槟承I(yè)務(wù)邏輯,需要將某個(gè)值傳遞過來(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ā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ù)地址
    }
}

打開app的module中的build.gradle,在dependencies{}中唾戚,添加依賴柳洋,如下:

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

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

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

支持和鼓勵(lì)

??如果覺得對(duì)你有幫助,請(qǐng)幫忙star一下叹坦,讓更多人可以看到熊镣,謝謝!這樣我會(huì)更加有動(dòng)力去完善好這個(gè)項(xiàng)目募书;

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末绪囱,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子莹捡,更是在濱河造成了極大的恐慌鬼吵,老刑警劉巖,帶你破解...
    沈念sama閱讀 217,907評(píng)論 6 506
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件篮赢,死亡現(xiàn)場(chǎng)離奇詭異齿椅,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)荷逞,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,987評(píng)論 3 395
  • 文/潘曉璐 我一進(jìn)店門媒咳,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái),“玉大人种远,你說(shuō)我怎么就攤上這事涩澡。” “怎么了坠敷?”我有些...
    開封第一講書人閱讀 164,298評(píng)論 0 354
  • 文/不壞的土叔 我叫張陵妙同,是天一觀的道長(zhǎng)。 經(jīng)常有香客問我膝迎,道長(zhǎng)粥帚,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,586評(píng)論 1 293
  • 正文 為了忘掉前任限次,我火速辦了婚禮芒涡,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘卖漫。我一直安慰自己费尽,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,633評(píng)論 6 392
  • 文/花漫 我一把揭開白布羊始。 她就那樣靜靜地躺著旱幼,像睡著了一般。 火紅的嫁衣襯著肌膚如雪突委。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,488評(píng)論 1 302
  • 那天,我揣著相機(jī)與錄音痪寻,去河邊找鬼。 笑死勾笆,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的忙灼。 我是一名探鬼主播匠襟,決...
    沈念sama閱讀 40,275評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼钝侠,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼该园!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起帅韧,我...
    開封第一講書人閱讀 39,176評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤里初,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后忽舟,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體双妨,經(jīng)...
    沈念sama閱讀 45,619評(píng)論 1 314
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,819評(píng)論 3 336
  • 正文 我和宋清朗相戀三年叮阅,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了刁品。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 39,932評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡浩姥,死狀恐怖挑随,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情勒叠,我是刑警寧澤兜挨,帶...
    沈念sama閱讀 35,655評(píng)論 5 346
  • 正文 年R本政府宣布,位于F島的核電站眯分,受9級(jí)特大地震影響拌汇,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜弊决,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,265評(píng)論 3 329
  • 文/蒙蒙 一噪舀、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧飘诗,春花似錦与倡、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,871評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至貌嫡,卻和暖如春比驻,著一層夾襖步出監(jiān)牢的瞬間该溯,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 32,994評(píng)論 1 269
  • 我被黑心中介騙來(lái)泰國(guó)打工别惦, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留狈茉,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 48,095評(píng)論 3 370
  • 正文 我出身青樓掸掸,卻偏偏與公主長(zhǎng)得像氯庆,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子扰付,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,884評(píng)論 2 354

推薦閱讀更多精彩內(nèi)容

  • 用兩張圖告訴你堤撵,為什么你的 App 會(huì)卡頓? - Android - 掘金 Cover 有什么料? 從這篇文章中你...
    hw1212閱讀 12,723評(píng)論 2 59
  • 目錄介紹 1.RecycleView的結(jié)構(gòu) 2.Adapter2.1 RecyclerView.Adapter扮演...
    楊充211閱讀 3,092評(píng)論 3 17
  • 前言 主要聲明三點(diǎn) 第一:關(guān)于本文的BaseRecyclerViewAdapterHelper用法羽莺,自然是轉(zhuǎn)載的官...
    _猜火車_閱讀 156,242評(píng)論 81 166
  • 可能是因?yàn)槲易约翰粫?huì)畫畫的緣故盐固,我對(duì)會(huì)繪畫的人充滿羨慕荒给。不管是鉛筆畫的細(xì)膩逼真,水彩畫的濃墨重彩刁卜,國(guó)畫的清麗脫俗....
    明媚月光閱讀 186評(píng)論 10 9
  • 為了 這彼此都走不出的牢籠 為車輛割碎的黑夜 和熒光拼湊的快樂 讓雙眼寧?kù)o 讓我們從虛幻中來(lái) 再到虛幻里去 去 重...
    太治閱讀 326評(píng)論 0 0