createOrReplace #

Creates a new document in the persistent data storage, or replaces its content if it already exists.

---

:::: tabs ::: tab Java

Arguments #

Copied to clipboard!

public CompletableFuture<Map<String, Object>> createOrReplace(
      String index,
      String collection,
      String id,
      Map<String, Object> document)
throws NotConnectedException, InternalException

public CompletableFuture<Map<String, Object>> createOrReplace(
      String index,
      String collection,
      String id,
      Map<String, Object> document,
      Boolean waitForRefresh)
throws NotConnectedException, InternalException

Arguments	Type	Description
index	String	Index
collection	String	Collection
id	String	Document ID
document	Map<String, Object>	Document content
waitForRefresh	Boolean	If set to true, Kuzzle will wait for the persistence layer to finish indexing

---

Return #

A Map which has the following properties:

Property	Type	Description
_source	Map	Document content
_id	String	ID of the document
_version	Integer	Version of the document in the persistent data storage

Usage #

Copied to clipboard!

Map<String, Object> document = new HashMap<>();
document.put("firstname", "John");
Map<String, Object> result = kuzzle
  .getDocumentController()
  .createOrReplace("nyc-open-data", "yellow-taxi", "some-id", document)
  .get();
/*
  {
    _source=
      {
        firstname=John,
        _kuzzle_info={ 
          createdAt=1582892323254, 
          author=-1, 
          updatedAt=1582892323254, 
          updater=-1
        }
      },
  _id=some-id,
  _version=1
  }
 */

::: ::: tab Kotlin

Arguments #

Copied to clipboard!

fun createOrReplace(
  index: String,
  collection: String,
  id: String,
  document: Map<String, Any?>,
  waitForRefresh: Boolean? = null): CompletableFuture<Map<String, Any?>>

Arguments	Type	Description
index	String	Index
collection	String	Collection
id	String	Document ID
document	Map<String, Any?>	Document content
waitForRefresh	Boolean (null)	If set to true, Kuzzle will wait for the persistence layer to finish indexing

---

Return #

A Map which has the following properties:

Property	Type	Description
_source	Map	Document content
_id	String	ID of the document
_version	Int	Version of the document in the persistent data storage

Usage #

Copied to clipboard!

val document: Map<String, Any?> = HashMap<String, Any?>().apply {
  put("firstname", "John")
}
val result: Map<String, Any?> =
  kuzzle
    .documentController
    .createOrReplace("nyc-open-data", "yellow-taxi", "some-id", document)
    .get()

::: ::::