radapter

使用 radapter，你可以方便的构造多种类型的列表视图。

前言

三个月没有更新博客了，主要是因为最近换了工作，在新公司还在摸爬滚打，没有时间更新，心想2018年就要结束了，不能留下遗憾，于是趁着元旦假期来一发，biu~ 以后应该会正常更新，感谢关注的朋友们。

2018年对大部分人来说是萧条的一年，我在此祝愿大家2019年红红火火，升职加薪！

不知道还有没有人记得前一篇 打造一个通用的 RecyclerView Adapter，这个版本算是比较初级的，因此也没有上传到仓库，经过自己一年来的使用，不断完善，终于推出 2.0 版本了，并且也上传了 JitPack 仓库，下面我就来介绍一下这个 2.0 版本有什么不同吧。

使用

Gradle

Step 1. Add the JitPack repository to your build file

Add it in your root build.gradle at the end of repositories:

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

Step 2. Add the dependency

dependencies {
    implementation 'com.github.wangchenyan:radapter:2.0'
}

混淆

该库已经默认添加了混淆配置，使用 AAR 依赖是不需要特殊处理的，如果使用 Jar 依赖，需要手动添加以下配置

-keepclassmembers class * extends me.wcy.radapter.RViewHolder {
    public <init>(android.view.View);
}

介绍

原始的使用 Recycler View 的方式我就不赘述了，总之是比较繁琐的，我直接介绍 radapter 如何使用。

对于多种类型的列表，我们一般是根据 getItemViewType() 区分类型，来构造、渲染视图，这种繁琐的方式大家应该已经写得要吐了吧，反正我是不想再写了。

radapter 就是来解救你的，它可以让你丢弃 Adapter，丢弃多类型时繁琐的逻辑，只需要保留有用的部分，即 ViewHolder，使 ViewHolder 可以专注于处理自己的业务。

来看一个栗子，一个图文混合的列表

// 首先，添加数据，Image 保存了图片资源ID，Text 保存了文本
val dataList = mutableListOf<Any>()
dataList.add(Image(R.mipmap.image1))
dataList.add(Text("渊虹"))
dataList.add(Image(R.mipmap.image2))
dataList.add(Text("鲨齿"))
dataList.add(Image(R.mipmap.image3))
dataList.add(Text("干将莫邪"))
dataList.add(Image(R.mipmap.image4))
dataList.add(Text("墨眉"))

// 使用 radapter，注册数据和 ViewHolder
val adapter = RAdapter(dataList)
adapter.register(Image::class.java, ImageViewHolder::class.java)
adapter.register(Text::class.java, TextViewHolder::class.java)

// 设置 adapter
recycler.layoutManager = LinearLayoutManager(this)
recycler.adapter = adapter

使用就这么简单，你只需要实现 ViewHolder 即可，看下 ViewHolder 的实现

@RLayout(R.layout.view_holder_image)
class ImageViewHolder(itemView: View) : RViewHolder<Image>(itemView) {
    override fun refresh() {
        itemView.image.setImageResource(data().resId)
    }
}

继承 RViewHolder，复写 refresh 方法刷新视图即可，可以使用父类的方法和变量

方法/变量	返回值/类型	备注
context	Context	上下文
adapter()	RAdapter	适配器
data()	T	泛型数据
position()	int	当前位置，调用 adapter 的 notifyItemInserted 或 notifyItemRemoved 后会自动更新位置
getExtra(key: Int)	Any	可以取得 adapter.putExtra() 存放的数据，下文会介绍

这些方法/变量应该足够我们使用了。

看下效果

image

到现在，我们可以根据数据类型区分不同的 ViewHolder，但有时候同一种类型的数据，可能根据不同的属性，也要展示不同的 ViewHolder，怎么办呢？

我们把栗子稍微改一下，还是图文混合，现在可以设置文本的样式，样式不同要使用不同的 ViewHolder，看一下如何实现

// 我们给 Text 加上 style 属性
val dataList = mutableListOf<Any>()
dataList.add(Image(R.mipmap.image1))
dataList.add(Text("渊虹", 2))
dataList.add(Image(R.mipmap.image2))
dataList.add(Text("鲨齿", 1))
dataList.add(Image(R.mipmap.image3))
dataList.add(Text("干将莫邪", 2))
dataList.add(Image(R.mipmap.image4))
dataList.add(Text("墨眉", 1))

val adapter = RAdapter(dataList)
adapter.register(Image::class.java, ImageViewHolder::class.java)
// 注册 Text 时使用 RConverter，根据 Text 的属性，使用不同的 ViewHolder
adapter.register(Text::class.java, object : RConverter<Text>() {
    override fun convert(data: Text): RViewHolderWrap<Text> {
        return when (data.style) {
            1 -> RViewHolderWrap(TextViewHolder1::class.java)
            2 -> RViewHolderWrap(TextViewHolder2::class.java)
            else -> RViewHolderWrap(TextViewHolder2::class.java)
        }
    }
})

recycler.layoutManager = LinearLayoutManager(this)
recycler.adapter = adapter

仍然很简单，看下效果

image

看了 ViewHolder 的代码，我们知道，ViewHolder 和 layout 通过注解的方式绑定，但是有些同学说我想在 library 里面使用怎么办，我们知道，library 里面注解不能直接引用 R 文件里面的常量，这个也很简单，注册时使用重载方法即可

adapter.register(Image::class.java, ImageViewHolder::class.java, R.layout.view_holder_image)
adapter.register(Text::class.java, object : RConverter<Text>() {
    override fun convert(data: Text): RViewHolderWrap<Text> {
        return when (data.style) {
            1 -> RViewHolderWrap(TextViewHolder2::class.java)
            2 -> RViewHolderWrap(TextViewHolder1::class.java, R.layout.view_holder_text_1)
            else -> RViewHolderWrap(TextViewHolder1::class.java, R.layout.view_holder_text_1)
        }
    }
})

有时，我们想在 ViewHolder 里面使用 Activity/Fragment 里面的数据，这是比较麻烦的，这里我们也考虑到了

// Activity
adapter.putExtra(100, "any extra")

// ViewHolder
可以取得 adapter.putExtra() 存放的数据
val extra = adapter().getExtra(100)

是不是方便了许多。

代码

radapter

总结

大家在使用中有什么问题或建议，欢迎提 Issues