??項(xiàng)目地址: https://github.com/chaychan/MultipleItemRvAdapter
??已提交并整合到BaseRecyclerViewAdapterHelper,下面介紹如何使用改進(jìn)后的多條目adapter卢鹦。
??效果圖臀脏,我之前做過的精仿今日頭條,新聞列表中有好幾種布局:
Apk下載地址
??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
??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));
效果圖:
??由于該庫(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)目募书;