android极简adapter

android-adapter

android极简adapter,支持list-adapter、expandable-list-adapter以及recycler-adapter,可以非常方便的创建单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、创建最简单的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、创建多type的adapter

  • 这里使用ListAdapter举例说明,ExpandableListAdapter与RecyclerAdapter的类似。
  • 多type的adapter的创建方式是通过注册多种type的视图提供器,然后根据position与对应的entity去选择对应的视图提供器,然后进行视图的渲染与数据绑定。
  • 多type的adapter创建方式有两种,一种是根据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());

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,362评论 5 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,330评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,247评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,560评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,580评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,569评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,929评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,587评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,840评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,596评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,678评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,366评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,945评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,929评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,165评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,271评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,403评论 2 342

推荐阅读更多精彩内容