![\"\"](\"https:\/\/www.oneclickitsolution.com\/blog\/wp-content\/uploads\/2022\/01\/Adopting-Paging-3-android-in-your-app.png\")
<\/a><\/figure>\n\n\n\nFeatures of Paging 3<\/h2>\n\n\n\n
Paging 3 library comes with the latest features that might cover all the scenarios of listing the data in any format like (Listview, Recyclerview, GridView etc ..)<\/p>\n\n\n\n
- \n
- Support live data<\/li>\n\n\n\n
- Paging 3 library support coroutine flow<\/li>\n\n\n\n
- List separators (Decoration with Item )<\/li>\n<\/ul>\n\n\n\n
Implement Paging 3 Library in Android Kotlin<\/h2>\n\n\n\n
The below process will guide you that how to implement Paging 3 in your
application.<\/p>\n\n\n\n![\"Implement](\"https:\/\/www.oneclickitsolution.com\/blog\/wp-content\/uploads\/2022\/01\/Implement-Paging-3-Library-in-Android-Kotlin-1.png\")
<\/figure>\n\n\n\nStep 1: Implementation of Library into Project:<\/h3>\n\n\n\n
You have to implement this library in the Build.gradle<\/strong> folder.<\/p>\n\n\n\n
implementation \"androidx.paging:paging-runtime-ktx:3.1.0-beta01\" <\/code><\/pre>\n\n\n\nStep 2: Generating Data Models<\/h3>\n\n\n\n
The data resource class helps you to get data and retrieve data from the network. This means the network will provide some data and we have to store it in some class which is called data class.<\/p>\n\n\n\n
PassengerListResponse<\/strong><\/p>\n\n\n\n
@Parcelize\ndata class PassengerListResponse(\n @SerializedName(\"totalPassengers\") val totalPassengers: Int,\n @SerializedName(\"totalPages\") val totalPages: Int,\n @SerializedName(\"data\") val passengerList: List<Passenger>\n) : Parcelable\n\n@Parcelize\ndata class Passenger(\n @SerializedName(\"_id\") val id: String,\n @SerializedName(\"name\") val name: String,\n @SerializedName(\"trips\") val trips: Int,\n @SerializedName(\"__v\") val visits: Int\n) : Parcelable<\/code><\/pre>\n\n\n\nAs You see PassengerListResponse<\/strong> class, we have several elements that will be available on the network side with the name of the data.<\/p>\n\n\n\n
Step 3: Integrate Source File<\/h3>\n\n\n\n
We need to create a Datasource class which help you to retrieve data from the services and it looks like as mentioned below :<\/p>\n\n\n\n
class PassengerItemDataSource(\n private val dataRepository: DataRepository\n) : PagingSource<Int, Passenger>() {\n\n\n companion object {\n private const val STARTING_PAGE_INDEX = 1\n }\n\n override suspend fun load(params: LoadParams<Int>): LoadResult<Int, Passenger> {\n val position = params.key ?: STARTING_PAGE_INDEX\n\n \/\/Retrofit will automatically make suspend functions main-safe so you can call them directly from Dispatchers.Main\n return when (val result = dataRepository.getPassengerListForPage(position, params.loadSize)) {\n is Resource.Failure -> LoadResult.Error(Exception(result.message))\n is Resource.Loading -> LoadResult.Error(Exception())\n is Resource.Success -> {\n LoadResult.Page(\n data = result.data.passengerList,\n prevKey = if (position == STARTING_PAGE_INDEX) null else position - 1,\n nextKey = if (result.data.passengerList.isEmpty()) null else position + 1\n )\n }\n }\n }\n\n override fun getRefreshKey(state: PagingState<Int, Passenger>): Int? {\n \/\/ We need to get the previous key (or next key if previous is null) of the page\n \/\/ that was closest to the most recently accessed index.\n \/\/ Anchor position is the most recently accessed index\n return state.anchorPosition?.let { anchorPosition ->\n state.closestPageToPosition(anchorPosition)?.prevKey?.plus(1)\n ?: state.closestPageToPosition(anchorPosition)?.nextKey?.minus(1)\n }\n }\n}\n<\/code><\/pre>\n\n\n\nStep 4: Develop Data Source Factory<\/h3>\n\n\n\n
After creating the Datasource class, you need to implement Data Source Factory.<\/p>\n\n\n\n
The data source Factory class is used to create data sources from the network.<\/p>\n\n\n\n
class PassengerDataSourceFactory(private val dataRepository: DataRepository)\n{\n fun getPassengers()=Pager(\n config = PagingConfig(\n pageSize = NETWORK_PAGE_SIZE,\n enablePlaceholders = false\n ),\n pagingSourceFactory = { PassengerItemDataSource(dataRepository) }\n ).liveData\n}\n<\/code><\/pre>\n\n\n\nAfter creating the Data sources factory, we need to create one adapter class where we can display the list of data.<\/p>\n\n\n\n
Step 5: Create List Adapter Class<\/h3>\n\n\n\n
The list adapter class provides the default implementation of listener interfaces<\/em><\/strong>. If you inherit the adapter class, you will not be provided with the implementation of all the methods of listener interfaces so it saves codes.<\/p>\n\n\n\n
PasangerListAdapter:<\/strong><\/p>\n\n\n\n
class PassengerListAdapter :\n PagingDataAdapter<Passenger, PassengerListAdapter.PassengerViewHolder>(PassengerListDiffCallback()) {\n\n override fun onCreateViewHolder(\n parent: ViewGroup,\n viewType: Int\n ): PassengerViewHolder {\n val inflater = LayoutInflater.from(parent.context)\n val binding = RawPassengerItemBinding.inflate(inflater)\n return PassengerViewHolder(binding)\n }\n\n override fun onBindViewHolder(\n holder: PassengerViewHolder,\n position: Int\n ) {\n val item: Passenger? = getItem(position)\n item?.let {\n holder.bind(item)\n }\n }\n\n override fun onBindViewHolder(\n holder: PassengerViewHolder,\n position: Int,\n payloads: MutableList<Any>\n ) {\n if (payloads.isNullOrEmpty()) {\n super.onBindViewHolder(holder, position, payloads)\n } else {\n val newItem = payloads[0] as Passenger\n holder.bind(newItem)\n }\n }\n\n inner class PassengerViewHolder(private val rawPassengerItemBinding: RawPassengerItemBinding) :\n RecyclerView.ViewHolder(rawPassengerItemBinding.root) {\n\n fun bind(passenger: Passenger) {\n rawPassengerItemBinding.passenger = passenger\n }\n }\n\n class PassengerListDiffCallback : DiffUtil.ItemCallback<Passenger>() {\n override fun areItemsTheSame(oldItem: Passenger, newItem: Passenger) =\n oldItem.id == newItem.id\n\n override fun areContentsTheSame(\n oldItem: Passenger,\n newItem: Passenger\n ) = oldItem == newItem\n\n override fun getChangePayload(oldItem: Passenger, newItem: Passenger): Any? {\n if (oldItem != newItem) {\n return newItem\n }\n\n return super.getChangePayload(oldItem, newItem)\n }\n }\n}\n<\/code><\/pre>\n\n\n\nIn this adapter class, we have some override method which is used to set our raw items.<\/p>\n\n\n\n
Override Method Of Adapter:<\/h4>\n\n\n\n
1. OnCreateViewHolder()
2. onBindViewHolder()
3. And ViewHolder Class ()<\/p>\n\n\n\nThe below code describes how to create an adapter class.<\/strong><\/p>\n\n\n\n
class PassengerListAdapter :\n PagingDataAdapter<Passenger, PassengerListAdapter.PassengerViewHolder>(PassengerListDiffCallback()) {\n\n override fun onCreateViewHolder(\n parent: ViewGroup,\n viewType: Int\n ): PassengerViewHolder {\n val inflater = LayoutInflater.from(parent.context)\n val binding = RawPassengerItemBinding.inflate(inflater)\n return PassengerViewHolder(binding)\n }\n\n override fun onBindViewHolder(\n holder: PassengerViewHolder,\n position: Int\n ) {\n val item: Passenger? = getItem(position)\n item?.let {\n holder.bind(item)\n }\n }\n\n override fun onBindViewHolder(\n holder: PassengerViewHolder,\n position: Int,\n payloads: MutableList<Any>\n ) {\n if (payloads.isNullOrEmpty()) {\n super.onBindViewHolder(holder, position, payloads)\n } else {\n val newItem = payloads[0] as Passenger\n holder.bind(newItem)\n }\n }\n\n inner class PassengerViewHolder(private val rawPassengerItemBinding: RawPassengerItemBinding) :\n RecyclerView.ViewHolder(rawPassengerItemBinding.root) {\n\n fun bind(passenger: Passenger) {\n rawPassengerItemBinding.passenger = passenger\n }\n }\n\n class PassengerListDiffCallback : DiffUtil.ItemCallback<Passenger>() {\n override fun areItemsTheSame(oldItem: Passenger, newItem: Passenger) =\n oldItem.id == newItem.id\n\n override fun areContentsTheSame(\n oldItem: Passenger,\n newItem: Passenger\n ) = oldItem == newItem\n\n override fun getChangePayload(oldItem: Passenger, newItem: Passenger): Any? {\n if (oldItem != newItem) {\n return newItem\n }\n\n return super.getChangePayload(oldItem, newItem)\n }\n }\n}\n<\/code><\/pre>\n\n\n\nStep 6: Loading Adapter in fragment or Activity<\/h3>\n\n\n\n
This code is Used how to access pagination in our activity or fragment<\/p>\n\n\n\n
passengerListAdapter.addLoadStateListener { loadState ->\n when (val state = loadState.source.refresh) {\n is LoadState.NotLoading -> {\n \/**\n * Setting up the views as per your requirement\n *\/\n }\n is LoadState.Loading -> {\n \/**\n * Setting up the views as per your requirement\n *\/\n \n }\n is LoadState.Error -> {\n \/**\n * Setting up the views as per your requirement\n *\/\n \n Youractivity?.showMessage(state.error.message.orEmpty())\n }\n }\n}\n<\/code><\/pre>\n\n\n\nExample of Pagination<\/h5>\n\n\n\n
![\"Example](\"https:\/\/www.oneclickitsolution.com\/blog\/wp-content\/uploads\/2022\/01\/Example-of-Pagination.png\")
<\/figure>\n\n\n\nConclusion<\/h2>\n\n\n\n
To conclude, Pagination 3 is widely used in most applications where there is a list of data available in the android application<\/a><\/strong>. Implementation of pagination provides an efficient user experience. Paging 3 also enables developers<\/a><\/strong> to implement pagination with ease and better accuracy.<\/p>\n\n\n\n
We hope you have enjoyed reading this article and found it helpful. Good Luck with your implementation of Pagination using the Paging 3 library in Android.<\/p>\n\n\n\n
![\"Android](\"https:\/\/www.oneclickitsolution.com\/blog\/wp-content\/uploads\/2021\/12\/Android-Custom-Library-CTA1.png\")
<\/a><\/figure>\n\n\n\nFAQ<\/h2>\n\n\n\n
1. Why do we use the paging 3 library for pagination?<\/h4>\n\n\n\n
We can use the paging 3 library for pagination. Because it provides first-class Kotlin support to handle easy or complex data operations like data loading from network, database or combination of different data sources. And the paging 3 library can also support Kotlin coroutine flow.<\/p>\n\n\n\n
2. Can we use the Paging 3 Library in Java?<\/h4>\n\n\n\n
Yes, We can use the paging 3 Library in java as well.<\/p>\n\n\n\n