kotlin-client/com.couchbase.client.kotlin/Collection

Collection

Operations that act on a Couchbase collection.

Functions

counter

fun counter(documentId: String, common: CommonOptions = CommonOptions.Default, durability: Durability = Durability.disabled(), expiry: Expiry = Expiry.none()): Counter

Returns a counter backed by a document on the server.

exists

suspend fun exists(id: String, common: CommonOptions = CommonOptions.Default): ExistsResult

get

suspend fun get(id: String, common: CommonOptions = CommonOptions.Default, withExpiry: Boolean = false, project: List<String> = emptyList()): GetResult

Gets a document from this collection.

getAllReplicas

fun getAllReplicas(id: String, common: CommonOptions = CommonOptions.Default): Flow<GetReplicaResult>

getAndLock

suspend fun getAndLock(id: String, lockTime: Duration, common: CommonOptions = CommonOptions.Default): GetResult

getAndTouch

suspend fun getAndTouch(id: String, expiry: Expiry, common: CommonOptions = CommonOptions.Default): GetResult

getAnyReplica

suspend fun getAnyReplica(id: String, common: CommonOptions = CommonOptions.Default): GetReplicaResult

getAnyReplicaOrNull

suspend fun getAnyReplicaOrNull(id: String, common: CommonOptions = CommonOptions.Default): GetReplicaResult?

Like getAnyReplica, but returns null instead of throwing DocumentUnretrievableException if the document was not found.

getOrNull

inline suspend fun getOrNull(id: String, common: CommonOptions = CommonOptions.Default, withExpiry: Boolean = false, project: List<String> = emptyList()): GetResult?

Like get, but returns null instead of throwing DocumentNotFoundException if the document is not found.

insert

inline suspend fun <T> insert(id: String, content: T, common: CommonOptions = CommonOptions.Default, transcoder: Transcoder? = null, durability: Durability = Durability.disabled(), expiry: Expiry = Expiry.None): MutationResult

lookupIn

suspend fun lookupIn(id: String, spec: LookupInSpec, common: CommonOptions = CommonOptions.Default, accessDeleted: Boolean = false): LookupInResult

inline suspend fun <T, L : LookupInSpec> lookupIn(id: String, spec: L, common: CommonOptions = CommonOptions.Default, accessDeleted: Boolean = false, block: LookupInResult.() -> T): T

Retrieves specific fields of a document.

mutateIn

suspend fun mutateIn(id: String, common: CommonOptions = CommonOptions.Default, expiry: Expiry = Expiry.none(), preserveExpiry: Boolean = false, durability: Durability = Durability.disabled(), storeSemantics: StoreSemantics = StoreSemantics.replace(), serializer: JsonSerializer? = null, accessDeleted: Boolean = false, createAsDeleted: Boolean = false, block: MutateInSpec.() -> Unit): MutateInResult

suspend fun mutateIn(id: String, spec: MutateInSpec, common: CommonOptions = CommonOptions.Default, expiry: Expiry = Expiry.none(), preserveExpiry: Boolean = false, durability: Durability = Durability.disabled(), storeSemantics: StoreSemantics = StoreSemantics.replace(), serializer: JsonSerializer? = null, accessDeleted: Boolean = false, createAsDeleted: Boolean = false): MutateInResult

remove

suspend fun remove(id: String, common: CommonOptions = CommonOptions.Default, durability: Durability = Durability.disabled(), cas: Long = 0): MutationResult

replace

inline suspend fun <T> replace(id: String, content: T, common: CommonOptions = CommonOptions.Default, transcoder: Transcoder? = null, durability: Durability = Durability.disabled(), expiry: Expiry = Expiry.None, preserveExpiry: Boolean = false, cas: Long = 0): MutationResult

touch

suspend fun touch(id: String, expiry: Expiry, common: CommonOptions = CommonOptions.Default): MutationResult

unlock

suspend fun unlock(id: String, cas: Long, common: CommonOptions = CommonOptions.Default)

upsert

inline suspend fun <T> upsert(id: String, content: T, common: CommonOptions = CommonOptions.Default, transcoder: Transcoder? = null, durability: Durability = Durability.disabled(), expiry: Expiry = Expiry.None, preserveExpiry: Boolean = false): MutationResult

Updates a document if it exists, otherwise inserts it.

Properties

binary

val binary: BinaryCollection

Provides access to operations that apply only to binary documents.

name

val name: String

scope

val scope: Scope