README.md

DelegationAdapter

一种优雅的方式来使用RecyclerView

核心思想

　　想必大家都遇到过，在一个列表中显示不同样式的需求。在RecyclerView中可以通过ViewType进行区分，如果样式特别多的时候就会使得代码非常冗余，不利于开发及维护。那么有没有一种优雅的方法解决这个问题呢？

　　技术经理给你说，接下来的项目由你负责，明天下班前把排期同步出来。这时你应该怎么做？由于你是Android端的RD，你对Android的排期是比较了解的，但是iOS端、FE端、Server端的排期怎么办呢？聪明的你立即把任务派发下去了，给每个端的负责人说，明天中午之前把排期汇总给我。

　　没错，在多样式列表的设计中也可以采用这种策略，给RecyclerView设置的Adapter不做具体的处理，而是由它派发出去。

实现方案

1. addDelegate 向Adapter中注册委托Adapter;
2. addDataList 设置数据；
3. layout 渲染布局，Adapter查找到对应的委托Adapter，由委托Adapter去做具体渲染。

如何使用

引入

compile 'com.kevin:delegationadapter:1.0.2'
// 扩展库，使得databinding更简易，可以不引入
compile 'com.kevin:delegationadapter-extras:1.0.0'

用法

1. 同一数据类型多种样式

   

   // 设置LayoutManager
   LinearLayoutManager layoutManager = new LinearLayoutManager(this);
   recyclerView.setLayoutManager(layoutManager);
   // 设置Adapter
   delegationAdapter = new DelegationAdapter();
   // 添加委托Adapter
   delegationAdapter.addDelegate(new OnePicAdapterDelegate());
   delegationAdapter.addDelegate(new ThreePicAdapterDelegate());
   delegationAdapter.addDelegate(new MorePicAdapterDelegate());
   delegationAdapter.addDelegate(new VideoAdapterDelegate());
   recyclerView.setAdapter(delegationAdapter);
   

2. 不同数据类型多种样式

   // 设置LayoutManager
   LinearLayoutManager layoutManager = new LinearLayoutManager(this);
   mRecyclerView.setLayoutManager(layoutManager);
   // 设置Adapter
   mDelegationAdapter = new DelegationAdapter();
   mDelegationAdapter.addDelegate(new StringAdapterDelegate());
   mDelegationAdapter.addDelegate(new IntegerAdapterDelegate());
   mDelegationAdapter.addDelegate(new FloatAdapterDelegate());
   mDelegationAdapter.addDelegate(new DoubleAdapterDelegate());
   // 添加委托Adapter
   mRecyclerView.setAdapter(mDelegationAdapter);
   
   // 设置数据
   List<Object> dataList = new ArrayList<>();
   dataList.add("今天天气怎么样？");  // 添加一个String类型数据
   dataList.add("大晴天，有点热。");  // 添加一个String类型数据
   dataList.add("温度多少度呢？");    // 添加一个String类型数据
   dataList.add(29);                // 添加一个int类型数据
   dataList.add("具体是多少？");      // 添加一个String类型数据
   dataList.add(29.5F);             // 添加一个Float类型数据
   dataList.add(29.527921364978D);  // 添加一个Double类型数据
   mDelegationAdapter.setDataItems(dataList);
   

3. 同一数据多种类型

   

   // 设置LayoutManager
   mBinding.recyclerView.setLayoutManager(new LinearLayoutManager(this));
   // 设置LayoutManager
   mDelegationAdapter = new DelegationAdapter();
   // 添加委托Adapter
   mDelegationAdapter.addDelegate(new ServiceInfoAdapterDelegate());
   mDelegationAdapter.addDelegate(new BillItemAdapterDelegate());
   mDelegationAdapter.addDelegate(new ChargeInfoAdapterDelegate());
   mBinding.recyclerView.setAdapter(mDelegationAdapter);
   
   // 设置数据
   String newsListStr = LocalFileUtils.getStringFormAsset(this, "bill.json");
   Bill bill = new Gson().fromJson(newsListStr, Bill.class);
   
   List<Object> dataList = new ArrayList<>();
   dataList.add(new ItemData(bill, ServiceInfoDelegateAdapter.TAG));
   dataList.addAll(bill.details);
   dataList.add(new ItemData(bill, ChargeInfoDelegateAdapter.TAG));
   mDelegationAdapter.setDataItems(dataList);
   

4. 添加头部

   // 设置LayoutManager
   LinearLayoutManager layoutManager = new LinearLayoutManager(this);
   mRecyclerView.setLayoutManager(layoutManager);
   // 设置Adapter
   mDelegationAdapter = new DelegationAdapter();
   // 添加委托Adapter
   mDelegationAdapter.addDelegate(new TextAdapterDelegate());
   mDelegationAdapter.addDelegate(new BannerAdapterDelegate());
   mRecyclerView.setAdapter(mDelegationAdapter);
   
   // 添加头部
   mDelegationAdapter.addHeaderItem("这是添加的添加的头部数据");
   

5. 添加尾部

   // 设置LayoutManager
   LinearLayoutManager layoutManager = new LinearLayoutManager(this);
   mRecyclerView.setLayoutManager(layoutManager);
   // 设置Adapter
   mDelegationAdapter = new DelegationAdapter();
   // 添加委托Adapter
   mDelegationAdapter.addDelegate(new TextAdapterDelegate());
   mDelegationAdapter.addDelegate(new BannerAdapterDelegate());
   mRecyclerView.setAdapter(mDelegationAdapter);
   
   // 添加尾部
   mDelegationAdapter.addFotterItem("这是添加的添加的尾部数据");
   

6. 带兜底的委托Adapter

   // 设置LayoutManager
   LinearLayoutManager layoutManager = new LinearLayoutManager(this);
   mRecyclerView.setLayoutManager(layoutManager);
   // 设置Adapter
   mDelegationAdapter = new DelegationAdapter();
   // 添加委托Adapter
   mDelegationAdapter.addDelegate(new TextAdapterDelegate());
   // 添加兜底的委托Adapter
   mDelegationAdapter.setFallbackDelegate(new FallbackAdapterDelegate());
   mRecyclerView.setAdapter(mDelegationAdapter);
   

THANKS TO

1. MultiItem 委托思想来源
2. AdapterDelegates 委托架子来源