DittoQueryResultItem

Represents a single match of a DQL query, similar to a "row" in SQL terms. It's a reference type serving as a "cursor", allowing for efficient access of the underlying data in various formats.

The value property is lazily materialized and kept in memory until it goes out of scope. To reduce the memory footprint, structure your code such that items can be processed as a stream, i.e. one by one (or in batches) and dematerialize them right after use:

val cars = allCarsQueryResult.items.map { item ->
    // Pull out relevant data:
    val model = item.value["model"] as String
    val mileage = item.value["mileage"] as Int

    // Prune to free memory:
    item.dematerialize()

    // Use the pulled out data:
    return Car(model = model, mileage = mileage)
}

Pulling the contents out of a map can be cumbersome in Kotlin, especially if your data is deeply nested. Consider defining a data class describing the shape of your data, then decoding jsonString using Kotlin Serialization:

@Serializable
data class Car(
    val model: String
    val mileage: Int
)

val jsonString = item.jsonString()
val car = Json {
    isLenient = true
    ignoreUnknownKeys = true
    allowStructuredMapKeys = true
}.decodeFromString<Car>(jsonString)