spotify-api-kotlin/com.adamratzman.spotify.models/AbstractPagingObject

AbstractPagingObject

@Serializable

abstract class AbstractPagingObject<T : Any, Z : AbstractPagingObject<T, Z>> : PagingObjectBase<T, Z> , List<T?> (source)

The offset-based paging object is a container for a set of objects. It contains a key called items (whose value is an array of the requested objects) along with other keys like previous, next and limit that can be useful in future calls.

Inheritors

NullablePagingObject

PagingObject

Constructors

AbstractPagingObject

constructor()

Properties

api

@Transient

lateinit var api: GenericSpotifyApi

The API client associated with the request

href

abstract val href: String

A link to the Web API endpoint returning the full result of the request.

items

abstract val items: List<T?>

The requested data.

limit

abstract val limit: Int

The maximum number of items in the response (as set in the query or by default).

abstract val next: String?

URL to the next page of items. ( null if none)

offset

abstract val offset: Int

The offset of the items returned (as set in the query or by default).

abstract val previous: String?

URL to the previous page of items. ( null if none)

size

open override val size: Int

total

abstract val total: Int

The maximum number of items available to return.

Functions

contains

open operator override fun contains(element: T?): Boolean

containsAll

open override fun containsAll(elements: Collection<T?>): Boolean

flow

@FlowPreview

@ExperimentalCoroutinesApi

fun flow(context: CoroutineContext = Dispatchers.Default): Flow<T?>

Flow the Paging action.

flowBackward

fun flowBackward(): Flow<Z>

Flow from current page backwards.

flowEndOrdered

@ExperimentalCoroutinesApi

fun flowEndOrdered(): Flow<Z>

flowForward

@ExperimentalCoroutinesApi

fun flowForward(): Flow<Z>

Flow from current page forwards.

flowOrdered

@FlowPreview

@ExperimentalCoroutinesApi

fun flowOrdered(context: CoroutineContext = Dispatchers.Default): Flow<T?>

Flow the paging action ordered. This can be less performant than flow if you are in the middle of the pages.

flowPagingObjects

@ExperimentalCoroutinesApi

fun flowPagingObjects(context: CoroutineContext = Dispatchers.Default): Flow<Z>

Flow the paging objects.

flowPagingObjectsOrdered

@ExperimentalCoroutinesApi

fun flowPagingObjectsOrdered(context: CoroutineContext = Dispatchers.Default): Flow<Z>

Flow the paging objects ordered. This can be less performant than flowPagingObjects if you are in the middle of the pages.

flowStartOrdered

@ExperimentalCoroutinesApi

fun flowStartOrdered(): Flow<Z>

get

open operator override fun get(index: Int): T?

getAllItems

open suspend override fun getAllItems(): List<T?>

Get all items of type T associated with the request

getAllItemsNotNull

suspend fun getAllItemsNotNull(): List<T>

Get all items of type T associated with the request. Filters out null objects.

getAllItemsNotNullRestAction

fun getAllItemsNotNullRestAction(): SpotifyRestAction<List<T>>

Get all items of type T associated with the request. Filters out null objects.

getAllItemsRestAction

fun getAllItemsRestAction(): SpotifyRestAction<List<T?>>

Retrieve all T associated with this rest action

getAllPagingObjects

open suspend override fun getAllPagingObjects(): List<Z>

Retrieve all PagingObjectBase associated with this rest action

getAllPagingObjectsRestAction

fun getAllPagingObjectsRestAction(): SpotifyRestAction<List<Z>>

Retrieve all PagingObjectBase associated with this rest action

getNext

suspend fun getNext(): Z?

getNextRestAction

fun getNextRestAction(): SpotifyRestAction<Z?>

getPrevious

suspend fun getPrevious(): Z?

getPreviousRestAction

fun getPreviousRestAction(): SpotifyRestAction<Z?>

getWithNext

suspend fun getWithNext(total: Int): List<Z>

Synchronously retrieve the next total paging objects associated with this AbstractPagingObject, including this AbstractPagingObject.

getWithNextItems

suspend fun getWithNextItems(total: Int): List<T?>

Retrieve the items associated with the next total paging objects associated with this rest action, including the current one.

getWithNextItemsRestAction

fun getWithNextItemsRestAction(total: Int): SpotifyRestAction<List<T?>>

Retrieve the items associated with the next total paging objects associated with this rest action, including the current one.

getWithNextTotalPagingObjects

open suspend override fun getWithNextTotalPagingObjects(total: Int): List<Z>

Synchronously retrieve the next total paging objects associated with this PagingObjectBase, including this PagingObjectBase.

getWithNextTotalPagingObjectsRestAction

fun getWithNextTotalPagingObjectsRestAction(total: Int): SpotifyRestAction<List<Z>>

Synchronously retrieve the next total paging objects associated with this PagingObjectBase, including this PagingObjectBase.

indexOf

open override fun indexOf(element: T?): Int

isEmpty

open override fun isEmpty(): Boolean

iterator

abstract operator override fun iterator(): Iterator<T?>

lastIndexOf

open override fun lastIndexOf(element: T?): Int

listIterator

abstract fun listIterator(): ListIterator<T?>

abstract fun listIterator(index: Int): ListIterator<T?>

subList

abstract fun subList(fromIndex: Int, toIndex: Int): List<T?>

take

open suspend fun take(n: Int): List<T?>

Returns a list containing at most first n elements. Note that additional requests may be performed. The limit used in the request used to produce this PagingObjectBase will be respected, so choose limit carefully.