retrostash-core/dev.logickoder.retrostash.core/QueryMetadata

QueryMetadata

data class QueryMetadata(val scopeName: String, val template: String, val bindings: Map<String, String> = emptyMap(), val bodyBytes: ByteArray? = null, val tagTemplates: List<String> = emptyList())

Transport-agnostic description of a single query call, sufficient for CoreKeyResolver to derive a stable cache key.

Constructors

QueryMetadata

constructor(scopeName: String, template: String, bindings: Map<String, String> = emptyMap(), bodyBytes: ByteArray? = null, tagTemplates: List<String> = emptyList())

Properties

bindings

val bindings: Map<String, String>

Already-known placeholder values (typically extracted from @Path / @Query parameters by the transport adapter).

bodyBytes

val bodyBytes: ByteArray?

Raw request body, used as a fallback source for placeholders not present in bindings — looked up via Utf8JsonLookup.

scopeName

val scopeName: String

Logical namespace — usually the API interface simple name (e.g. "UserApi"). Prevents key collisions between unrelated APIs sharing template shapes.

tagTemplates

val tagTemplates: List<String>

Optional list of tag templates (same {placeholder} syntax as template) resolved against bindings / bodyBytes at cache-write time. The resolved tag values are persisted with the entry and matched by RetrostashStore.invalidateTag.

template

val template: String

Cache template with {placeholder} syntax (e.g. "users/{id}").

Functions

equals

open operator override fun equals(other: Any?): Boolean

hashCode

open override fun hashCode(): Int