Package-level declarations

Types

Link copied to clipboard
expect open class Array : Iterable<Any?>

Array provides readonly access to array data.

actual open class Array : DelegatedClass<<Error class: unknown class>> , Iterable<Any?>
actual open class Array : Iterable<Any?>
Link copied to clipboard
expect object ArrayExpression

Array expression

actual object ArrayExpression
actual object ArrayExpression
Link copied to clipboard
expect class ArrayExpressionIn

The In class represents the IN clause object in a quantified operator (ANY/ANY AND EVERY/EVERY IN SATISFIES ). The IN clause is used for specifying an array object or an expression evaluated as an array object, each item of which will be evaluated against the satisfies expression.

actual class ArrayExpressionIn : DelegatedClass<<Error class: unknown class>>
actual class ArrayExpressionIn
Link copied to clipboard

The Satisfies class represents the SATISFIES clause object in a quantified operator (ANY/ANY AND EVERY/EVERY IN SATISFIES ). The SATISFIES clause is used for specifying an expression that will be used to evaluate each item in the array.

actual class ArrayExpressionSatisfies : DelegatedClass<<Error class: unknown class>>
Link copied to clipboard
expect object ArrayFunction

Function provides array functions.

actual object ArrayFunction
actual object ArrayFunction
Link copied to clipboard
expect sealed class Authenticator

Authenticator objects provide server authentication credentials to the replicator. Authenticator is a base sealed class; you must instantiate one of its implementations.

actual sealed class Authenticator : DelegatedClass<<Error class: unknown class>>
actual sealed class Authenticator
Link copied to clipboard
expect class BasicAuthenticator(username: String, password: CharArray) : Authenticator

The BasicAuthenticator class is an authenticator that will authenticate using HTTP Basic auth with the given username and password. This should only be used over an SSL/TLS connection, as otherwise it's very easy for anyone sniffing network traffic to read the password.

actual class BasicAuthenticator(username: String, password: CharArray) : Authenticator
actual class BasicAuthenticator(val username: String, password: CharArray) : Authenticator
Link copied to clipboard
expect class Blob(contentType: String, content: ByteArray)

A Couchbase Lite Blob. A Blob appears as a property of a Document and contains arbitrary binary data, tagged with MIME type. Blobs can be arbitrarily large, although some operations may require that the entire content be loaded into memory. The containing document's JSON contains only the Blob's metadata (type, length and digest). The data itself is stored in a file whose name is the content digest (like git).

actual class Blob(contentType: String, content: ByteArray) : DelegatedClass<<Error class: unknown class>>
actual class Blob(contentType: String, content: ByteArray)
Link copied to clipboard
object CBLError
Link copied to clipboard
typealias ChangeListener<T> = (changed: T) -> Unit
Link copied to clipboard
typealias ChangeSuspendListener<T> = suspend (changed: T) -> Unit
Link copied to clipboard
expect sealed class Collation

Collation defines how strings are compared and is used when creating a COLLATE expression. The COLLATE expression can be used in the WHERE clause when comparing two strings or in the ORDER BY clause when specifying how the order of the query results. CouchbaseLite provides two types of the Collation, ASCII and Unicode. Without specifying the COLLATE expression Couchbase Lite will use the ASCII with case-sensitive collation by default.

actual sealed class Collation : DelegatedClass<<Error class: unknown class>>
actual sealed class Collation
Link copied to clipboard

ConcurrencyControl type used when saving or deleting a document.

actual typealias ConcurrencyControl = <Error class: unknown class>
Link copied to clipboard
expect class Conflict
actual class Conflict : DelegatedClass<<Error class: unknown class>>
actual class Conflict
Link copied to clipboard
typealias ConflictHandler = (document: MutableDocument, oldDocument: Document?) -> Boolean
Link copied to clipboard
typealias ConflictResolver = (conflict: Conflict) -> Document?

Custom conflict resolution strategies implement this interface.

Link copied to clipboard
expect class ConsoleLogger : Logger

A class that sends log messages to the system log, available via 'logcat' on Android.

actual class ConsoleLogger : DelegatedClass<<Error class: unknown class>> , Logger
actual class ConsoleLogger : Logger
Link copied to clipboard

CouchbaseLite Utility

CouchbaseLite Utility

Link copied to clipboard

A CouchbaseLiteException gets raised whenever a Couchbase Lite faces errors.

actual typealias CouchbaseLiteException = <Error class: unknown class>
Link copied to clipboard
expect class Database

A Couchbase Lite database.

actual class Database : DelegatedClass<<Error class: unknown class>>
actual class Database
Link copied to clipboard
expect class DatabaseChange

Provides details about a Database change.

actual class DatabaseChange : DelegatedClass<<Error class: unknown class>>
actual class DatabaseChange
Link copied to clipboard

The listener interface for receiving Database change events.

Link copied to clipboard

The listener interface for receiving Database change events, called within a coroutine.

Link copied to clipboard

Configuration for opening a database.

actual class DatabaseConfiguration(config: DatabaseConfiguration?) : DelegatedClass<<Error class: unknown class>>
Link copied to clipboard
expect open class DataSource

A query data source, used for specifying the source of data for a query.

actual open class DataSource : DelegatedClass<<Error class: unknown class>>
actual open class DataSource
Link copied to clipboard
expect open class Dictionary : Iterable<String>

Dictionary provides readonly access to dictionary data.

actual open class Dictionary : DelegatedClass<<Error class: unknown class>> , Iterable<String>
actual open class Dictionary : Iterable<String>
Link copied to clipboard
expect open class Document : Iterable<String>

Readonly version of the Document.

actual open class Document : DelegatedClass<<Error class: unknown class>> , Iterable<String>
actual open class Document : Iterable<String>
Link copied to clipboard
expect class DocumentChange

Provides details about a Document change.

actual class DocumentChange : DelegatedClass<<Error class: unknown class>>
actual class DocumentChange
Link copied to clipboard

The listener interface for receiving Document change events.

Link copied to clipboard

The listener interface for receiving Document change events, called within a coroutine.

Link copied to clipboard

The flags enum describing the replicated document.

actual typealias DocumentFlag = <Error class: unknown class>
Link copied to clipboard

DocumentFragment provides access to a document object. DocumentFragment also provides subscript access by either key or index to the data values of the document which are wrapped by Fragment objects.

Link copied to clipboard
expect class DocumentReplication

Document replicated update of a replicator.

actual class DocumentReplication : DelegatedClass<<Error class: unknown class>>
actual class DocumentReplication
Link copied to clipboard

The listener interface for receiving Document replicated events.

Link copied to clipboard
typealias DocumentReplicationSuspendListener = suspend (replication: DocumentReplication) -> Unit

The listener interface for receiving Document replicated events, called within a coroutine.

Link copied to clipboard
expect sealed class Endpoint

Replication target endpoint

actual sealed class Endpoint : DelegatedClass<<Error class: unknown class>>
actual sealed class Endpoint
Link copied to clipboard
expect open class Expression

The expression used in constructing a query.

actual open class Expression : DelegatedClass<<Error class: unknown class>>
actual open class Expression
Link copied to clipboard
expect class FileLogger : Logger

A logger for writing to a file in the application's storage so that log messages can persist durably after the application has stopped or encountered a problem. Each log level is written to a separate file. Threading policy: This class is certain to be used from multiple threads. As long as it is thread safe, the various race conditions are unlikely and the penalties very small. "Volatile" ensures the thread safety and the several races are tolerable.

actual class FileLogger : DelegatedClass<<Error class: unknown class>> , Logger
actual class FileLogger : Logger
Link copied to clipboard
open class Fragment

Fragment provides readonly access to data value. Fragment also provides subscript access by either key or index to the nested values which are wrapped by Fragment objects.

Link copied to clipboard

A From represents a FROM clause for specifying the data source of the query.

actual class From : DelegatedClass<<Error class: unknown class>> , Query, JoinRouter, WhereRouter, GroupByRouter, OrderByRouter, LimitRouter
Link copied to clipboard
interface FromRouter : Query
Link copied to clipboard
expect object FullTextFunction

Full-text function.

actual object FullTextFunction
actual object FullTextFunction
Link copied to clipboard
expect class FullTextIndex : Index

Index for Full-Text search

actual class FullTextIndex : Index
actual class FullTextIndex : Index
Link copied to clipboard
actual class FullTextIndexConfiguration(val expressions: String) : IndexConfiguration
Link copied to clipboard
expect class FullTextIndexItem

Full-text Index Item.

actual class FullTextIndexItem : DelegatedClass<<Error class: unknown class>>
actual class FullTextIndexItem
Link copied to clipboard
expect object Function

Query functions.

actual object Function
actual object Function
Link copied to clipboard

A GroupBy represents the GROUP BY clause to group the query result. The GROUP BY clause is normally used with aggregate functions (AVG, COUNT, MAX, MIN, SUM) to aggregate the group of the values.

actual class GroupBy : DelegatedClass<<Error class: unknown class>> , Query, HavingRouter, OrderByRouter, LimitRouter
Link copied to clipboard
interface GroupByRouter : Query
Link copied to clipboard

Having represents a HAVING clause of the query statement used for filtering the aggregated values from the GROUP BY clause.

actual class Having : DelegatedClass<<Error class: unknown class>> , Query, OrderByRouter, LimitRouter
Link copied to clipboard
interface HavingRouter : Query
Link copied to clipboard
expect sealed class Index

Index represents an index which could be a value index for regular queries or full-text index for full-text queries (using the match operator).

actual sealed class Index : DelegatedClass<<Error class: unknown class>>
actual sealed class Index
Link copied to clipboard
expect object IndexBuilder

IndexBuilder used for building database index objects. Use Database.createIndex(IndexConfiguration, String)

actual object IndexBuilder
actual object IndexBuilder
Link copied to clipboard
expect sealed class IndexConfiguration
actual sealed class IndexConfiguration : DelegatedClass<<Error class: unknown class>>
actual sealed class IndexConfiguration
Link copied to clipboard
expect open class Join

A Join component representing a single JOIN clause in the query statement.

actual open class Join : DelegatedClass<<Error class: unknown class>>
actual open class Join
Link copied to clipboard
interface JoinRouter : Query
Link copied to clipboard

A Joins component represents a collection of the joins clauses of the query statement.

actual class Joins : DelegatedClass<<Error class: unknown class>> , Query, WhereRouter, OrderByRouter, LimitRouter
Link copied to clipboard
expect class Limit : Query

A Limit component represents the LIMIT clause of the query statement.

actual class Limit : DelegatedClass<<Error class: unknown class>> , Query
actual class Limit : Query
Link copied to clipboard
interface LimitRouter : Query
Link copied to clipboard
expect interface ListenerToken

The listener token interface

actual typealias ListenerToken = <Error class: unknown class>
actual interface ListenerToken
Link copied to clipboard
expect class Log

Gets the log controller for Couchbase Lite, which stores the three available logging methods: console (logcat), file, and custom.

actual class Log : DelegatedClass<<Error class: unknown class>>
actual class Log
Link copied to clipboard
expect enum LogDomain : Enum<LogDomain>

Log domain

actual enum LogDomain : Enum<LogDomain>
actual enum LogDomain : Enum<LogDomain>
Link copied to clipboard
expect class LogFileConfiguration(directory: String)

A class that describes the file configuration for the FileLogger class. These options must be set atomically, so they won't take effect unless a new configuration object is set on the logger. Attempting to modify an in-use configuration object will result in an exception being thrown.

actual class LogFileConfiguration(directory: String) : DelegatedClass<<Error class: unknown class>>
actual class LogFileConfiguration(val directory: String)
Link copied to clipboard
interface Logger

The logging interface for Couchbase Lite. If an application wants to receive log messages to an arbitrary endpoint, then it can by implementing this interface.

Link copied to clipboard
expect enum LogLevel : Enum<LogLevel>

Log level.

actual typealias LogLevel = <Error class: unknown class>
actual enum LogLevel : Enum<LogLevel>
Link copied to clipboard
actual typealias MaintenanceType = <Error class: unknown class>
Link copied to clipboard
expect object Meta

Meta is a factory class for creating the expressions that refer to the metadata properties of the document.

actual object Meta
actual object Meta
Link copied to clipboard
expect class MetaExpression : Expression

A meta property expression.

actual class MetaExpression : Expression
actual class MetaExpression : Expression
Link copied to clipboard
expect class MutableArray : Array

MutableArray provides access to array data.

actual class MutableArray : Array
actual class MutableArray : Array
Link copied to clipboard

Dictionary provides access to dictionary data.

Link copied to clipboard
expect class MutableDocument : Document

A Couchbase Lite Document. A document has key/value properties like a Map.

actual class MutableDocument : Document
actual class MutableDocument : Document
Link copied to clipboard

MutableFragment provides read and write access to data value. MutableFragment also provides subscript access by either key or index to the nested values which are wrapped by MutableFragment objects.

Link copied to clipboard
expect class OrderBy : Query, LimitRouter

An OrderBy represents an ORDER BY clause of the query for specifying properties or expressions that the result rows should be sorted by.

actual class OrderBy : DelegatedClass<<Error class: unknown class>> , Query, LimitRouter
actual class OrderBy : Query, LimitRouter
Link copied to clipboard
interface OrderByRouter : Query
Link copied to clipboard
expect sealed class Ordering

An Ordering represents a single ordering component in the query ORDER BY clause.

actual sealed class Ordering : DelegatedClass<<Error class: unknown class>>
actual sealed class Ordering
Link copied to clipboard
expect class Parameters

A Parameters object used for setting values to the query parameters defined in the query.

actual class Parameters : DelegatedClass<<Error class: unknown class>>
actual class Parameters
Link copied to clipboard

Property expression

Link copied to clipboard
interface Query

A database query used for querying data from the database. The query statement of the Query object can be fluently constructed by calling the static select methods.

Link copied to clipboard
expect object QueryBuilder
actual object QueryBuilder
actual object QueryBuilder
Link copied to clipboard
expect class QueryChange

QueryChange contains the information about the query result changes reported by a query object.

actual class QueryChange : DelegatedClass<<Error class: unknown class>>
actual class QueryChange
Link copied to clipboard

The listener interface for receiving Live Query change events.

Link copied to clipboard

The listener interface for receiving Live Query change events, called within a coroutine.

Link copied to clipboard
expect class ReplicatedDocument
actual class ReplicatedDocument : DelegatedClass<<Error class: unknown class>>
actual class ReplicatedDocument
Link copied to clipboard
typealias ReplicationFilter = (document: Document, flags: Set<DocumentFlag>) -> Boolean

Interface delegate that takes Document input parameter and bool output parameter Document push and pull will be allowed if output is true, otherwise, Document push and pull will not be allowed.

Link copied to clipboard

A replicator for replicating document changes between a local database and a target database. The replicator can be bidirectional or either push or pull. The replicator can also be one-shot or continuous. The replicator runs asynchronously, so observe the status to be notified of progress.

actual class Replicator(config: ReplicatorConfiguration) : DelegatedClass<<Error class: unknown class>> , AutoCloseable
Link copied to clipboard

Activity level of a replicator.

Link copied to clipboard
expect class ReplicatorChange

ReplicatorChange contains the replicator status information.

actual class ReplicatorChange : DelegatedClass<<Error class: unknown class>>
actual class ReplicatorChange
Link copied to clipboard

The listener interface for receiving Replicator change events.

Link copied to clipboard

The listener interface for receiving Replicator change events, called within a coroutine.

Link copied to clipboard
expect class ReplicatorConfiguration(database: Database, target: Endpoint)

Configuration for a Replicator

actual class ReplicatorConfiguration(val database: Database, val target: Endpoint) : DelegatedClass<<Error class: unknown class>>
actual class ReplicatorConfiguration(val database: Database, val target: Endpoint)
Link copied to clipboard
expect class ReplicatorProgress

Progress of a replicator. If total is zero, the progress is indeterminate; otherwise, dividing the two will produce a fraction that can be used to draw a progress bar.

actual class ReplicatorProgress : DelegatedClass<<Error class: unknown class>>
actual class ReplicatorProgress
Link copied to clipboard
expect class ReplicatorStatus

Combined activity level and progress of a replicator.

actual class ReplicatorStatus : DelegatedClass<<Error class: unknown class>>
actual class ReplicatorStatus
Link copied to clipboard

The replication direction

Link copied to clipboard
expect class Result : Iterable<String>

Result represents a row of result set returned by a Query.

actual class Result : DelegatedClass<<Error class: unknown class>> , Iterable<String>
actual class Result : Iterable<String>
Link copied to clipboard

A result set representing the query result. The result set is an iterator of the Result objects.

actual class ResultSet : DelegatedClass<<Error class: unknown class>> , Iterable<Result> , AutoCloseable
Link copied to clipboard
expect class Select : Query, FromRouter

Select represents the SELECT clause of the query for specifying the returning properties in each query result row.

actual class Select : DelegatedClass<<Error class: unknown class>> , Query, FromRouter
actual class Select : Query, FromRouter
Link copied to clipboard
expect open class SelectResult

SelectResult represents a single return value of the query statement.

actual open class SelectResult : DelegatedClass<<Error class: unknown class>>
actual open class SelectResult
Link copied to clipboard

SessionAuthenticator class is an authenticator that will authenticate by using the session ID of the session created by a Sync Gateway

Link copied to clipboard
expect class URLEndpoint(url: String) : Endpoint

URL based replication target endpoint

actual class URLEndpoint(url: String) : Endpoint
actual class URLEndpoint(val url: String) : Endpoint
Link copied to clipboard
expect class ValueIndex : Index

Value (standard query) index

actual class ValueIndex : Index
actual class ValueIndex : Index
Link copied to clipboard
actual class ValueIndexConfiguration(val expressions: String) : IndexConfiguration
Link copied to clipboard
expect class ValueIndexItem

Value Index Item

actual class ValueIndexItem : DelegatedClass<<Error class: unknown class>>
actual class ValueIndexItem
Link copied to clipboard

Variable expression

Link copied to clipboard

A Where represents the WHERE clause of the query for filtering the query result.

actual class Where : DelegatedClass<<Error class: unknown class>> , Query, GroupByRouter, OrderByRouter, LimitRouter
Link copied to clipboard
interface WhereRouter : Query

Properties

Link copied to clipboard

The numerical error code for this error.

Link copied to clipboard

Configuration factory for new DatabaseConfigurations

Link copied to clipboard

The default conflict resolver used by the replicator.

Link copied to clipboard

This is a long time: just under 25 days. This many seconds, however, is just less than Integer.MAX_INT millis, and will fit in the heartbeat property.

Link copied to clipboard

The domain code for this error.

Link copied to clipboard

Configuration factory for new FullTextIndexConfigurations

Link copied to clipboard
Link copied to clipboard

Configuration factory for new LogFileConfigurations

Link copied to clipboard

Configuration factory for new ReplicatorConfigurations

Link copied to clipboard

Configuration factory for new ValueIndexConfigurations

Functions

Link copied to clipboard

A Flow of database changes.

Link copied to clipboard
fun Database.documentChangeFlow(documentId: String, coroutineContext: CoroutineContext? = null): Flow<DocumentChange>

A Flow of document changes.

Link copied to clipboard

A Flow of document replications.

Link copied to clipboard
operator fun Array.get(index: Int): Fragment

Subscript access to a Fragment object by index.

operator fun Database.get(key: String): DocumentFragment

Gets document fragment object by the given document ID.

operator fun Dictionary.get(key: String): Fragment
operator fun Document.get(key: String): Fragment

Subscript access to a Fragment object by key.

operator fun MutableArray.get(index: Int): MutableFragment

Subscripting access to a MutableFragment object that represents the value at the given index.

Subscripting access to a MutableFragment object that represents the value of the dictionary by key.

Subscripting access to a MutableFragment object that represents the value of the document by key.

operator fun Result.get(index: Int): Fragment

Subscript access to a Fragment object of the projecting result value at the given index.

operator fun Result.get(key: String): Fragment

Subscript access to a Fragment object of the projecting result value for the given key.

Link copied to clipboard

Create a DatabaseConfiguration, overriding the receiver's values with the passed parameters:

fun ValueIndexConfiguration?.newConfig(vararg expressions: String = emptyArray()): ValueIndexConfiguration

Create a ValueIndexConfiguration, overriding the receiver's values with the passed parameters:

fun FullTextIndexConfiguration?.newConfig(vararg expressions: String = emptyArray(), language: String? = null, ignoreAccents: Boolean? = null): FullTextIndexConfiguration

Create a FullTextIndexConfiguration, overriding the receiver's values with the passed parameters:

fun LogFileConfiguration?.newConfig(directory: String? = null, maxSize: Long? = null, maxRotateCount: Int? = null, usePlainText: Boolean? = null): LogFileConfiguration

Create a LogFileConfiguration, overriding the receiver's values with the passed parameters:

fun ReplicatorConfiguration?.newConfig(database: Database? = null, target: Endpoint? = null, type: ReplicatorType? = null, continuous: Boolean? = null, authenticator: Authenticator? = null, headers: Map<String, String>? = null, pinnedServerCertificate: ByteArray? = null, channels: List<String>? = null, documentIDs: List<String>? = null, pushFilter: ReplicationFilter? = null, pullFilter: ReplicationFilter? = null, conflictResolver: ConflictResolver? = null, maxAttempts: Int? = null, maxAttemptWaitTime: Int? = null, heartbeat: Int? = null, enableAutoPurge: Boolean? = null, acceptParentDomainCookies: Boolean? = null): ReplicatorConfiguration

Create a ReplicatorConfiguration, overriding the receiver's values with the passed parameters:

Link copied to clipboard
fun Query.queryChangeFlow(coroutineContext: CoroutineContext? = null): Flow<QueryChange>

A Flow of query changes.

Link copied to clipboard

A Flow of replicator state changes.