Yasha(夜叉) - 基于Kotlin的现代化RecyclerView渲染武器

Yasha (夜叉)

物品介绍:

基于Kotlin的现代化RecyclerView渲染武器

物品特点:

  • 无需Adapter
  • 无需ViewHolder
  • 支持初始化数据加载
  • 支持数据分页加载
  • 支持MultiViewType
  • 支持Header和Footer
  • 支持DiffUtil
  • 支持Loading State
  • 支持CleanUp, 释放资源避免内存泄漏

First Blood

如何快速渲染一个RecyclerView?还在不厌其烦的写Adapter,ViewHolder? 快让夜叉来拯救你吧:


  //以 **dataSource** 作为数据源渲染一个列表
  recycler_view.linear(dataSource) {

      //渲染一个NormalItem类型的Item
      renderItem<NormalItem> {
          //布局文件
          res(R.layout.view_holder_normal)

          //绑定数据 
          onBind {
              tv_normal_content.text = data.toString()
          }
      }

      //渲染一个HeaderItem类型的头布局
      renderItem<HeaderItem> {
          //布局文件
          res(R.layout.view_holder_header)

          //绑定数据
          onBind {
              tv_header_content.text = data.toString()
          }
      }

      //渲染一个FooterItem类型的尾部
      renderItem<FooterItem> {

          //布局文件
          res(R.layout.view_holder_footer)

          //绑定数据
          onBind {
              tv_footer_content.text = data.toString()
          }
      }
  }

如你所见,非常简单并且直观,并且没有看到任何的Adapter以及ViewHolder,装备夜叉,去Gank吧!

Double Kill

渲染搞定了,数据源从何而来呢?夜叉贴心的为你准备了它的好伙伴:散华

散华是另一件强大的武器,它能提供夜叉所需要的任何数据,有了它夜叉才能如鱼得水,就像在Dota中它俩也是形影不离,熟悉Dota的朋友都知道,夜叉+散华=暗夜对剑,所以这里也是一样,有了它们俩,何惧任何逆风局?

//创建一个DataSource
class DemoDataSource : YashaDataSource() {
   
    //loadInitial负责加载列表初始化数据
    override fun loadInitial(loadCallback: LoadCallback<YashaItem>) {
        
        //模拟延时,不用担心,该方法会在异步线程中执行,因此你可以放心在这里进行网络请求或者数据库加载等等
        Thread.sleep(1500)

        val allDataList = mutableListOf<YashaItem>()

        //添加Header数据
        for (i in 0 until 2) {
            allDataList.add(HeaderItem(i))
        }
        //添加Item数据
        for (i in 0 until 10) {
            allDataList.add(NormalItem(i))
        }
        //添加Footer数据
        for (i in 0 until 2) {
            allDataList.add(FooterItem(i))
        }

        //通知数据加载完毕
        loadCallback.setResult(allDataList)
    }

    //loadAfter负责加载下一页数据,夜叉会自己决定是否触发了分页加载,你只需要做好加载下一页的逻辑,其他的交给夜叉吧
    override fun loadAfter(loadCallback: LoadCallback<YashaItem>) {
       
        //当加载失败:
        if (page % 3 == 0) {

            //当数据加载失败时,只需要简单告诉夜叉一个NULL值,夜叉就会自动停止加载,并显示一个加载失败的状态
            loadCallback.setResult(null)
            return
        }

        //当加载完毕:
        if(page == 5) {
            //当数据加载完之后,只需要告诉夜叉一个空列表,夜叉就会自动停止加载,并且显示一个加载完毕的状态
            loadCallback.setResult(emptyList())
            return
        }

        //加载下一页数据:
        val items = mutableListOf<YashaItem>()
        for (i in page * 10 until (page + 1) * 10) {
            items.add(NormalItem(i))
        }

        loadCallback.setResult(items)
    }
}

是不是很轻松?没错,夜叉和散华提供的API简单易懂,无需任何门槛即可快速上手,简直是居家旅行,杀人越货必备的武器!

除此之外,散华还提供了很多直接操作数据源的API,例如

//Headers
fun addHeader(t: T, position: Int = -1, delay: Boolean = false)
fun addHeaders(list: List<T>, position: Int = -1, delay: Boolean = false) 
fun removeHeader(t: T, delay: Boolean = false) 
fun setHeader(old: T, new: T, delay: Boolean = false)
fun getHeader(position: Int): T
fun clearHeader(delay: Boolean = false)

//Footers
fun addFooter(t: T, position: Int = -1, delay: Boolean = false)
fun addFooters(list: List<T>, position: Int = -1, delay: Boolean = false) 
fun removeFooter(t: T, delay: Boolean = false) 
fun setFooter(old: T, new: T, delay: Boolean = false)
fun getFooter(position: Int): T
fun clearFooter(delay: Boolean = false)

//Items
fun addItem(t: T, position: Int = -1, delay: Boolean = false)
fun addItems(list: List<T>, position: Int = -1, delay: Boolean = false) 
fun removeItem(t: T, delay: Boolean = false) 
fun setItem(old: T, new: T, delay: Boolean = false)
fun getItem(position: Int): T
fun clearItem(delay: Boolean = false)

//等等API接口

Triple Kill

除此之外,夜叉还贴心的为各位小哥们准备了状态的显示,如常用的加载中加载失败加载完成

那如果对自带的状态有任何不满,那很简单,第一种办法就是干掉它,第二种办法就是替换它

//干掉它:
class DemoDataSource : YashaDataSource() {

    override fun onStateChanged(newState: Int) {
        //super.onStateChanged(newState)
        //只需要重新这个方法并且注释掉super的调用即可,这样就没有任何状态显示啦!
    }
}

//替换它:
recycler_view.linear(dataSource) {

    //替换成你自己的状态渲染方式
    renderItem<YashaStateItem> {
        //新的状态布局
        res(R.layout.your_state_view)

        //新的状态绑定
        onBind {
            
        }
        gridSpanSize(spanCount)
        staggerFullSpan(true)
    }
}

天辉获胜,GG

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

推荐阅读更多精彩内容