android-adapter
android極簡adapter蕉鸳,支持list-adapter与境、expandable-list-adapter以及recycler-adapter豪治,可以非常方便的創(chuàng)建單type以及多type的adapter温亲。
github地址:https://github.com/694551594/android-adapter
gradle配置方式:
compile 'cn.yhq:android-adapter:1.0.2'
compile 'cn.yhq:android-recycler-adapter:1.0.2'
使用方式:
1、創(chuàng)建最簡單的adapter(單type)
(1)類似List<T>
的數據(單List遗淳,即ListView或者GridView適配的adapter)变泄,使用SimpleListAdapter即可令哟,代碼如下:
SimpleListAdapter<String> adapter = SimpleListAdapter.create(this, getDatas(), R.layout.layout_item1,
new SimpleListAdapter.IItemViewSetup<String>() {
@Override
public void setupView(ViewHolder viewHolder, int position, String entity) {
viewHolder.bindTextData(R.id.item_text, entity);
}
});
(2)類似List<List<T>>
的數據(List里面嵌套List,即ExpandableListView適配的adapter)妨蛹,使用SimpleExpandableListAdapter即可屏富,代碼如下:
SimpleExpandableListAdapter<Group, Child> adapter =
SimpleExpandableListAdapter.create(this, getDatas(), R.layout.layout_item1, R.layout.layout_item1, new SimpleExpandableListAdapter.IItemViewSetup<Group, Child>() {
@Override
public void setupGroupView(ViewHolder viewHolder, int position, Group entity, boolean isExpanded) {
viewHolder.bindTextData(R.id.item_text, entity.text);
}
@Override
public void setupChildView(ViewHolder viewHolder, int groupPosition, Group groupEntity, int childPosition, Child childEntity) {
viewHolder.bindTextData(R.id.item_text, childEntity.text);
}
@Override
public Child getChild(Group group, int childPosition) {
return group.childs.get(childPosition);
}
@Override
public int getChildrenCount(Group group) {
return group.childs.size();
}
});
(3)RecyclerView適配的adapter,使用SimpleRecyclerListAdapter即可蛙卤,代碼如下:
SimpleRecyclerListAdapter<String> adapter = SimpleRecyclerListAdapter.create(this, getDatas(),
R.layout.layout_item1, new SimpleRecyclerListAdapter.IItemViewSetup<String>() {
@Override
public void setupView(cn.yhq.adapter.recycler.ViewHolder viewHolder, int position,
String entity) {
viewHolder.bindTextData(R.id.item_text, entity);
}
});
(4)當然狠半,如果你不想使用自帶的Simple**Adapter,你可以使用上述三種對應的ListAdapter颤难、BaseExpandableListAdapter神年、RecyclerListAdapter去實現自己的adapter。
(5)如果你的數據類型不是List<T>
這種的行嗤,比如是JsonArray
或者Object {List<T>}
這種的已日,就需要繼承BaseAdapter<L, I>
、BaseExpandableAdapter<L, G, C>
栅屏、RecyclerBaseAdapter<L, I>
去實現自己的adapter飘千,這里舉一個自定義ListAdapter的例子:
public class ListObjectAdapter extends BaseAdapter<ListObject, String> {
public ListObjectAdapter(Context context, ListObject listData) {
super(context, listData);
}
public ListObjectAdapter(Context context) {
super(context);
}
@Override
protected ListObject newInstance() {
return new ListObject();
}
@Override
public void clearAllItem() {
}
@Override
public void addAllItem(ListObject items) {
}
@Override
public void addItem(String item) {
}
@Override
public void removeItem(String item) {
}
@Override
public void removeItem(int position) {
}
@Override
public int getCount() {
return 0;
}
@Override
public String getItem(int position) {
return null;
}
}
public class ListObject {
public List<String> list;
}
2、創(chuàng)建多type的adapter
- 這里使用ListAdapter舉例說明栈雳,ExpandableListAdapter與RecyclerAdapter的類似护奈。
- 多type的adapter的創(chuàng)建方式是通過注冊多種type的視圖提供器,然后根據position與對應的entity去選擇對應的視圖提供器哥纫,然后進行視圖的渲染與數據綁定霉旗。
- 多type的adapter創(chuàng)建方式有兩種,一種是根據key值注冊視圖提供器蛀骇,一種是直接注冊帶選擇器的視圖提供器奖慌。這里分別舉例說明:
(1)根據key去注冊視圖提供器
此種方式通過調用adapter的register(key,ItemViewProvider1)方法去注冊對應類型的視圖提供器松靡,此外還需要通過setItemViewProviderKeyPolicy設置視圖提供器key的選擇策略,用來確定某個item該用哪個視圖提供器進行渲染建椰,現在我們寫一個有兩種類型的item的adapter:
示例代碼
public class MutipleTypeListAdapter1 extends ListAdapter<MutipleTypeObject> {
public final static int TYPE_1 = 1;
public final static int TYPE_2 = 2;
public MutipleTypeListAdapter1(Context context) {
super(context);
// 注冊類型1的視圖提供器
this.register(TYPE_1, new ItemViewProvider1<MutipleTypeObject>() {
@Override
public int getItemViewLayoutId() {
return R.layout.layout_item1;
}
@Override
public void setupView(ViewHolder viewHolder, int position, MutipleTypeObject entity) {
viewHolder.bindTextData(R.id.item_text, entity.text);
}
});
// 注冊類型2的視圖提供器
this.register(TYPE_2, new ItemViewProvider1<MutipleTypeObject>() {
@Override
public int getItemViewLayoutId() {
return R.layout.layout_item2;
}
@Override
public void setupView(ViewHolder viewHolder, int position, MutipleTypeObject entity) {
viewHolder.bindTextData(R.id.item_text, entity.text);
}
});
// 設置視圖提供器的選擇策略
this.setItemViewProviderKeyPolicy(new IItemViewProviderKeyPolicy<MutipleTypeObject>() {
@Override
public int getItemViewProviderKey(int position, MutipleTypeObject entity) {
if (entity.type == MutipleTypeObject.TYPE_1) {
return TYPE_1;
} else if (entity.type == MutipleTypeObject.TYPE_2) {
return TYPE_2;
}
return -1;
}
});
}
}
(2)根據選擇器去選擇視圖提供器
此種方式通過調用adapter的register(ItemViewProvider2)方法去注冊對應類型的視圖提供器雕欺,與第一種方式不同的是,這種方式需要實現isForProvider方法,用來確定某個item是否使用當前視圖提供器進行渲染屠列,現在我們寫一個有兩種類型的item的adapter:
示例代碼
public class MutipleTypeListAdapter2 extends ListAdapter<MutipleTypeObject> {
public MutipleTypeListAdapter2(Context context) {
super(context);
// 注冊類型1的視圖提供器
this.register(new ItemViewProvider2<MutipleTypeObject>() {
@Override
public boolean isForProvider(int position, MutipleTypeObject entity) {
return entity.type == MutipleTypeObject.TYPE_1;
}
@Override
public int getItemViewLayoutId() {
return R.layout.layout_item1;
}
@Override
public void setupView(ViewHolder viewHolder, int position, MutipleTypeObject entity) {
viewHolder.bindTextData(R.id.item_text, entity.text);
}
});
// 注冊類型2的視圖提供器
this.register(new ItemViewProvider2<MutipleTypeObject>() {
@Override
public boolean isForProvider(int position, MutipleTypeObject entity) {
return entity.type == MutipleTypeObject.TYPE_2;
}
@Override
public int getItemViewLayoutId() {
return R.layout.layout_item2;
}
@Override
public void setupView(ViewHolder viewHolder, int position, MutipleTypeObject entity) {
viewHolder.bindTextData(R.id.item_text, entity.text);
}
});
}
}
(3)以上兩種方式啦逆,第一種方式去獲取視圖提供器的效率較高,第二種方式因為要輪詢笛洛,所以效率較低夏志,如果item type的數量較多,建議采用第一種方式去注冊視圖提供器苛让。
3沟蔑、對于item圖片的處理:
目前ViewHolder里面只提供系統本身的api封裝,沒有封裝第三方的圖片處理框架狱杰,但是ViewHolder是調用了我的另外一個庫AndroidViewBinding瘦材,所以可以根據你自己項目里面所使用的圖片處理框架去注冊一下即可:
ViewBinder.register(ImageView.class, new CustomImageViewBinding());
ViewBinder.register(AppCompatImageView.class, new CustomImageViewBinding());