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

PagingObject

@Serializable

data class PagingObject<T : Any>(val href: String, val items: List<T>, val limit: Int, val next: String? = null, val offset: Int, val previous: String? = null, val total: Int = 0) : AbstractPagingObject<T, PagingObject<T>> (source)

The offset-based non-nullable 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.

Constructors

PagingObject

constructor(href: String, items: List<T>, limit: Int, next: String? = null, offset: Int, previous: String? = null, total: Int = 0)

Properties

api

@Transient

lateinit var api: GenericSpotifyApi

The API client associated with the request

href

open override val href: String

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

items

open override val items: List<T>

The requested data.

limit

open override val limit: Int

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

open override val next: String? = null

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

offset

open override val offset: Int

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

open override val previous: String? = null

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

size

open override val size: Int

total

open override val total: Int = 0

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<PagingObject<T>>

Flow from current page backwards.

flowEndOrdered

@ExperimentalCoroutinesApi

fun flowEndOrdered(): Flow<PagingObject<T>>

flowForward

@ExperimentalCoroutinesApi

fun flowForward(): Flow<PagingObject<T>>

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<PagingObject<T>>

Flow the paging objects.

flowPagingObjectsOrdered

@ExperimentalCoroutinesApi

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

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<PagingObject<T>>

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<PagingObject<T>>

Retrieve all PagingObjectBase associated with this rest action

getAllPagingObjectsRestAction

fun getAllPagingObjectsRestAction(): SpotifyRestAction<List<PagingObject<T>>>

Retrieve all PagingObjectBase associated with this rest action

getNext

suspend fun getNext(): PagingObject<T>?

getNextRestAction

fun getNextRestAction(): SpotifyRestAction<PagingObject<T>?>

getPrevious

suspend fun getPrevious(): PagingObject<T>?

getPreviousRestAction

fun getPreviousRestAction(): SpotifyRestAction<PagingObject<T>?>

getWithNext

suspend fun getWithNext(total: Int): List<PagingObject<T>>

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<PagingObject<T>>

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

getWithNextTotalPagingObjectsRestAction

fun getWithNextTotalPagingObjectsRestAction(total: Int): SpotifyRestAction<List<PagingObject<T>>>

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

open operator override fun iterator(): Iterator<T>

lastIndexOf

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

listIterator

open override fun listIterator(): ListIterator<T>

open override fun listIterator(index: Int): ListIterator<T>

subList

open override fun subList(fromIndex: Int, toIndex: Int): List<T>

take

open suspend override 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.