Android 万能的Adapter for ListView,RecyclerView,GridView等，支持多种Item类型的情况。
compile 'com.zhy:base-rvadapter:3.0.3'
compile 'com.zhy:base-adapter:3.0.3'
##（1）简单的数据绑定(ListView与其使用方式一致)
首先看我们最常用的单种Item的书写方式：
mRecyclerView.setAdapter(new CommonAdapter<String>(this, R.layout.item_list, mDatas)
{
@Override
public void convert(ViewHolder holder, String s)
{
holder.setText(R.id.id_item_list_title, s);
}
});
是不是相当方便，在convert方法中完成数据、事件绑定即可。
只需要简单的将Adapter继承CommonAdapter，复写convert方法即可。省去了自己编写ViewHolder等大量的重复的代码。
- 可以通过holder.getView(id)拿到任何控件。
- ViewHolder中封装了大量的常用的方法，比如holder.setText(id,text)，holder.setOnClickListener(id,listener)等，可以支持使用。
效果图：
##（2）多种ItemViewType(ListView与其使用方式一致)
对于多中itemviewtype的处理参考：https://github.com/sockeqwe/AdapterDelegates ，具有极高的扩展性。
MultiItemTypeAdapter adapter = new MultiItemTypeAdapter(this,mDatas);
adapter.addItemViewDelegate(new MsgSendItemDelagate());
adapter.addItemViewDelegate(new MsgComingItemDelagate());
每种Item类型对应一个ItemViewDelegete，例如：
public class MsgComingItemDelagate implements ItemViewDelegate<ChatMessage>
{
@Override
public int getItemViewLayoutId()
{
return R.layout.main_chat_from_msg;
}
@Override
public boolean isForViewType(ChatMessage item, int position)
{
return item.isComMeg();
}
@Override
public void convert(ViewHolder holder, ChatMessage chatMessage, int position)
{
holder.setText(R.id.chat_from_content, chatMessage.getContent());
holder.setText(R.id.chat_from_name, chatMessage.getName());
holder.setImageResource(R.id.chat_from_icon, chatMessage.getIcon());
}
}
贴个效果图：
##(3) 添加HeaderView、FooterView
mHeaderAndFooterWrapper = new HeaderAndFooterWrapper(mAdapter);
TextView t1 = new TextView(this);
t1.setText("Header 1");
TextView t2 = new TextView(this);
t2.setText("Header 2");
mHeaderAndFooterWrapper.addHeaderView(t1);
mHeaderAndFooterWrapper.addHeaderView(t2);
mRecyclerView.setAdapter(mHeaderAndFooterWrapper);
mHeaderAndFooterWrapper.notifyDataSetChanged();
类似装饰者模式，直接将原本的adapter传入，初始化一个HeaderAndFooterWrapper对象，然后调用相关API添加。
##(4) 添加LoadMore
mLoadMoreWrapper = new LoadMoreWrapper(mOriginAdapter);
mLoadMoreWrapper.setLoadMoreView(R.layout.default_loading);
mLoadMoreWrapper.setOnLoadMoreListener(new LoadMoreWrapper.OnLoadMoreListener()
{
@Override
public void onLoadMoreRequested()
{
}
});
mRecyclerView.setAdapter(mLoadMoreWrapper);
直接将原本的adapter传入，初始化一个LoadMoreWrapper对象，然后调用相关API即可。
##(5)添加EmptyView
mEmptyWrapper = new EmptyWrapper(mAdapter);
mEmptyWrapper.setEmptyView(R.layout.empty_view);
mRecyclerView.setAdapter(mEmptyWrapper );
直接将原本的adapter传入，初始化一个EmptyWrapper对象，然后调用相关API即可。
支持链式添加多种功能，示例代码：
mAdapter = new EmptyViewWrapper(
new LoadMoreWrapper(
new HeaderAndFooterWrapper(mOriginAdapter)));
mListView.setAdapter(new CommonAdapter<String>(this, R.layout.item_list, mDatas)
{
@Override
public void convert(ViewHolder holder, String o, int pos)
{
holder.setText(R.id.id_item_list_title, o);
}
@Override
public void onViewHolderCreated(ViewHolder holder, View itemView)
{
super.onViewHolderCreated(holder, itemView);
//AutoUtil.autoSize(itemView)
}
});
-
https://github.com/JoanZapata/base-adapter-helper
应该是我所知道的最早的对listview,gridview封装的adapter了，参考了其中很多，比如在
ViewHolder.setXXX类的辅助方法。 -
https://github.com/sockeqwe/AdapterDelegates
参考该库多种ItemType绑定数据方式
-
https://github.com/ragunathjawahar/simple-section-adapter
SectionAdapter对其进行了参考。
核心原理是使用getItemViewType（），
原理： https://blog.csdn.net/wanghao200906/article/details/41693859
但是 baseAdapter 进行了封装，不需要自己写代码定义 viewType,
1.ItemViewDelegateManager:
public ItemViewDelegateManager<T> addDelegate(ItemViewDelegate<T> delegate) {
// sechal annotation: viewType从0开始
int viewType = delegates.size();
if (delegate != null) {
delegates.put(viewType, delegate);
viewType++;
}
return this;
}addDelegate（）-> delegates.put() 的时候记录了index
public int getItemViewType(T item, int position) {
int delegatesCount = delegates.size();
// sechal annotation: 根据索引从大向小。
for (int i = delegatesCount - 1; i >= 0; i--) {
ItemViewDelegate<T> delegate = delegates.valueAt(i);
// seachal annotation: 如果代理item 需要的ViewType和delegate的ViewType匹配，则返回此 viewType值（也就是SparseArrayCompat key）
if (delegate.isForViewType(item, position)) {
// seachal annotation: 如果return语句行不被执行，就会抛出数据与代理不匹配异常，
return delegates.keyAt(i);//
}
}
//
throw new IllegalArgumentException(
"No ItemViewDelegate added that matches position=" + position + " in data source");
}getItemViewType() -> delegates.keyAt(i) 使用 index值作为 viewType值。
2.ChatAdapter 使用的时候:
addItemViewDelegate(new MsgSendItemDelagate());
addItemViewDelegate(new MsgComingItemDelagate()); 根据上面（1.ItemViewDelegateManager:）的分析，就有两个viewType 值(0，1).
3.渲染
public void convert(ViewHolder holder, T item, int position) {
int delegatesCount = delegates.size();
for (int i = 0; i < delegatesCount; i++) {
ItemViewDelegate<T> delegate = delegates.valueAt(i);
if (delegate.isForViewType(item, position)) {
delegate.convert(holder, item, position);
return;
}
}
throw new IllegalArgumentException(
"No ItemViewDelegateManager added that matches position=" + position + " in data source");
}for 循环中遍历了所有的viewType值, 然后遇到isForViewType（）返回值为true的情况，就去执行delegate.convert（）.这样就找到了 viewType对应的convert（），