PositionalDataSource

Kotlin |Java

abstract class PositionalDataSource<T : Any> : DataSource<Int, T>

kotlin.Any
↳	androidx.paging.DataSource<kotlin.Int, T>
	↳	androidx.paging.PositionalDataSource

Position-based data loader for a fixed-size, countable data set, supporting fixed-size loads at arbitrary page positions.

Extend PositionalDataSource if you can load pages of a requested size at arbitrary positions, and provide a fixed item count. If your data source can't support loading arbitrary requested page sizes (e.g. when network page size constraints are only known at runtime), either use PageKeyedDataSource or ItemKeyedDataSource, or pass the initial result with the two parameter LoadInitialCallback.onResult.

Room can generate a Factory of PositionalDataSources for you:

@Dao
interface UserDao {
    @Query("SELECT * FROM user ORDER BY age DESC")
    public abstract DataSource.Factory<Integer, User> loadUsersByAgeDesc();
}

Summary

Nested classes
abstract	`LoadInitialCallback` Callback for loadInitial to return data, position, and count.
open	`LoadInitialParams` Holder object for inputs to loadInitial.
abstract	`LoadRangeCallback` Callback for PositionalDataSource loadRange to return data.
open	`LoadRangeParams` Holder object for inputs to loadRange.

Public constructors
`<init>()` Position-based data loader for a fixed-size, countable data set, supporting fixed-size loads at arbitrary page positions.

Public methods
abstract Unit	`loadInitial(params: PositionalDataSource.LoadInitialParams, callback: PositionalDataSource.LoadInitialCallback<T>)` Load initial list data.
abstract Unit	`loadRange(params: PositionalDataSource.LoadRangeParams, callback: PositionalDataSource.LoadRangeCallback<T>)` Called to load a range of data from the DataSource.
PositionalDataSource<V>	`map(function: Function<T, V>)` Applies the given function to each value emitted by the DataSource.
PositionalDataSource<V>	`map(function: (T) -> V)` Applies the given function to each value emitted by the DataSource.
PositionalDataSource<V>	`mapByPage(function: Function<List<T>, List<V>>)` Applies the given function to each value emitted by the DataSource.
PositionalDataSource<V>	`mapByPage(function: (List<T>) -> List<V>)` Applies the given function to each value emitted by the DataSource.

Inherited functions

From class DataSource

`Unit`	`<no name provided>()` Invalidation callback for DataSource. Used to signal when a DataSource a data source has become invalid, and that a new data source is needed to continue loading data.
`Unit`	`addInvalidatedCallback(onInvalidatedCallback: DataSource.InvalidatedCallback)` Add a callback to invoke when the DataSource is first invalidated. Once invalidated, a data source will not become valid again. A data source will only invoke its callbacks once - the first time invalidate is called, on that thread.
`Unit`	`invalidate()` Signal the data source to stop loading, and notify its callback. If invalidate has already been called, this method does nothing.
`Unit`	`removeInvalidatedCallback(onInvalidatedCallback: DataSource.InvalidatedCallback)` Remove a previously added invalidate callback.

Inherited properties

From class DataSource

Boolean

isInvalid

Public constructors

<init>

PositionalDataSource()

Position-based data loader for a fixed-size, countable data set, supporting fixed-size loads at arbitrary page positions.

Room can generate a Factory of PositionalDataSources for you:

@Dao
interface UserDao {
    @Query("SELECT * FROM user ORDER BY age DESC")
    public abstract DataSource.Factory<Integer, User> loadUsersByAgeDesc();
}

Parameters
`T`	Type of items being loaded by the PositionalDataSource.

Public methods

loadInitial

@WorkerThread abstract fun loadInitial(
    params: PositionalDataSource.LoadInitialParams, 
    callback: PositionalDataSource.LoadInitialCallback<T>
): Unit

Load initial list data.

This method is called to load the initial page(s) from the DataSource.

LoadResult list must be a multiple of pageS