四篇文章带你快速入门Jetpck（终）之Navigation，Paging

Jetpack

Jetpack 是一个由多个库组成的套件，可帮助开发者遵循最佳做法，减少样板代码并编写可在各种 Android 版本和设备中一致运行的代码，让开发者精力集中编写重要的代码。

Android Architecture Component (AAC)。

image.png

官方推荐架构

img

请注意，每个组件仅依赖于其下一级的组件。例如，Activity 和 Fragment 仅依赖于视图模型。存储区是唯一依赖于其他多个类的类；在本例中，存储区依赖于持久性数据模型和远程后端数据源。

Navigation

Navigation的诞生

单个Activity嵌套多个Fragment的UI架构模式,已经被大多数Android工程师所接受和采用。但是，对Fragment的管理一直是一件比较麻烦的事情。

需要在FragmentManager和FragmentTransaction来管理Fragment之间的切换。
页面的切换通常还包括对应用程序App bar管理，Fragment间的切换动画，以及Fragment间的参数传递，
Fragment和App bar管理和使用的过程显得很混乱。

Navigation 的优点

可视化的页面导航图。
通过destination和action完成页面间的导航。
方便添加页面切换动画。
页面间类型安全的参数传递。
通过NavigationUI类，对菜单，底部导航，抽屉菜单导航进行统一的管理。

添加依赖库

implementation "androidx.navigation:navigation-fragment:2.3.1"
implementation "androidx.navigation:navigation-ui:2.3.1"
implementation 'androidx.navigation:navigation-fragment-ktx:2.3.1'
implementation 'androidx.navigation:navigation-ui-ktx:2.3.1'

创建Navigation

创建Navigation Graph，nav_graph.xml

添加NavHostFragment

<fragment
    android:id="@+id/nav_host_fragment"
    android:name="androidx.navigation.fragment.NavHostFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:defaultNavHost="true"
    app:navGraph="@navigation/nav_graph" />

android:name="androidx.navigation.fragment.NavHostFragment" ，特殊的Fragment。
app:defaultNavHost="true"，系统自动处理返回键。
app:navGraph="@navigation/nav_graph"，设置该Fragment对应的导航图。

创建destination
完成Fragment之间的切换

使用NavController完成导航

btn_toSettingFragment.setOnClickListener {
 Navigation.findNavController(it).navigate(R.id.action_mainFragment_to_settingFragment)
}

添加页面切换东华效果，创建anim文件夹，添加常用东华

<action
    android:id="@+id/action_mainFragment_to_settingFragment"
    app:destination="@id/settingFragment"
    app:enterAnim="@anim/slide_in_right"
    app:exitAnim="@anim/slide_out_left"
    app:popEnterAnim="@anim/slide_in_left"
    app:popExitAnim="@anim/slide_out_right" />

Fragment传递参数

常见的传递参数的方式

val bundle = Bundle()
bundle.apply {
    putString("user_name", "yaoxin")
    putInt("age", 33)
}
Navigation.findNavController(it).navigate(R.id.action_mainFragment_to_settingFragment, bundle)

使用sate Arg传递参数

添加插件外层build.gradle

dependencies {
    classpath "androidx.navigation:navigation-safe-args-gradle-plugin:2.3.1"
}

添加依赖内层build.gradle

apply plugin: 'androidx.navigation.safeargs'

传递数据

val bundle = MainFragmentArgs.Builder().setUserName("yaoxin1").setAge(12).build().toBundle()
Navigation.findNavController(it).navigate(R.id.action_mainFragment_to_settingFragment, bundle)

获取数据

Log.d("SettingFragment", " username : ${arguments?.let { MainFragmentArgs.fromBundle(it).userName }}")
Log.d("SettingFragment", " age : ${arguments?.let { MainFragmentArgs.fromBundle(it).age }}")

NacvigationUI的使用

actionBar

添加menu.xml。
在Acitivity中重写onCreateOptionsMenu实例化菜单。
初始化，AppBarConfiguration，NavController类并使用NacvigationUI完成配置。
重写onOptionsItemSelected，onSupportNavigateUp方法，实现点击，页面切换。

实现addOnDestinationChangedListener接口，监听页面变化。

navController.addOnDestinationChangedListener { _, _, _ ->
 Log.d("NavigationActivity", "页面发生了改变")
}

DrawLayout + NavigationView 抽屉菜单

添加DrawerLayout布局

<androidx.drawerlayout.widget.DrawerLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/dl_drawerLayout"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

添加NavigationView控件

<com.google.android.material.navigation.NavigationView
    android:id="@+id/nv_NavigationView"
    android:layout_width="wrap_content"
    android:layout_height="match_parent"
    android:layout_gravity="start"
    app:menu="@menu/menu_settings" />

使用NacvigationUI完成配置

appBarConfiguration = AppBarConfiguration.Builder(navController.graph).setDrawerLayout(dl_drawerLayout).build()
NavigationUI.setupWithNavController(nv_navigationView, navController)

ButtomNavigationView 底部菜单

添加BottomNavigationView控件

<com.google.android.material.bottomnavigation.BottomNavigationView
    android:id="@+id/bnv_bottomNavigationView"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:layout_alignParentBottom="true"
    android:background="@color/design_default_color_primary"
    app:itemTextColor="#FFFFFF"
    app:menu="@menu/menu_setting" />

使用NacvigationUI完成配置

NavigationUI.setupWithNavController(bnv_bottomNavigationView, navController)

示例

NavigationActivity

class NavigationActivity : AppCompatActivity() {
    lateinit var appBarConfiguration: AppBarConfiguration
    lateinit var navController: NavController

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_navigation)

        navController = Navigation.findNavController(this, R.id.nav_host_fragment)
        appBarConfiguration = AppBarConfiguration.Builder(navController.graph).build()
        NavigationUI.setupActionBarWithNavController(this, navController, appBarConfiguration)

        navController.addOnDestinationChangedListener { _, _, _ ->
            Log.d("NavigationActivity", "页面发生了改变")
        }

        appBarConfiguration = AppBarConfiguration.Builder(navController.graph).setDrawerLayout(dl_drawerLayout).build()
        NavigationUI.setupWithNavController(nv_navigationView, navController)


        NavigationUI.setupWithNavController(bnv_bottomNavigationView, navController)

    }

    override fun onCreateOptionsMenu(menu: Menu?): Boolean {
        super.onCreateOptionsMenu(menu)
        menuInflater.inflate(R.menu.menu_setting, menu)
        return true
    }

    override fun onOptionsItemSelected(item: MenuItem): Boolean {
        return super.onOptionsItemSelected(item) || NavigationUI.onNavDestinationSelected(item, navController)
    }

    override fun onSupportNavigateUp(): Boolean {
        return super.onSupportNavigateUp() || NavigationUI.navigateUp(navController, appBarConfiguration)
    }
}

activity_navigation.xml

<?xml version="1.0" encoding="utf-8"?>
<androidx.drawerlayout.widget.DrawerLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/dl_drawerLayout"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <RelativeLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        tools:context=".seventh.NavigationActivity">

        <fragment
            android:id="@+id/nav_host_fragment"
            android:name="androidx.navigation.fragment.NavHostFragment"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            app:defaultNavHost="true"
            app:navGraph="@navigation/nav_graph" />

        <com.google.android.material.bottomnavigation.BottomNavigationView
            android:id="@+id/bnv_bottomNavigationView"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:layout_alignParentBottom="true"
            android:background="@color/design_default_color_primary"
            app:itemTextColor="#FFFFFF"
            app:menu="@menu/menu_setting" />
    </RelativeLayout>

    <com.google.android.material.navigation.NavigationView
        android:id="@+id/nv_navigationView"
        android:layout_width="wrap_content"
        android:layout_height="match_parent"
        android:layout_gravity="start"
        app:menu="@menu/menu_setting" />

</androidx.drawerlayout.widget.DrawerLayout>

MainFragment

class MainFragment : Fragment() {


    override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? {
        // Inflate the layout for this fragment
        return inflater.inflate(R.layout.fragment_main, container, false)
    }

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)

        btn_toSettingFragment.setOnClickListener {
            val bundle = Bundle()
            bundle.apply {
                putString("user_name", "yaoxin")
                putInt("age", 33)
            }
            val bundle1 = MainFragmentArgs.Builder().setUserName("yaoxin1").setAge(12).build().toBundle()


            Navigation.findNavController(it).navigate(R.id.action_mainFragment_to_settingFragment, bundle1)
        }
    }
}

SettingFragment

class SettingFragment : Fragment() {
    
    override fun onCreateView(
        inflater: LayoutInflater, container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View? {
        // Inflate the layout for this fragment
        return inflater.inflate(R.layout.fragment_setting, container, false)
    }

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        val bundle = arguments
        if (bundle != null) {
            Log.d("SettingFragment", " username : ${bundle.getString("user_name")}")
            Log.d("SettingFragment", " age : ${bundle.getInt("age")}")

            Log.d("SettingFragment", " username : ${arguments?.let { MainFragmentArgs.fromBundle(it).userName }}")
            Log.d("SettingFragment", " age : ${arguments?.let { MainFragmentArgs.fromBundle(it).age }}")
        }
    }
}

menu_setting.xml

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android">
    <item
        android:id="@+id/mainFragment"
        android:title="主页" />
    <item
        android:id="@+id/settingFragment"
        android:title="设置" />
</menu>

nav_graph.xml

<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/nav_graph"
    app:startDestination="@id/mainFragment">

    <fragment
        android:id="@+id/mainFragment"
        android:name="com.yx.androidseniorprepare.seventh.MainFragment"
        android:label="fragment_main"
        tools:layout="@layout/fragment_main">
        <action
            android:id="@+id/action_mainFragment_to_settingFragment"
            app:destination="@id/settingFragment"
            app:enterAnim="@anim/slide_in_right"
            app:exitAnim="@anim/slide_out_left"
            app:popEnterAnim="@anim/slide_in_left"
            app:popExitAnim="@anim/slide_out_right" />

        <argument
            android:name="user_name"
            android:defaultValue="unknown"
            app:argType="string" />
        <argument
            android:name="age"
            android:defaultValue="0"
            app:argType="integer" />
    </fragment>
    <fragment
        android:id="@+id/settingFragment"
        android:name="com.yx.androidseniorprepare.seventh.SettingFragment"
        android:label="fragment_setting"
        tools:layout="@layout/fragment_setting" />
</navigation>

Paging

Paging组件的意义

分页加载是在应用程序开发过程中十分常见的需求，我们经常需要以列表的形式加载大量的数据，这些数据通常来自网络或本地数据库。若一次加载大量的数据，这些数据消耗大量的时间和数据流量。

[图片上传失败...(image-19ef07-1610060544137)]

然而用户实际需要的可能只是部分数据，因此有了分页加载，分业加载按需加载，在不影响用户体验的同时，还能节省数据流量，提升应用性能。

数据来源

[图片上传失败...(image-8f3c85-1610060544137)]

工作原理

img

在RecyclerView的滑动过程中，会触发PagedListAdapter类中的onBindViewHolder()方法。数据与RecycleView中Item布局的UI控件正是在该方法中进行绑定的。
当RecyclerView滑动到底部时，在onBindViewHolder()方法中所调用的getItem()方法会通知PagedList,当前需要载入更多数据。
接着，PagedList会根据PageList.Config中的配置通知DataSource执行具体的数据获取工作。
DataSource从网络/本地数据库取得数据后，交给PagedList,PagedList将持有这些数据。
PagedList将数据交给PagedListAdapter中的DiffUtil进行比对和处理。
数据在经过处理后，交由RecyclerView进行展示。

Paging的3个核心类

PagedListAdapter:

适配器，RecyclerView的适配器，通过分析数据是否发生了变化，负责处理UI展示的逻辑(增加/删除/替换等)。

PageList:

负责通知DataSource何时获取数据，以及如何获取数据。例如，何时加载第一页/下一页、第一页加载的数量、提前多少条数据开始执行预加载等。需要注意的是，从DataSource获取的数据将存储在PagedList中。

DataSource

数据源，执行具体的数据载入工作。注意：数据的载入需要在工作线程中执行。数据可以来自网络，也可以来自本地数据库，如Room.根据分页机制的不同，Paging为我们提供了3种DataSource。

添加依赖权限

implementation 'com.squareup.retrofit2:retrofit:2.9.0'
implementation 'com.squareup.retrofit2:converter-gson:2.9.0'
implementation 'com.squareup.picasso:picasso:2.71828'
implementation "android.arch.lifecycle:extensions:1.1.1"
implementation 'androidx.paging:paging-runtime-ktx:2.1.2'

 <uses-permission android:name="android.permission.INTERNET" />

3种DataSource

PositionalDataSource

适用于可通过任意位置加载数据，且目标数据源数量固定的情况。例如，若请求时携带的参数为start=2&count=5,则表示向服务端请求从第2条数据开始往后的5条数据。
[图片上传失败...(image-afa103-1610060544137)]
接口：https://gank.io/api/v2/data/category/Girl/type/Girl/page/1/count/10

PageKeyedDataSource

适用于数据源以"页"的方式进行请求的情况。例如，若请求时携带的参数为page=2&pageSize=5,则表示数据源以5条数据为一页，当前返回第二页的5条数据。
[图片上传失败...(image-ab156b-1610060544137)]
接口：https://api.stackexchange.com/2.2/users?page=1&pagesize=6&site=stackoverflow

ItemKeyedDataSource

适用于当目标数据的下一页需要依赖于上一页数据中最后一个对象中的某个字段作为key的情况。此类分页形式常见于评论功能的实现。例如，若上一页数据中最后一个对象的key为9527,那么在请求下一页时，需要携带参数since=9527&pageSize=5,则服务器会返回key=9527之后的5条数据
[图片上传失败...(image-9c9ff7-1610060544137)]
接口： https://api.github.com/users?since=0&per_page=5

PositionalDataSource 使用

创建实体类

data class Users(var page: Int, var page_count: Int, var total_counts: Int, var data: List<User>)

data class User(var _id: String, var author: String, var createdAt: String, var url: String)

创建API接口

interface Api {
    @GET("page/{page}/count/{count}")
    fun getUsers(@Path("page") page:Int,@Path("count") pageSize:Int):Call<Users>
}

创建网络请求框架

object RetrofitClient {
    private const val BASE_URL = "https://gank.io/api/v2/data/category/Girl/type/Girl/"
    private var retrofit: Retrofit? = null

    init {
        retrofit = Retrofit.Builder().baseUrl(BASE_URL).addConverterFactory(GsonConverterFactory.create()).build()
    }

    fun getApi(): Api? {
        return retrofit?.create(Api::class.java)
    }
}

创建UserDataSource继承PositionalDataSource

class UserDataSource : PositionalDataSource<User>() {

    companion object {
        const val PER_PAGE = 10
        var startPosition = 1
    }

    override fun loadInitial(params: LoadInitialParams, callback: LoadInitialCallback<User>) {

        RetrofitClient
            .getApi()?.getUsers(startPosition, PER_PAGE)
            ?.enqueue(object : Callback<Users?> {
                override fun onResponse(call: Call<Users?>, response: Response<Users?>) {
                    if (response.body() != null) {
                        Log.e(
                            "loadInitial()",
                            "startPosition:" + params.requestedStartPosition + " response:" + response.body()
                        )
                        callback.onResult(
                            response.body()!!.data,
                            response.body()!!.page,
                            response.body()!!.total_counts
                        )
                    }
                }

                override fun onFailure(call: Call<Users?>, t: Throwable) {
                    Log.e("loadInitial()", call.toString())
                }
            })
    }

    override fun loadRange(params: LoadRangeParams, callback: LoadRangeCallback<User>) {
        RetrofitClient
            .getApi()?.getUsers(startPosition + 1, PER_PAGE)
            ?.enqueue(object : Callback<Users?> {
                override fun onResponse(call: Call<Users?>, response: Response<Users?>) {
                    if (response.body() != null) {
                        startPosition += 1
                        Log.e(
                            "loadRange()",
                            "startPosition:" + params.startPosition + " response:" + response.body()
                        )
                        callback.onResult(response.body()!!.data)
                    }
                }

                override fun onFailure(call: Call<Users?>, t: Throwable) {
                    Log.e("loadRange()", call.toString())
                }
            })
    }

}

创建UserDataSourceFactory负责创建UserDataSource，并使用LiveData包装UserDataSource讲其暴露给UserViewModel

class UserDataSourceFactory : DataSource.Factory<Int, User>() {
    private val liveDataSource = MutableLiveData<UserDataSource>()
    override fun create(): DataSource<Int, User> {
        val dataSource = UserDataSource()
        liveDataSource.postValue(dataSource)
        return dataSource
    }
}

创建ViewModel

class UserViewModel : ViewModel() {
    var userPagedList: LiveData<PagedList<User>>? = null

    init {
        val config =
            PagedList.Config.Builder() // 是否显示占位。默认为true。当被设置为true时，要求在DataSource中提供数据源的总量，否则会报错。
                // 这是因为RecyclerView需要知道数据总量，为这些数据预留位置
                .setEnablePlaceholders(true)
                //设置每页加载的数量
                .setPageSize(UserDataSource.PER_PAGE)
                //设置距离底部还有多少条数据时加载下一页数据
                .setPrefetchDistance(0)
                //重点，这里需要设置预获取的值>0，否则getKey()和loadBefore()以及loadAfter()不会被调用
                //首次初始化加载的数量，需是分页加载数量的倍数。若没有设置，则默认是PER_PAGE的三倍
                .setInitialLoadSizeHint(UserDataSource.PER_PAGE * 4)
                //好像没有效果
                //设置PagedList所能承受的最大数量，一般来说是PER_PAGE的许多许多倍，超过可能会出现异常。
                .setMaxSize(65536 * UserDataSource.PER_PAGE).build()

        // 通过LivePagedListBuilder创建PagedList
        userPagedList = LivePagedListBuilder(UserDataSourceFactory(), config).build()
    }
    
}

创建PagedListAdapter

class UserAdapter(context: Context) : PagedListAdapter<User, UserAdapter.UserViewHolder>(DIFF_CALLBACK) {
    private var context: Context? = null

    init {
        this.context = context
    }

    companion object {
        /**
         * 用于计算列表中两个非空项之间的差异的回调。
         *
         * 之前数据更新了，需要通过notifyDataSetChanged()通知整个RecyclerView，效率不高
         * 使用DiffUtil只会更新需要更新的Item，不需要刷新整个RecyclerView，并且可以在Item删除的时候加上动画效果
         */
        private val DIFF_CALLBACK: DiffUtil.ItemCallback<User> = object : DiffUtil.ItemCallback<User>() {
            /**
             * 当DiffUtil想要检测两个对象是否代表同一个Item时，调用该方法进行判断
             */
            override fun areItemsTheSame(oldItem: User, newItem: User): Boolean {
                return oldItem._id == newItem._id
            }

            /**
             * 当DiffUtil想要检测两个Item是否有一样的数据时，调用该方法进行判断
             *
             * 内容如果更新了，展示给用户看的东西可能也需要更新，所以需要这个判断
             */
            override fun areContentsTheSame(oldItem: User, newItem: User): Boolean {
                return oldItem == newItem
            }
        }
    }
    
    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): UserViewHolder {
        val view = LayoutInflater.from(context).inflate(R.layout.item_user, parent, false)
        return UserViewHolder(view)
    }

    override fun onBindViewHolder(holder: UserViewHolder, position: Int) {
        val user = getItem(position)
        if (user != null) {
            Picasso.get().load(user.url).placeholder(R.drawable.ic_launcher_background).error(R.drawable.ic_launcher_background).into(holder.ivAvatar)
            holder.tvName.text = user.author + " " + user.createdAt
        } else {
            holder.ivAvatar.setImageResource(R.drawable.ic_launcher_background)
            holder.tvName.text = ""
        }
    }

    class UserViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
        var ivAvatar: ImageView = itemView.findViewById(R.id.iv_Avatar)
        var tvName: TextView = itemView.findViewById(R.id.tv_Name)
    }

}

xml

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:padding="12dp">

    <ImageView
        android:id="@+id/ivAvatar"
        android:layout_width="80dp"
        android:layout_height="80dp"
        android:layout_alignParentLeft="true" />

    <TextView
        android:id="@+id/tvName"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_centerVertical="true"
        android:gravity="left"
        android:layout_marginLeft="12dp"
        android:layout_toRightOf="@+id/ivAvatar"
        android:textSize="24sp" />

</RelativeLayout>

配置Activity

class PositionalDataSourceActivity : AppCompatActivity() {
    val TAG = this.javaClass.simpleName
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_positional_data_source)
        rv_recycler.layoutManager = LinearLayoutManager(this)
        rv_recycler.setHasFixedSize(true)
        val userAdapter = UserAdapter(this)
        val movieViewModel = ViewModelProviders.of(this)[UserViewModel::class.java]
        movieViewModel.userPagedList!!.observe(this, {
            Log.d(TAG, "onChange()->$it")
            userAdapter.submitList(it)
        })
        rv_recycler.adapter = userAdapter
        title = "PositionalDataSourceActivity"
    }
}

效果图
[图片上传失败...(image-896f07-1610060544137)]

PageKeyedDataSource使用

创建实体类

data class User(var account_id: Int, var display_name: String?, var profile_image: String?)
data class UserResponse(var items: List<User>?, var has_more: Boolean?)

创建API接口

interface Api {
    @GET("users")
    fun getUsers(@Query("page") page: Int, @Query("pagesize") pageSize: Int, @Query("site") site: String): Call<UserResponse>
}

创建网络请求框架

object RetrofitClient {
    private const val BASE_URL = "https://api.stackexchange.com/2.2/"
    private var retrofit: Retrofit? = null

    init {
        retrofit = Retrofit.Builder().baseUrl(BASE_URL).addConverterFactory(GsonConverterFactory.create()).build()
    }

    fun getApi(): Api? {
        return retrofit?.create(Api::class.java)
    }
}

创建UserDataSource继承PageKeyedDataSource

class UserDataSource : PageKeyedDataSource<Int, User>() {

    companion object {
        const val FIRST_PAGE = 1
        const val PER_PAGE = 10
        const val SITE = "stackoverflow"
    }

    override fun loadInitial(params: LoadInitialParams<Int>, callback: LoadInitialCallback<Int, User>) {
        RetrofitClient.getApi()?.getUsers(FIRST_PAGE, PER_PAGE, SITE)?.enqueue(object : Callback<UserResponse> {
            override fun onResponse(call: Call<UserResponse>, response: Response<UserResponse>) {
                if (response.body() != null) {
                    Log.e("loadInitial()", " response:" + response.body())
                    response.body()!!.items?.toMutableList()?.let { callback.onResult(it, null, FIRST_PAGE + 1) }

                }
            }

            override fun onFailure(call: Call<UserResponse>, t: Throwable) {
                TODO("Not yet implemented")
            }
        })
    }

    override fun loadBefore(params: LoadParams<Int>, callback: LoadCallback<Int, User>) {

    }

    override fun loadAfter(params: LoadParams<Int>, callback: LoadCallback<Int, User>) {
        Log.e("loadAfter()", "called");
        RetrofitClient.getApi()?.getUsers(params.key, PER_PAGE, SITE)?.enqueue(object : Callback<UserResponse> {
            override fun onResponse(call: Call<UserResponse>, response: Response<UserResponse>) {
                if (response.body() != null) {
                    Log.e("loadAfter()", " response:" + response.body())
                    val nextKey = if (response.body()!!.has_more!!) params.key + 1 else null
                    response.body()!!.items?.let { callback.onResult(it, nextKey) }
                }
            }

            override fun onFailure(call: Call<UserResponse>, t: Throwable) {
                TODO("Not yet implemented")
            }
        })
    }

创建UserDataSourceFactory负责创建UserDataSource，并使用LiveData包装UserDataSource讲其暴露给UserViewModel

class UserDataSourceFactory : DataSource.Factory<Int, User>() {
    private val liveDataSource = MutableLiveData<UserDataSource>()
    override fun create(): DataSource<Int, User> {
        val dataSource = UserDataSource()
        liveDataSource.postValue(dataSource)
        return dataSource
    }
}

创建ViewModel

class UserViewModel : ViewModel() {
    var userPagedList: LiveData<PagedList<User>>? = null

    init {
        val config = PagedList.Config.Builder() // 是否显示占位。默认为true。当被设置为true时，要求在DataSource中提供数据源的总量，否则会报错。
                // 这是因为RecyclerView需要知道数据总量，为这些数据预留位置
                .setEnablePlaceholders(true)
                //设置每页加载的数量
                .setPageSize(UserDataSource.PER_PAGE)
                //设置距离底部还有多少条数据时加载下一页数据
                .setPrefetchDistance(3)
                //重点，这里需要设置预获取的值>0，否则getKey()和loadBefore()以及loadAfter()不会被调用
                //首次初始化加载的数量，需是分页加载数量的倍数。若没有设置，则默认是PER_PAGE的三倍
                .setInitialLoadSizeHint(UserDataSource.PER_PAGE * 3)
                //好像没有效果
                //设置PagedList所能承受的最大数量，一般来说是PER_PAGE的许多许多倍，超过可能会出现异常。
                .setMaxSize(65536 * UserDataSource.PER_PAGE).build()
        // 通过LivePagedListBuilder创建PagedList
        userPagedList = LivePagedListBuilder(UserDataSourceFactory(), config).build()
    }
}

创建PagedListAdapter

class UserAdapter(context: Context) : PagedListAdapter<User, UserAdapter.UserViewHolder>(DIFF_CALLBACK) {
    private var context: Context? = null

    init {
        this.context = context
    }

    companion object {
        /**
         * 用于计算列表中两个非空项之间的差异的回调。
         *
         * 之前数据更新了，需要通过notifyDataSetChanged()通知整个RecyclerView，效率不高
         * 使用DiffUtil只会更新需要更新的Item，不需要刷新整个RecyclerView，并且可以在Item删除的时候加上动画效果
         */
        private val DIFF_CALLBACK: DiffUtil.ItemCallback<User> = object : DiffUtil.ItemCallback<User>() {
            /**
             * 当DiffUtil想要检测两个对象是否代表同一个Item时，调用该方法进行判断
             */
            override fun areItemsTheSame(oldItem: User, newItem: User): Boolean {
                return oldItem.account_id == newItem.account_id
            }

            /**
             * 当DiffUtil想要检测两个Item是否有一样的数据时，调用该方法进行判断
             *
             * 内容如果更新了，展示给用户看的东西可能也需要更新，所以需要这个判断
             */
            override fun areContentsTheSame(oldItem: User, newItem: User): Boolean {
                return oldItem == newItem
            }
        }
    }


    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): UserViewHolder {
        val view = LayoutInflater.from(context).inflate(R.layout.item_user, parent, false)
        return UserViewHolder(view)
    }

    override fun onBindViewHolder(holder: UserViewHolder, position: Int) {
        val user = getItem(position)
        if (user != null) {
            Picasso.get().load(user.profile_image).placeholder(R.drawable.ic_launcher_background).error(R.drawable.ic_launcher_background).into(holder.ivAvatar)
            holder.tvName.text = user.display_name
        } else {
            holder.ivAvatar.setImageResource(R.drawable.ic_launcher_background)
            holder.tvName.text = ""
        }
    }

    class UserViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
        var ivAvatar: ImageView = itemView.findViewById(R.id.iv_Avatar)
        var tvName: TextView = itemView.findViewById(R.id.tv_Name)

    }

}

配置Activity

class PageKeyedDataSourceActivity : AppCompatActivity() {
    val TAG = this.javaClass.simpleName
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_page_keyed_data_source)
        rv_recycler.layoutManager = LinearLayoutManager(this)
        rv_recycler.setHasFixedSize(true)
        val userAdapter = UserAdapter(this)
        val movieViewModel = ViewModelProviders.of(this)[UserViewModel::class.java]
        movieViewModel.userPagedList!!.observe(this, {
            Log.e(TAG, "onChange()->$it")
            userAdapter.submitList(it)
        })
        rv_recycler.adapter = userAdapter
        title = "PageKeyedDataSourceActivity"
    }
}

效果

[图片上传失败...(image-3f5622-1610060544137)]

ItemKeyedDataSource使用

创建实体类

data class User(var id: Int, @SerializedName("login") var name: String?, @SerializedName("avatar_url") var avatar: String?)

创建API接口

interface Api {
    @GET("users")
    fun getUsers(@Query("since") since: Int, @Query("per_page") perPage: Int): Call<List<User>>
}

创建网络请求框架

object RetrofitClient {
    private const val BASE_URL = "https://api.github.com/"
    private var retrofit: Retrofit? = null

    init {
        retrofit = Retrofit.Builder().baseUrl(BASE_URL).addConverterFactory(GsonConverterFactory.create()).build()
    }

    fun getApi(): Api? {
        return retrofit?.create(Api::class.java)
    }
}

创建UserDataSource继承ItemKeyedDataSource

class UserDataSource : ItemKeyedDataSource<Int, User>() {

    companion object {
        const val PER_PAGE = 12
    }

    override fun loadInitial(params: LoadInitialParams<Int>, callback: LoadInitialCallback<User>) {
        Log.e("loadInitial()", "called")
        val since = 0
        RetrofitClient.getApi()?.getUsers(since, PER_PAGE)?.enqueue(object : Callback<List<User>> {
            override fun onResponse(call: Call<List<User>>, response: Response<List<User>>) {
                if (response.body() != null) {
                    Log.e("loadInitial()", " response:" + response.body())
                    callback.onResult(response.body()!!)
                }
            }

            override fun onFailure(call: Call<List<User>>, t: Throwable) {
                TODO("Not yet implemented")
            }

        })
    }

    override fun loadAfter(params: LoadParams<Int>, callback: LoadCallback<User>) {
        Log.e("loadAfter()", "called");

        RetrofitClient.getApi()?.getUsers(params.key, PER_PAGE)?.enqueue(object : Callback<List<User>> {
            override fun onResponse(call: Call<List<User>>, response: Response<List<User>>) {
                if (response.body() != null) {
                    Log.e("loadAfter()", " response:" + response.body())
                    callback.onResult(response.body()!!)
                }
            }

            override fun onFailure(call: Call<List<User>>, t: Throwable) {
                TODO("Not yet implemented")
            }

        })
    }

    override fun loadBefore(params: LoadParams<Int>, callback: LoadCallback<User>) {
        Log.e("loadBefore()", "called")
    }

    override fun getKey(item: User): Int {
        Log.e("getkey()", "called")
        return item.id
    }
}

创建UserDataSourceFactory负责创建UserDataSource，并使用LiveData包装UserDataSource讲其暴露给UserViewModel

class UserDataSourceFactory : DataSource.Factory<Int, User>() {
    private val liveDataSource = MutableLiveData<UserDataSource>()
    override fun create(): DataSource<Int, User> {
        val dataSource = UserDataSource()
        liveDataSource.postValue(dataSource)
        return dataSource
    }
}

创建ViewModel

class UserViewModel : ViewModel() {
    var userPagedList: LiveData<PagedList<User>>? = null

    init {
        val config = PagedList.Config.Builder() // 是否显示占位。默认为true。当被设置为true时，要求在DataSource中提供数据源的总量，否则会报错。
                // 这是因为RecyclerView需要知道数据总量，为这些数据预留位置
                .setEnablePlaceholders(true)
                //设置每页加载的数量
                .setPageSize(UserDataSource.PER_PAGE)
                //设置距离底部还有多少条数据时加载下一页数据
                .setPrefetchDistance(3)
                //重点，这里需要设置预获取的值>0，否则getKey()和loadBefore()以及loadAfter()不会被调用
                //首次初始化加载的数量，需是分页加载数量的倍数。若没有设置，则默认是PER_PAGE的三倍
                .setInitialLoadSizeHint(UserDataSource.PER_PAGE * 3)
                //好像没有效果
                //设置PagedList所能承受的最大数量，一般来说是PER_PAGE的许多许多倍，超过可能会出现异常。
                .setMaxSize(65536 * UserDataSource.PER_PAGE).build()

        // 通过LivePagedListBuilder创建PagedList
        userPagedList = LivePagedListBuilder(UserDataSourceFactory(), config).build()
    }
}

创建PagedListAdapter

class UserAdapter(context: Context) : PagedListAdapter<User, UserAdapter.UserViewHolder>(DIFF_CALLBACK) {
    private var context: Context? = null

    init {
        this.context = context
    }

    companion object {
        /**
         * 用于计算列表中两个非空项之间的差异的回调。
         *
         * 之前数据更新了，需要通过notifyDataSetChanged()通知整个RecyclerView，效率不高
         * 使用DiffUtil只会更新需要更新的Item，不需要刷新整个RecyclerView，并且可以在Item删除的时候加上动画效果
         */
        private val DIFF_CALLBACK: DiffUtil.ItemCallback<User> = object : DiffUtil.ItemCallback<User>() {
            /**
             * 当DiffUtil想要检测两个对象是否代表同一个Item时，调用该方法进行判断
             */
            override fun areItemsTheSame(oldItem: User, newItem: User): Boolean {
                return oldItem.id == newItem.id
            }

            /**
             * 当DiffUtil想要检测两个Item是否有一样的数据时，调用该方法进行判断
             *
             * 内容如果更新了，展示给用户看的东西可能也需要更新，所以需要这个判断
             */
            override fun areContentsTheSame(oldItem: User, newItem: User): Boolean {
                return oldItem == newItem
            }
        }
    }


    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): UserViewHolder {
        val view = LayoutInflater.from(context).inflate(R.layout.item_user, parent, false)
        return UserViewHolder(view)
    }

    override fun onBindViewHolder(holder: UserViewHolder, position: Int) {
        val user = getItem(position)
        if (user != null) {
            Picasso.get().load(user.avatar).placeholder(R.drawable.ic_launcher_background).error(R.drawable.ic_launcher_background).into(holder.ivAvatar)
            holder.tvName.text = user.name
        } else {
            holder.ivAvatar.setImageResource(R.drawable.ic_launcher_background)
            holder.tvName.text = ""
        }
    }

    class UserViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
        var ivAvatar: ImageView = itemView.findViewById(R.id.iv_Avatar)
        var tvName: TextView = itemView.findViewById(R.id.tv_Name)

    }

}

配置Activity

class ItemKeyedDataSourceActivity : AppCompatActivity() {
    val TAG = this.javaClass.simpleName
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_item_keyed_data_source)
        rv_recycler.layoutManager = LinearLayoutManager(this)
        rv_recycler.setHasFixedSize(true)
        val userAdapter = UserAdapter(this)
        val movieViewModel = ViewModelProviders.of(this)[UserViewModel::class.java]
        movieViewModel.userPagedList!!.observe(this, {
            Log.e(TAG, "onChange()->$it")
            userAdapter.submitList(it)
        })
        rv_recycler.adapter = userAdapter
        title = "ItemKeyedDataSourceActivity"
    }
}

效果
[图片上传失败...(image-f7efec-1610060544137)]

项目代码
 项目视频

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 194,242评论 5赞 459
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 81,769评论 2赞 371
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 141,484评论 0赞 319
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 52,133评论 1赞 263
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 61,007评论 4赞 355
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 46,080评论 1赞 272
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 36,496评论 3赞 381
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 35,190评论 0赞 253
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 39,464评论 1赞 290
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 34,549评论 2赞 309
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 36,330评论 1赞 326
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 32,205评论 3赞 312
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 37,567评论 3赞 298
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 28,889评论 0赞 17
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 30,160评论 1赞 250
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 41,475评论 2赞 341
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 40,650评论 2赞 335

四篇文章带你快速入门Jetpck（终）之Navigation，Paging

四篇文章带你快速入门Jetpck（终）之Navigation，Paging

Jetpack

官方推荐架构

Navigation

Navigation的诞生

Navigation 的优点

添加依赖库

创建Navigation

Fragment传递参数

常见的传递参数的方式

使用sate Arg传递参数

NacvigationUI的使用

actionBar

DrawLayout + NavigationView 抽屉菜单

ButtomNavigationView 底部菜单

示例

Paging

Paging组件的意义

数据来源

工作原理

Paging的3个核心类

添加依赖权限

3种DataSource

PositionalDataSource

PageKeyedDataSource

ItemKeyedDataSource

PositionalDataSource 使用

PageKeyedDataSource使用

ItemKeyedDataSource使用

推荐阅读更多精彩内容