升級動機：
2.x版本不在進行新功能的增加，同時3.x版本多布局更佳靈活，考慮到經常使用該庫，所以進行升級
項目地址: https://github.com/CymChad/BaseRecyclerViewAdapterHelper
普通改動點：
- helper.addOnClickListener修改為addChildClickViewIds，且不能放在convert中，java需要 放在構造方法中，kotlin放在init中
- BaseViewHolder導包修改 import com.chad.library.adapter.base.BaseViewHolder;改為import com.chad.library.adapter.base.viewholder.BaseViewHolder;
- setGone的true和false對調，需要修改成相反邏輯
- adapter.emptyView = xxxx需要修改為adapter.setEmpty()
- setNewData()設置第一頁數據需要修改為setList(),否則賦值不成功
- 上下文mContext,java改為getContext(), kotlin改為context來獲取context
- 數據源mData,java改為getData(),kotln改為data來獲取數據源
較大改動點：
1.快速實現帶頭部的 Adapter，BaseSectionQuickAdapter，這里只列舉了item只有一種類型的寫法，多類型可以參考github寫法
Adapter代碼如下：
public class SectionQuickAdapter extends BaseSectionQuickAdapter<MySection, BaseViewHolder> {
/**
* 構造方法里， super()必須設置 header layout
* data可有可無
*/
public SectionQuickAdapter(int layoutResId, int sectionHeadResId, List<MySection> data) {
super(sectionHeadResId, data);
// 設置普通item布局（如果item類型只有一種，使用此方法）
setNormalLayout(layoutResId);
// 注冊需要點擊的子view id
addChildClickViewIds(R.id.more);
}
/**
* 設置header數據
*/
@Override
protected void convertHeader(@NotNull BaseViewHolder helper, @NotNull MySection item) {
if (item != null && item.getObject() instanceof String) {
helper.setText(R.id.header, (String) item.getObject());
}
}
@Override
protected void convert(@NotNull BaseViewHolder helper, MySection item) {
//設置item數據
Video video = (Video) item.getObject();
helper.setText(R.id.tv, video.getName());
}
}
實體類的寫法：
/**
* java 寫法
*/
public class MySection extends JSectionEntity {
// 你的數據內容
private boolean isHeader;
private Object object;
public MySection(boolean isHeader, Object object) {
this.isHeader = isHeader;
this.object = object;
}
public Object getObject() {
return object;
}
/**
* 重寫此方法，返回 boolen 值，告知是否是header
*/
@Override
public boolean isHeader() {
return isHeader;
}
}
/**
* kotlin 寫法
*/
class DataBean: SectionEntity {
// 你的數據實體內容
...
...
/**
* 重寫此方法，返回 boolen 值，告知是否是header
*/
override val isHeader: Boolean
get() {
// 根據數據實體內的數據，判斷是否是header
return false
}
}
2.具有展開折疊的BaseNodeAdapter
說明： 繼承自BaseProviderMultiAdapter，這是一個類似節點樹功能的Adapter，具有展開\收起節點的功能。可以實現更自由的Section功能，或者樹形結構，每個item都可以有自己的Footer
此Adapter中的數據類型T固定為BaseNode類，你的數據需要使用BaseNode進行包裝。
1.Adapter代碼如下：
public class NodeAdapter extends BaseNodeAdapter {
public NodeSectionAdapter() {
super();
// 注冊Provider，總共有如下三種方式
// 需要占滿一行的，使用此方法（例如section）
addFullSpanNodeProvider(new RootNodeProvider());
// 普通的item provider
addNodeProvider(new SecondNodeProvider());
// 腳布局的 provider
addFooterNodeProvider(new RootFooterNodeProvider());
}
/**
* 自行根據數據、位置等信息，返回 item 類型
*/
@Override
protected int getItemType(@NotNull List<? extends BaseNode> data, int position) {
BaseNode node = data.get(position);
if (node instanceof RootNode) {
return 0;
} else if (node instanceof ItemNode) {
return 1;
} else if (node instanceof RootFooterNode) {
return 2;
}
return -1;
}
}
2.Provider寫法和BaseProviderMultiAdapter中的相同，只是繼承類改為BaseNodeProvider，其他沒有區別：
public class RootNodeProvider extends BaseNodeProvider {
@Override
public int getItemViewType() {
return 0;
}
@Override
public int getLayoutId() {
return R.layout.def_section_head;
}
@Override
public void convert(@NotNull BaseViewHolder helper, @NotNull BaseNode data) {
// 數據類型需要自己強轉
RootNode entity = (RootNode) data;
helper.setText(R.id.header, entity.getTitle());
}
@Override
public void onClick(@NotNull BaseViewHolder helper, @NotNull View view, BaseNode data, int position) {
getAdapter().expandOrCollapse(position);
}
}
3、設置數據
注意，數據需要遵循樹形結構，簡單來說就是：套娃形式。
下面給出一組示例：先定義幾個節點類，繼承于BaseNode，用于封裝數據：
/**
* 第一個節點FirstNode，里面放子節點SecondNode
*/
public class FirstNode extends BaseNode {
private List<BaseNode> childNode;
private String title;
public FirstNode(List<BaseNode> childNode, String title) {
this.childNode = childNode;
this.title = title;
}
public String getTitle() {
return title;
}
/**
* 重寫此方法，返回子節點
*/
@Nullable
@Override
public List<BaseNode> getChildNode() {
return childNode;
}
}
/**
* 第二個節點SecondNode，里面沒有子節點了
*/
public class SecondNode extends BaseNode {
private String title;
public SecondNode(String title) {
this.title = title;
}
public String getTitle() {
return title;
}
/**
* 重寫此方法，返回子節點
*/
@Nullable
@Override
public List<BaseNode> getChildNode() {
return null;
}
}
模擬生成數據：
private List<BaseNode> getEntity() {
//總的 list，里面放的是 FirstNode
List<BaseNode> list = new ArrayList<>();
for (int i = 0; i < 8; i++) {
//SecondNode 的 list
List<BaseNode> secondNodeList = new ArrayList<>();
for (int n = 0; n <= 5; n++) {
SecondNode seNode = new SecondNode("Second Node " + n);
secondNodeList.add(seNode);
}
FirstNode entity = new FirstNode(secondNodeList, "First Node " + i);
list.add(entity);
}
return list;
}
