基于BaseRecyclerViewAdapterHelper封裝的多條目Adapter,方便快捷,便于維護

??項目地址: https://github.com/chaychan/MultipleItemRvAdapter

??已提交并整合到BaseRecyclerViewAdapterHelper,下面介紹如何使用改進后的多條目adapter。

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

home.jpg

Apk下載地址

[點擊下載體驗]

??MultipleItemRvAdapter是在BaseRecyclerViewAdapterHelper的基礎上對BaseQuickAdapter進行封裝,在包含BaseRecyclerViewAdapterHelper所有功能的基礎上,對其中的多條目布局處理邏輯進行了封裝,將adapter中每種子條目單獨出對應的ItemProvider,這樣方便相應條目做相關的業務邏輯。

項目介紹

BaseRecyclerViewAdapterHelper

image

??BaseRecyclerViewAdapterHelper是一個封裝好的萬能RecyclerView的適配器,可以方便快捷地完成adapter的編寫,包含一種或多種子條目的處理且擁有許多強大的功能,比如上拉加載更多、支持添加動畫、可以添加子條目的點擊、長按事件、添加頭部和底部等,現擁有12.6K多的star數,受到不少Android開發者的青睞,我在項目的開發中也使用BaseRecyclerViewAdapterHelper,是一名忠實的粉絲。

BaseRecyclerViewAdapterHelper 多條目布局的不足之處

??BaseRecyclerViewAdapterHelper中對多條目布局的邏輯都放在convert()方法中,通過判斷對應的itemViewTyper來進行相應子條目的處理,當條目特別多以及擁有復雜業務邏輯的情況,convert()中的處理將會特別多,不便于往后項目的維護,比如IM里面的消息列表,有文本、圖片、語音、位置、紅包、轉賬等,有很多種不同布局,對應的邏輯也比較多,在只使用BaseRecyclerViewAdapterHelper的情況下,對應消息列表的adapter代碼就已經破一千行,全部條目的邏輯都在一個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(){
                //     //還有其他消息類型,比如語音、位置、紅包、轉賬等
                // }

                return 0;
            }
        });

        getMultiTypeDelegate()
                .registerItemType(TYPE_TEXT, R.layout.item_text_message)
                .registerItemType(TYPE_IMG, R.layout.item_image_message);
                //還有其他消息類型,比如語音、位置、紅包、轉賬等
    }

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

                break;
            case TYPE_IMG:
                //圖片消息的業務邏輯

                break;
             // case 語音、位置、紅包、轉賬等
            // break;
        }
    }
}

??當子條目有許多種的時候,convert()中的邏輯將會很多,不便于項目的維護,故而封裝了MultipleItemRvAdapter,將每個條目的邏輯處理都交給創建的ItemProvider來處理,這樣可以在對應條目的ItemProvider寫相應的邏輯,方便維護。

如何使用MultipleItemRvAdapter

一、創建對應條目的ItemProvider,繼承BaseItemProvider,注解ItemProviderTag中填寫對應的viewType的值(建議在對應的adapter中定義常量,每種條目的viewType必須唯一), layout指定對應條目的布局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) {
        //處理相關業務邏輯
        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) {
        //長按事件
        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) {
        //處理相關業務邏輯
        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) {
        //長按事件
        Toast.makeText(mContext, "longClick: " + data.imgUrl, Toast.LENGTH_SHORT).show();
        return true;
    }
}

ItemProvider的convert()方法中用于處理相應的業務邏輯,onClick()中用于處理條目的單擊事件,onLongClick()中用于處于條目的長按事件;盡管單擊和長按事件adapter中可以通過ssetOnItemClick()和setOnItemLongClick()來處理,但是這里還是有將這兩個事件交于itemProvider,開發者可以根據具體需要選擇使用其中一種方式。

二、創建對應的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);

        //構造函數若有傳參可以在調用finishInitialize()之前進行賦值,賦值給全局變量
        //這樣getViewType()和registerItemProvider()方法中可以獲取到傳過來的值
        //getViewType()中可能因為某些業務邏輯,需要將某個值傳遞過來進行判斷,返回對應的viewType
        //registerItemProvider()中可以將值傳遞給ItemProvider
        
        finishInitialize();//調用該方法告知MultipleItemRvAdapter1?已初始化完構造函數參數的傳遞
    }

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


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

}

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

三、為RecyclerView設置相應的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("嗯嗯,今天天氣真不錯!"));
    mMessages.add(new ImageMessage(imgUrl2));

    mRvMessages.setAdapter(new MessageListAdapter(mMessages));

效果圖:

image

??由于該庫中包含BaseRecyclerViewAdapterHelper庫,所以BaseRecyclerViewAdapterHelper擁有的它也具有。

導入方式

在項目根目錄下的build.gradle中的allprojects{}中,添加jitpack倉庫地址,如下:

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

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

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

最新發布的版本可以查看

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

支持和鼓勵

??如果覺得對你有幫助,請幫忙star一下,讓更多人可以看到,謝謝!這樣我會更加有動力去完善好這個項目;

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,119評論 6 531
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,382評論 3 415
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,038評論 0 373
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,853評論 1 309
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,616評論 6 408
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,112評論 1 323
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,192評論 3 441
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,355評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,869評論 1 334
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,727評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,928評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,467評論 5 358
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,165評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,570評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,813評論 1 282
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,585評論 3 390
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,892評論 2 372

推薦閱讀更多精彩內容