Обзор библиотеки Paging   Входит в Android Jetpack.

Библиотека Paging помогает загружать и отображать страницы данных из большого набора данных из локального хранилища или по сети. Это позволяет более эффективно использовать пропускную способность сети и системные ресурсы. Компоненты библиотеки Paging разработаны с учетом рекомендуемой архитектуры приложений Android, легко интегрируются с другими компонентами Jetpack и обеспечивают первоклассную поддержку Kotlin.

Преимущества библиотеки Paging

Библиотека Paging включает следующие функции:

• Кеширование в памяти для постраничных данных. Это помогает обеспечить эффективное использование системных ресурсов при работе с постраничными данными.
• Встроенная дедупликация запросов, которая помогает обеспечить эффективное использование пропускной способности сети и системных ресурсов.
• Первоклассная поддержка сопрограмм и потоков Kotlin.
• Встроенная поддержка обработки ошибок, включая возможности обновления и повторной попытки.

Настроить

Чтобы импортировать компоненты Paging в приложение для Android, добавьте в файл build.gradle следующие зависимости:

dependencies {
  val paging_version = "3.4.2"

  implementation("androidx.paging:paging-common:$paging_version")

  // Jetpack Compose integration
  implementation("androidx.paging:paging-compose:$paging_version")
}

dependencies {
  def paging_version = "3.4.2"

  implementation "androidx.paging:paging-common:$paging_version"

  // Jetpack Compose integration
  implementation "androidx.paging:paging-compose:$paging_version"
}

Архитектура библиотеки

Компоненты библиотеки Paging работают на трех уровнях приложения:

• Уровень репозитория
• Слой ViewModel
• Слой пользовательского интерфейса

В этом разделе описываются компоненты библиотеки Paging, которые работают на каждом уровне, и то, как они работают вместе для загрузки и отображения постраничных данных.

Слой репозитория

Основной компонент библиотеки Paging на уровне репозитория – PagingSource. Каждый объект PagingSource определяет источник данных и способ получения данных из этого источника. Объект PagingSource может загружать данные из любого источника, включая сетевые источники и локальные базы данных.

Ещё один компонент библиотеки Paging, который вы можете использовать, – RemoteMediator. Объект RemoteMediator обрабатывает разбиение на страницы из многоуровневого источника данных, например сетевого источника данных с локальным кэшем базы данных.

Слой ViewModel

Компонент Pager предоставляет общедоступный API для создания экземпляров PagingData, которые представлены в реактивных потоках, на основе объекта PagingSource и объекта конфигурации PagingConfig.

Компонент, который соединяет слой ViewModel с интерфейсом, – это PagingData. Объект PagingData – это контейнер для снимка данных с разбивкой по страницам. Он запрашивает объект PagingSource и сохраняет результат.

Уровень интерфейса

Основной API пользовательского интерфейса Paging – collectAsLazyPagingItems(). Она предоставляет элементы страниц в виде списка данных, который можно легко использовать в компонентах ленивого макета Compose, таких как LazyColumn и LazyRow.

Добавьте библиотеку androidx.paging:paging-compose, чтобы использовать API, совместимые с Compose. Они позволяют интерфейсу автоматически реагировать на загрузку данных, обновления и ошибки без необходимости использовать адаптеры или логику сравнения. Используйте функцию расширения collectAsLazyPagingItems() для Flow<PagingData>, чтобы передать возвращенный LazyPagingItems в items() в LazyColumn.

@Composable
fun MessageList(pager: Pager<Int, Message>) {
    val lazyPagingItems = pager.flow.collectAsLazyPagingItems()

    LazyColumn {
        items(
            lazyPagingItems.itemCount,
            key = lazyPagingItems.itemKey { it.id }
        ) { index ->
            val message = lazyPagingItems[index]
            if (message != null) {
                MessageRow(message)
            } else {
                MessagePlaceholder()
            }
        }
    }
}
LazyListSnippets.kt

Подробнее о больших наборах данных (разбиение на страницы)…