RecyclerViewAdapter
重新定义RecyclerView Adapter的封装，追求既简单又实用，结合Kotlin的高级特性，优化代码书写方式，真正做到高内聚低耦合
开源地址
Github RecyclerViewAdapter
框架设计核心思想
- 摒弃notifyDataSetChanged无脑操作，利用ObservableList自动匹配数据，并实现局部刷新
- 真正通用的ViewHolder抽象，从此只关注Layout XML布局
- 真正通用的Adapter，从此不再写Adapter子类
- ItemViewType自动匹配对象Layout XML，不再关心它的细节
- 科学的分包处理，真正做到框架的各取所需（一般列表只需引用Adapter-core核心库即可）
- 扩展Anko Layout版本，体验Anko Layout的魅力，并能获取高于XML加载至少3倍以上的效率提升
- 像堆积木一样，将页面的每个模块都做到了复用，跟Fragment可以说再见
设计图
Image
规划
核心库Core的完善Anko扩展- FlexboxLayout 扩展
- SortedList 扩展
- paging 3 扩展
- DiffUtil 扩展
- DataBinding 扩展
- 等等.. 未来有好的想法继续扩展
现在有ArrayListAdapter，AnkoListAdapter，未来会有SortedListAdapter，PagingAdapter，为啥这么设计呢？
- 第一、原则上我根本不会去设计一款超级庞大的Adapter支持各种功能，单一职责需要贯穿始终
- 第二、保持各个Lib的特点，可以根据业务的不同自由选择，最大程度的减少包体积，真正体现了没有最好最全，只有最合适的思想
- 第三、保持可动态扩展的特性，你理解了原理，你也可以根据自己的需要定制，未来官方提供MergeAdapter组合使用方式，以及我们未来做一个WrapAdapter，你会发现更多组合额的可能性。
少了点什么？
你是不是觉得少了点什么功能？空布局，上拉加载，下拉加载，拖动，头布局，脚布局，展开折叠，分割线，动画等等，这些后期都会带着你们去实现，上面的规划更偏向于底层框架的封装，而这些功能更偏向业务组件，方向不同，不要着急哦，带着你们一步步完善，来体验封装Adapter中的乐趣
库大小
| 名字 | release aar size | 其他 |
|---|---|---|
| Core | 25kb | 核心库目前包含ArrayListAdapter的实现 |
| Anko | 12kb | anko扩展库包含AnkoListAdapter |
| Sorted | 0kb | 待实现 |
| .. | .. | 待实现 |
环境需要
- Kotlin
- JAVA
- AndroidX
抱歉目前按照最新的AndroidX适配的，如有其他需要请私聊我。
怎么用
ArrayListAdapter
step1
创建xml布局,和之前一样的布局方式
step2
定义ViewModel及Model，可以看到，逻辑简单明了，刷新自己的时候只需要更新Model，并reBindView即可，刷新别人的话，需要通过Adapter去更新，复杂页面只需要再新建一个ArrayItemViewModel的子类即可，并创建一个新的XML布局，从这里的代码可以看出，同样一个ViewModel未来可以复用很多XML布局，完全做到了ViewModel、View、Model三个角色的任意复用。为业务多样化提供最底层的支持。
/**
* Model
*/
data class ModelTest(var title: String, var subTitle: String)
/**
* ViewModel
*/
class ArrayViewModelTest : ArrayItemViewModel() {
var index = 0
override fun onBindView(adapter: ArrayListAdapter?) {
viewHolder.itemView.apply {
tv_title.text = model.title
tv_subTitle.text = model.subTitle
cardItem.setOnClickListener {
model.title = "${index++}"
reBindView()
}
}
}
override fun getLayoutRes() = R.layout.item_test
}
复用逻辑如下图：
image
step3
Activity 中增删改，增删改都是对ViewModel层的操作，简单实用。
/**
* Activity
*/
class ArrayListActivity : AppCompatActivity() {
private val mArrayListAdapter by lazy {
ArrayListAdapter()
}
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_array_list)
rv_list.bindListAdapter(mArrayListAdapter)
// 新增一个
new_add.setText("新增").setOnClickListener {
mArrayListAdapter.add(ArrayViewModelTest().apply {
model = ModelTest("标题", "副标题")
})
}
// 删除第一个
delete.setText("删除").setOnClickListener {
if (mArrayListAdapter.size > 0)
mArrayListAdapter.removeAt(0)
else
toast("请添加新用例后再试")
}
// 随机更新
var updateSize = 0
update.setText("更新").setOnClickListener {
updateSize++
if (mArrayListAdapter.size > 0) {
val randomInt = Random.nextInt(0, mArrayListAdapter.size)
mArrayListAdapter.set(randomInt, ArrayViewModelTest().apply {
model = ModelTest("标题$updateSize", "副标题$updateSize")
})
} else {
toast("请添加新用例后再试")
}
}
}
}
AnkoListAdapter
step1
定义AnkoLayout
/**
* AnkoItemView
*/
class AnkoItemView() : AnkoComponent {
var tvTitle: TextView? = null
var tvSubTitle: TextView? = null
@SuppressLint("ResourceType")
override fun createView(ui: AnkoContext) = with(ui) {
cardView {
layoutParams = FrameLayout.LayoutParams(
FrameLayout.LayoutParams.MATCH_PARENT,
FrameLayout.LayoutParams.WRAP_CONTENT
).apply {
margin = dip(5)
}
verticalLayout {
val typedValue = TypedValue()
context.theme
.resolveAttribute(android.R.attr.selectableItemBackground, typedValue, true)
val attribute = intArrayOf(android.R.attr.selectableItemBackground)
val typedArray =
context.theme.obtainStyledAttributes(typedValue.resourceId, attribute)
background = typedArray.getDrawable(0)
layoutParams = FrameLayout.LayoutParams(
FrameLayout.LayoutParams.MATCH_PARENT,
FrameLayout.LayoutParams.WRAP_CONTENT
).apply {
padding = dip(10)
}
tvTitle = textView {
textSize = px2dip(60)
textColorResource = R.color.colorPrimary
}.lparams(matchParent, wrapContent)
tvSubTitle = textView {
textSize = px2dip(45)
textColorResource = R.color.colorAccent
}.lparams(matchParent, wrapContent)
}
}
}
}
step2
定义ViewModel，Model
/**
* Model
*/
data class ModelTest(var title: String, var subTitle: String)
/**
* ViewModel
*/
class AnkoViewModelTest : AnkoItemViewModel() {
var index = 0
override fun onBindView(adapter: AnkoListAdapter) {
ankoView.tvTitle?.text = model.title
ankoView.tvSubTitle?.text = model.subTitle
viewHolder.itemView.setOnClickListener {
model.title = "${index++}"
reBindView()
}
}
override fun onCreateView(): AnkoItemView {
return AnkoItemView()
}
}
step3
Activity 中增删改
/**
* Activity
*/
class AnkoLayoutActivity : AppCompatActivity() {
private val mAnkoListAdapter by lazy {
AnkoListAdapter()
}
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
AnkoLayoutComponent(mAnkoListAdapter).setContentView(this).apply {
// 新增一个
new_add.setText("新增").setOnClickListener {
mAnkoListAdapter.add(AnkoViewModelTest().apply {
model = ModelTest("标题", "副标题")
})
}
// 删除第一个
delete.setText("删除").setOnClickListener {
if (mAnkoListAdapter.size > 0)
mAnkoListAdapter.removeAt(0)
else
toast("请添加新用例后再试")
}
// 随机更新
var updateSize = 0
update.setText("更新").setOnClickListener {
updateSize++
if (mAnkoListAdapter.size > 0) {
val randomInt = Random.nextInt(0, mAnkoListAdapter.size)
mAnkoListAdapter.set(randomInt, mAnkoListAdapter.getItem(randomInt).apply {
model.also {
it as ModelTest
it.title = "$updateSize"
}
})
} else {
toast("请添加新用例后再试")
}
}
}
}
}
/**
* View
*
*/
class AnkoLayoutComponent(private val ankoListAdapter: AnkoListAdapter) : AnkoComponent {
override fun createView(ui: AnkoContext) = with(ui) {
verticalLayout {
recyclerView {
bindListAdapter(ankoListAdapter)
}.lparams(matchParent) {
weight = 1F
}
// Anko 兼容 xml布局的加载
include(R.layout.include_button_bottom)
}
}
}
上一篇博客
一个资深的Android是不是应该学会自己做一个超级的RecyclerView.Adapter
开发者
- i校长
- Jetpack.net.cn
- 简书
- 掘金