本篇文章已授權(quán)微信公眾號 guolin_blog (郭霖)獨家發(fā)布
轉(zhuǎn)載請標明出處:
http://www.itdecent.cn/p/fe883d36a8ec
本文出自:【張旭童的簡書】 (http://www.itdecent.cn/users/8e91ff99b072/latest_articles)
代碼傳送門:喜歡的話,隨手點個star。多謝
https://github.com/mcxtzhang/all-base-adapter
概述
在前文快速開發(fā)偷懶必備(一)中,我們利用Adapter模式封裝了一個庫,能快速為任意ViewGroup添加子View。
有如下特點:
- 快速簡單使用
- 支持任意ViewGroup
- 無耦合
- 無侵入性
- Item支持多種類型
在庫中V1.1.0版本,我也順手加入了RecyclerView、ListView、GridView的通用Adapter功能,庫地址在這里。
現(xiàn)在V1.2.0版本發(fā)布,我又加入了我最近超愛的一個技術(shù),DataBinding。
封裝了一套一行代碼實現(xiàn)花式列表的Adapter。
即利用DataBinding實現(xiàn)RecyclerView中快速使用的Adapter。
以后不管寫多種type還是單type的列表,利用DataBinding 和本庫,都只需要一行代碼!
這里也算是安利DataBinding吧,真的超好用。還沒使用的朋友們,在看到本文可以如此簡單寫花式列表后,建議去學習一下。
先看用法吧,簡單粗暴到?jīng)]朋友。
用法
使用必讀:
BaseBindingAdapter利用DataBinding提供的動態(tài)綁定技術(shù),使用BR.data封裝數(shù)據(jù)、BR.itemP封裝點擊事件。所以對layout有以下要求:
- layout中 數(shù)據(jù)name起名data
- layout中 點擊事件Presenter起名 itemP
如:
<layout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools">
<data>
<variable
name="itemP"
type="mcxtzhang.commonviewgroupadapter.databinding.rv.single.DBSingleActivity.SingleItemPresenter"/>
<variable
name="data"
type="mcxtzhang.commonviewgroupadapter.databinding.rv.single.DBSingleBean"/>
</data>
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_margin="1dp"
android:background="@color/colorAccent"
android:onClick="@{v->itemP.onItemClick(data)}"
android:orientation="horizontal">
<ImageView
android:id="@+id/ivAvatar"
android:layout_width="200dp"
android:layout_height="200dp"
app:netUrl="@{data.avatar}"
tools:src="@mipmap/ic_launcher"/>
<TextView
android:id="@+id/tvName"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@{data.name}"
tools:text="測試多種"/>
</LinearLayout>
</layout>
1 單Item列表
效果如圖:
順帶演示了BaseBindingAdapter封裝的一些增刪功能。

用法:
和其他BaseAdapter用法一致:
- 構(gòu)造函數(shù)只需要傳入context,datas,layout
mAdapter = new BaseBindingAdapter(this, mDatas, R.layout.item_db_single);
好了,列表已經(jīng)出來了。我不騙你,就這一句話。
如果需要設(shè)置點擊事件(點擊事件設(shè)置所有類型都一樣,下不贅述):
//★ 設(shè)置Item點擊事件
mAdapter.setItemPresenter(new SingleItemPresenter());
/**
* ★ Item點擊事件P
*/
public class SingleItemPresenter {
public void onItemClick(DBSingleBean data) {
data.setName("修改之后立刻見效");
}
}
特殊需求:
如果有特殊需求,可傳入兩個泛型,重寫onBindViewHolder搞事情:
// ★泛型D:是Bean類型,如果有就傳。 泛型B:是對應的xml Layout的Binding類
mAdapter = new BaseBindingAdapter<DBSingleBean, ItemDbSingleBinding>(this, mDatas, R.layout.item_db_single) {
@Override
public void onBindViewHolder(BaseBindingVH<ItemDbSingleBinding> holder, int position) {
//★super一定不要刪除
super.onBindViewHolder(holder, position);
//如果有特殊需求,可傳入兩個泛型,重寫onBindViewHolder搞事情。
ItemDbSingleBinding binding = holder.getBinding();
DBSingleBean data = mDatas.get(position);
}
};
2 多Item同種數(shù)據(jù)類型列表
一般是像IM那種列表,雖然Item不同,但是數(shù)據(jù)結(jié)構(gòu)是同一個。用法,一句話~
效果如圖:

用法:
- 數(shù)據(jù)結(jié)構(gòu)(JavaBean)需實現(xiàn)
IBaseMulInterface接口,根據(jù)情況返回不同的layout。 - 構(gòu)造函數(shù)只需要傳入context,datas.
mAdapter = new BaseMulTypeBindingAdapter(this, mDatas);
復雜列表依然一句話。
public class MulTypeSingleBean extends BaseObservable implements IBaseMulInterface {
private String avatar;
private String name;
private boolean receive;
@Override
public int getItemLayoutId() {
if (isReceive()) {
return R.layout.item_db_mul_1;
} else {
return R.layout.item_db_mul_2;
}
}
}
特殊需求:
如果有特殊需求,可傳入數(shù)據(jù)結(jié)構(gòu)的泛型,避免強轉(zhuǎn),重寫onBindViewHolder()方法,但是Binding類 不可避免的需要強轉(zhuǎn)了:
mAdapter = new BaseMulTypeBindingAdapter<MulTypeSingleBean>(this, mDatas) {
@Override
public void onBindViewHolder(BaseBindingVH<ViewDataBinding> holder, int position) {
super.onBindViewHolder(holder, position);
//如果有特殊需求,可傳入數(shù)據(jù)結(jié)構(gòu)的泛型,避免強轉(zhuǎn)
MulTypeSingleBean data = mDatas.get(position);
//Binding類 不可避免的需要強轉(zhuǎn)了
ViewDataBinding binding = holder.getBinding();
switch (data.getItemLayoutId()) {
case R.layout.item_db_mul_1:
ItemDbMul1Binding itemDbMul1Binding = (ItemDbMul1Binding) binding;
break;
case R.layout.item_db_mul_2:
ItemDbMul2Binding itemDbMul2Binding = (ItemDbMul2Binding) binding;
break;
}
}
};
3 多Item、多種數(shù)據(jù)類型列表
各大APP首頁,Banner、列表、推薦混排,數(shù)據(jù)結(jié)構(gòu)肯定不同,但是依然只要一句代碼搞定Adapter!
效果如圖:

用法:
- 數(shù)據(jù)結(jié)構(gòu)(JavaBean)需分別實現(xiàn)
IBaseMulInterface接口,返回數(shù)據(jù)結(jié)構(gòu)對應的layout。 - 構(gòu)造函數(shù)只需要傳入context,datas.
mAdapter = new BaseMulTypeBindingAdapter(this, mDatas);
public class MulTypeMulBean1 extends BaseObservable implements IBaseMulInterface {
private String avatar;
private String name;
@Override
public int getItemLayoutId() {
return R.layout.item_db_mulbean_1;
}
}
public class MulTypeMulBean2 extends BaseObservable implements IBaseMulInterface {
private String background;
@Override
public int getItemLayoutId() {
return R.layout.item_db_mulbean_2;
}
}
特殊需求:
如果有特殊需求,重寫onBindViewHolder()方法,但是數(shù)據(jù)結(jié)構(gòu) 和 Binding類 都不可避免的需要強轉(zhuǎn)了:
mAdapter = new BaseMulTypeBindingAdapter(this, mDatas) {
@Override
public void onBindViewHolder(BaseBindingVH holder, int position) {
super.onBindViewHolder(holder, position);
//如果有特殊需求 重寫onBindViewHolder方法
// 數(shù)據(jù)結(jié)構(gòu) 和 Binding類 都不可避免的需要強轉(zhuǎn)了
ViewDataBinding binding = holder.getBinding();
switch (getItemViewType(position)) {
case R.layout.item_db_mul_1:
ItemDbMul1Binding itemDbMul1Binding = (ItemDbMul1Binding) binding;
MulTypeMulBean1 data1 = (MulTypeMulBean1) mDatas.get(position);
break;
case R.layout.item_db_mul_2:
ItemDbMul2Binding itemDbMul2Binding = (ItemDbMul2Binding) binding;
MulTypeMulBean2 data2 = (MulTypeMulBean2) mDatas.get(position);
break;
}
}
};
4 不能忘了上文的ViewGroup呀
對上文封裝的ViewGroup類型Adapter也提供DataBinding的支持。
效果如圖:
當然還是流式布局搭配史上集成最叼側(cè)滑菜單控件。
用法:
和上文快速開發(fā)偷懶必備(一)一樣,只是Adapter換成SingleBindingAdapter
mAdapter = new SingleBindingAdapter<>(this, mDatas = iniDatas(), R.layout.item_db_flow_swipe);
如果需要設(shè)置點擊事件:
mAdapter.setItemPresenter(new ItemDelPresenter());
設(shè)計思路與實現(xiàn)
使用起來如此爽快,其實寫起來也很簡單。
注意類BaseBindingAdapter和BaseMulTypeBindingAdapter都不是abstract的,這說明我們不需要重寫任何方法。
利用DataBinding,我們在BasexxxAdapter內(nèi)部和xml分別做View的創(chuàng)建和數(shù)據(jù)綁定的工作。
UML類圖

先簡要概括
-
BaseBindingVH繼承自RecyclerView.ViewHolder,持有T extends ViewDataBinding類型的mBinding變量。利用ViewDataBinding我們將不用再寫任何ViewHolder。 -
BaseBindingAdapter,繼承自RecyclerView.Adapter,依賴BaseBindingVH,onCreateViewHolder(ViewGroup parent, int viewType)方法返回BaseBindingVH作為ViewHolder。
內(nèi)部持有三個重要變量:數(shù)據(jù)對應layout,數(shù)據(jù)集,Item點擊事件處理類。數(shù)據(jù)對應layout會在onCreateViewHolder(ViewGroup parent, int viewType)用到。剩下兩個變量在onBindViewHolder()用到。對外暴漏setItemPresenter(Object itemPresenter)供設(shè)置點擊事件處理類。 -
IBaseMulInterface接口和快速開發(fā)偷懶必備(一)提到的一樣,返回某個數(shù)據(jù)結(jié)構(gòu)對應的layout,除此之外,本文還有一個十分tricky之處,利用返回的R.layout.itemxxxx作為ItemViewType,在BaseMulTypeBindingAdapter會用到。 -
BaseMulTypeBindingAdapter繼承自BaseBindingAdapter,但是它不再關(guān)心mLayoutId變量,它利用IBaseMulInterface接口返回的R.layout.itemxxxx作為ItemViewType,這樣在onCreateViewHolder(ViewGroup parent, int viewType)的時候,就可以直接用viewType構(gòu)造出ItemView。不再依賴mLayoutId變量。這是一個我很得意的設(shè)計,我在優(yōu)雅為RecyclerView增加HeaderView一文中,也曾用過這個方法。
BaseBindingVH
BaseBindingVH算是一個核心類,但是又十分簡單。它繼承自RecyclerView.ViewHolder,持有由泛型傳入的T extends ViewDataBinding類型的mBinding變量。
唯一構(gòu)造函數(shù),需要一個T t變量,然后調(diào)用super()傳入t.getRoot()完成itemView的賦值。同時對mBinding變量賦值。
對外暴漏getBinding()返回mBinding變量。
利用ViewDataBinding我們將不用再寫任何ViewHolder。
public class BaseBindingVH<T extends ViewDataBinding> extends RecyclerView.ViewHolder {
protected final T mBinding;
public BaseBindingVH(T t) {
super(t.getRoot());
mBinding = t;
}
public T getBinding() {
return mBinding;
}
}
BaseBindingAdapter
BaseBindingAdapter,繼承自RecyclerView.Adapter,依賴BaseBindingVH,將BaseBindingVH作為泛型傳給RecyclerView.Adapter。
同時BaseBindingAdapter本身接受兩個泛型,<D, B extends ViewDataBinding>。
- 泛型沒有特殊需求可以不傳
- 泛型D:是Bean類型,如果有就傳。
- 泛型B:是對應的xml Layout的Binding類
傳入不傳入泛型的區(qū)別已經(jīng)在第二節(jié)具體用法里進行了演示,不再贅述。
內(nèi)部持有三個重要變量:
- 數(shù)據(jù)對應layout
int mLayoutId; - 數(shù)據(jù)集
List<D> mDatas; - Item點擊事件處理類。
Object ItemPresenter;
mLayoutId和mDatas都由構(gòu)造函數(shù)傳入,沒啥好說的。
對外暴漏setItemPresenter(Object itemPresenter)供設(shè)置點擊事件處理類ItemPresenter。
ItemPresenter是Object類型,這樣才不care你set的Item點擊事件處理類是什么鬼。
onCreateViewHolder(ViewGroup parent, int viewType)方法返回BaseBindingVH作為ViewHolder。
mLayoutId會在onCreateViewHolder(ViewGroup parent, int viewType)用到,再根據(jù)泛型B強轉(zhuǎn)成對應的ViewDataBinding:
BaseBindingVH<B> holder = new BaseBindingVH<B>((B) DataBindingUtil.inflate(mInfalter, mLayoutId, parent, false));
會在onBindViewHolder()方法里,利用DataBinding動態(tài)綁定ViewDataBinding.setVariable(BR.itemP, ItemPresenter);為每個Item設(shè)置點擊事件。
同時,數(shù)據(jù)也是同樣在里面綁定的:setVariable(BR.data, mDatas.get(position))。
重點代碼如下:
public class BaseBindingAdapter<D, B extends ViewDataBinding> extends RecyclerView.Adapter<BaseBindingVH<B>> {
protected Context mContext;
protected int mLayoutId;
protected List<D> mDatas;
protected LayoutInflater mInfalter;
//用于設(shè)置Item的事件Presenter
protected Object ItemPresenter;
public BaseBindingAdapter(Context mContext, List mDatas, int mLayoutId) {
this.mContext = mContext;
this.mLayoutId = mLayoutId;
this.mDatas = mDatas;
this.mInfalter = LayoutInflater.from(mContext);
}
@Override
public BaseBindingVH<B> onCreateViewHolder(ViewGroup parent, int viewType) {
BaseBindingVH<B> holder = new BaseBindingVH<B>((B) DataBindingUtil.inflate(mInfalter, mLayoutId, parent, false));
onCreateViewHolder(holder);
return holder;
}
/**
* 如果需要給Vh設(shè)置監(jiān)聽器啥的 可以在這里
*
* @param holder
*/
public void onCreateViewHolder(BaseBindingVH<B> holder) {
}
/**
* 子類除了綁定數(shù)據(jù),還要設(shè)置監(jiān)聽器等其他操作。
* 可以重寫這個方法,不要刪掉super.onBindViewHolder(holder, position);
*
* @param holder
* @param position
*/
@Override
public void onBindViewHolder(BaseBindingVH<B> holder, int position) {
holder.getBinding().setVariable(BR.data, mDatas.get(position));
holder.getBinding().setVariable(BR.itemP, ItemPresenter);
holder.getBinding().executePendingBindings();
}
/**
* 用于設(shè)置Item的事件Presenter
*
* @param itemPresenter
* @return
*/
public BaseBindingAdapter setItemPresenter(Object itemPresenter) {
ItemPresenter = itemPresenter;
return this;
}
}
BaseBindingAdapter內(nèi)部也封裝了如下方法,方便數(shù)據(jù)刷新,增刪(定向刷新)調(diào)用:
/**
* 刷新數(shù)據(jù),初始化數(shù)據(jù)
*
* @param list
*/
public void setDatas(List<D> list) {
if (this.mDatas != null) {
if (null != list) {
List<D> temp = new ArrayList<D>();
temp.addAll(list);
this.mDatas.clear();
this.mDatas.addAll(temp);
} else {
this.mDatas.clear();
}
} else {
this.mDatas = list;
}
notifyDataSetChanged();
}
/**
* 刪除一條數(shù)據(jù)
* 會自動定向刷新
*
* @param i
*/
public void remove(int i) {
if (null != mDatas && mDatas.size() > i && i > -1) {
mDatas.remove(i);
notifyItemRemoved(i);
}
}
/**
* 添加一條數(shù)據(jù) 至隊尾
* 會自動定向刷新
*
* @param data
*/
public void add(D data) {
if (data != null && mDatas != null) {
mDatas.add(data);
notifyItemInserted(mDatas.size());
}
}
/**
* 在指定位置添加一條數(shù)據(jù)
* 會自動定向刷新
* <p>
* 如果指定位置越界,則添加在隊尾
*
* @param position
* @param data
*/
public void add(int position, D data) {
if (data != null && mDatas != null) {
if (mDatas.size() > position && position > -1) {
mDatas.add(position, data);
notifyItemInserted(position);
} else {
add(data);
}
}
}
/**
* 加載更多數(shù)據(jù)
*
* @param list
*/
public void addDatas(List<D> list) {
if (null != list) {
List<D> temp = new ArrayList<D>();
temp.addAll(list);
if (this.mDatas != null) {
this.mDatas.addAll(temp);
} else {
this.mDatas = temp;
}
notifyDataSetChanged();
}
}
IBaseMulInterface接口
來點簡單的.
IBaseMulInterface接口和快速開發(fā)偷懶必備(一)提到的一樣,返回某個數(shù)據(jù)結(jié)構(gòu)對應的layout.
除此之外,本文還有一個十分tricky之處,利用返回的R.layout.itemxxxx作為ItemViewType,在BaseMulTypeBindingAdapter會用到。
因為不同的R.layout.itemxxxx對于RecyclerView來說一定是不同的Item,
BaseMulTypeBindingAdapter
多種ItemType的Base類
BaseMulTypeBindingAdapter繼承自BaseBindingAdapter,但是它不再關(guān)心mLayoutId變量。因此它傳給父類的泛型B就是ViewDataBinding類本身。解釋如下:
基類的泛型B:不用傳,因為多種ItemType 肯定Layout長得不一樣,那么Binding類也不一樣,傳入沒有任何意義
泛型T:多Item多Bean情況可以不傳。如果只有一種Bean類型,可以傳入Bean,實現(xiàn)IBaseMulInterface接口。
或者傳入IBaseMulInterface接口,可以拿到 getItemLayoutId(),
但是通過getItemViewType(int position),一樣。所以多Item多Bean建議不傳。
傳入不傳入泛型的區(qū)別已經(jīng)在第二節(jié)具體用法里進行了演示,不再贅述。
getItemViewType()直接返回 IBaseMulInterface接口的返回值。
在onCreateViewHolder(ViewGroup parent, int viewType)的時候,直接用viewType構(gòu)建ViewDataBinding(ItemView)。不再依賴mLayoutId變量。
這是一個我很得意的設(shè)計,我在優(yōu)雅為RecyclerView增加HeaderView一文中,也曾用過這個方法添加頭部。
完整代碼如下:
public class BaseMulTypeBindingAdapter<T extends IBaseMulInterface> extends BaseBindingAdapter<T, ViewDataBinding> {
public BaseMulTypeBindingAdapter(Context mContext, List<T> mDatas) {
super(mContext, mDatas);
}
@Override
public int getItemViewType(int position) {
return mDatas.get(position).getItemLayoutId();
}
@Override
public BaseBindingVH<ViewDataBinding> onCreateViewHolder(ViewGroup parent, int viewType) {
BaseBindingVH<ViewDataBinding> holder = new BaseBindingVH<ViewDataBinding>(DataBindingUtil.inflate(mInfalter, viewType, parent, false));
onCreateViewHolder(holder);
return holder;
}
}
ViewGroup Adapter的實現(xiàn)
單item
繼承SingleAdapter,增加ItemPresenter,在getView()完成View創(chuàng)建和綁定。
public class SingleBindingAdapter<D, B extends ViewDataBinding> extends SingleAdapter<D> {
//用于設(shè)置Item的事件Presenter
protected Object ItemPresenter;
/**
* 用于設(shè)置Item的事件Presenter
*
* @param itemPresenter
* @return
*/
public SingleBindingAdapter setItemPresenter(Object itemPresenter) {
ItemPresenter = itemPresenter;
return this;
}
public SingleBindingAdapter(Context context, List<D> datas, int itemLayoutId) {
super(context, datas, itemLayoutId);
}
//重寫利用DataBinding做
@Override
public View getView(ViewGroup parent, int pos, D data) {
ViewDataBinding binding = DataBindingUtil.inflate(mInflater, mItemLayoutId, parent, false);
View itemView = binding.getRoot();
onBindView(parent, itemView, data, pos);
binding.setVariable(BR.data, data);
binding.setVariable(BR.itemP, ItemPresenter);
return itemView;
}
//空實現(xiàn)即可,因為DataBinding的實現(xiàn)都是在xml里做
@Override
public void onBindView(ViewGroup parent, View itemView, D data, int pos) {
}
}
多Item:
更簡單了,繼承SingleBindingAdapter。重寫getView()即可。
public class MulTypeBindngAdapter<T extends IMulTypeHelper> extends SingleBindingAdapter<T, ViewDataBinding> {
public MulTypeBindngAdapter(Context context, List<T> datas) {
super(context, datas, -1);
}
//重寫利用DataBinding做
@Override
public View getView(ViewGroup parent, int pos, T data) {
ViewDataBinding binding = DataBindingUtil.inflate(mInflater, data.getItemLayoutId(), parent, false);
View itemView = binding.getRoot();
onBindView(parent, itemView, data, pos);
binding.setVariable(BR.data, data);
binding.setVariable(BR.itemP, ItemPresenter);
return itemView;
}
}
總結(jié)
代碼傳送門:喜歡的話,隨手點個star。多謝
https://github.com/mcxtzhang/all-base-adapter
本文利用DataBinding的ViewDataBinding直接略去寫ViewHolder。
利用Object類型的ItemPresenter,兼容解決了點擊事件的設(shè)置。
最得意的設(shè)計,還是利用R.layout.xxxx這些布局文件int類型的的RID,作為ItemViewType,一箭雙雕。
DataBinding很強,希望大家快點擁抱它。
to do list
- ViewGroup Adapter 考慮加入復用緩存池
- ViewGroup Adapter ,考慮替換
onBindView()的ItemView->通用的ViewHolder,這樣可以少寫一些findViewById()代碼 整合DataBinding 的通用Adapter入庫。- 完善 RecyclerView、ListView的通用Adapter,支持多種ItemViewType。
- 加入一些自定義ViewGroup入庫,例如流式布局,九宮格,Banner輪播圖。
轉(zhuǎn)載請標明出處:
http://www.itdecent.cn/p/fe883d36a8ec
本文出自:【張旭童的簡書】 (http://www.itdecent.cn/users/8e91ff99b072/latest_articles)
代碼傳送門:喜歡的話,隨手點個star。多謝
https://github.com/mcxtzhang/all-base-adapter