mCreateOrReplace #

Creates or replaces multiple documents.

---

Arguments #

Copied to clipboard!

public CompletableFuture<Map<String, ArrayList<Object>>> mCreateOrReplace(
      String index,
      String collection,
      ArrayList<Map<String, Object>> documents)
throws NotConnectedException, InternalException

public CompletableFuture<Map<String, ArrayList<Object>>> mCreateOrReplace(
      String index,
      String collection,
      ArrayList<Map<String, Object>> documents,
      Boolean waitForRefresh)
throws NotConnectedException, InternalException

Arguments	Type	Description
index	String	Index
collection	String	Collection
documents	ArrayList<Map<String, Object>>	ArrayList containing the documents to create
waitForRefresh	Boolean	If set to true, Kuzzle will wait for the persistence layer to finish indexing

---

documents #

Each document has the following properties:

Arguments	Type	Description
_id	String	Optional document ID. Will be auto-generated if not defined.
body	Map<String, Object>	Document body

Return #

A Map<String, ArrayList<Object>> which has a successes and errors ArrayList<Object>: Each created document is an object of the successes array with the following properties:

Property	Type	Description
_source	Map<String, Object>	Created document
_id	String	ID of the newly created document
_version	Integer	Version of the document in the persistent data storage

Each errored document is an object of the errors array with the following properties:

Property	Type	Description
document	Map<String, Object>	Document that causes the error
status	Integer	HTTP error status
reason	String	Human readable reason

Usage #

Copied to clipboard!

Map<String, Object> document1 = new HashMap<>();
Map<String, Object> document2 = new HashMap<>();
Map<String, Object> body = new HashMap<>();
Map<String, Object> body2 = new HashMap<>();
body.put("Agent", "Smith");
body2.put("Gordon", "Freeman");
document1.put("_id", "some-id");
document1.put("body", body);
document2.put("_id", "some-id2");
document2.put("body", body2);
final ArrayList<Map<String, Object>> documents = new ArrayList<>();
documents.add(document1);
documents.add(document2);
Map<String, ArrayList<Object>> result = kuzzle
  .getDocumentController()
  .mCreateOrReplace("nyc-open-data", "yellow-taxi", documents)
  .get();
/*
  result =
  {
    successes=
    [
      {
        result=created,
        _source=
          {
            Agent=Smith,
            _kuzzle_info={createdAt=1582892842099, author=-1}
          },
        _id=some-id,
        _version=1,
        status=201
      },
      {
        result=created,
        _source=
          {
            Gordon=Freeman,
            _kuzzle_info={createdAt=1582892842099, author=-1}
          },
        _id=some-id2,
        _version=1,
        status=201
      }
    ],
    errors=[]
  }
*/

Arguments #

Copied to clipboard!

fun mCreateOrReplace(
      index: String,
      collection: String,
      documents: ArrayList<Map<String, Any?>>,
      waitForRefresh: Boolean? = null): CompletableFuture<Map<String, ArrayList<Any>>>

Arguments	Type	Description
index	String	Index
collection	String	Collection
documents	ArrayList<Map<String, Any?>>	ArrayList containing the documents to create
waitForRefresh	Boolean	If set to true, Kuzzle will wait for the persistence layer to finish indexing

---

documents #

Each document has the following properties:

Arguments	Type	Description
_id	String	Optional document ID. Will be auto-generated if not defined.
body	Map<String, Any?>	Document body

Return #

A Map<String, ArrayList<Object>> which has a successes and errors ArrayList<Object>: Each created document is an object of the successes array with the following properties:

Property	Type	Description
_source	Map<String, Any?>	Created document
_id	String	ID of the newly created document
_version	Int	Version of the document in the persistent data storage

Each errored document is an object of the errors array with the following properties:

Property	Type	Description
document	Map<String, Any?>	Document that causes the error
status	Int	HTTP error status
reason	String	Human readable reason

Usage #

Copied to clipboard!

val document1: Map<String, Any?> =
  HashMap<String, Any?>().apply {
    put("_id", "some-id")
    put("body", HashMap<String, Any?>().apply {
      put("Agent", "Smith")
    })
  }
val document2: Map<String, Any?> =
  HashMap<String, Any?>().apply {
    put("_id", "some-id2")
    put("body", HashMap<String, Any?>().apply {
      put("Gordon", "Freeman")
    })
  }
val documents: ArrayList<Map<String, Any?>> =
  ArrayList<Map<String, Any?>>().apply {
    add(document1)
    add(document2)
  }
val result: Map<String, ArrayList<Any>> =
  kuzzle
    .documentController
    .mCreateOrReplace("nyc-open-data", "yellow-taxi", documents)
    .get()