upsert
fun <T : Any> upsert(value: T, writeStrategy: DittoWriteStrategy = DittoWriteStrategy.Merge): DittoDocumentId
Inserts a new document into the collection and returns its identifier. If the document already exists, the behavior is determined by the given writeStrategy.
Return
the identifier of the inserted document.
Parameters
value
the value to insert into the collection.
write
specifies the desired strategy for inserting a document. The default value is DittoWriteStrategy.Merge.
Throws
Thrown if the value provided could not be upserted. This could be due to a serialization error or an I/O related error.