mCreateOrReplace

Creates or replaces multiple documents.

Throws a partial error (error code 206) if one or more document creations/replacements fail.

Arguments

Copied to clipboard!
String mCreateOrReplace(
  String index,
  String collection,
  String documents,
  io.kuzzle.sdk.QueryOptions options
)
String mCreateOrReplace(
  String index,
  String collection,
  String documents
)

Argument Type Description
index
String
Index name
collection
String
Collection name
documents
String
A JSON string containing the documents to create
options
io.kuzzle.sdk.QueryOptions
Query options

options

Additional query options

Option Type
(default)
Description
queuable
boolean

(true)
If true, queues the request during downtime, until connected to Kuzzle again
refresh
String

("")
If set to wait_for, waits for the change to be reflected for search (up to 1s)

Return

Returns an JSON string containing the created documents.

Exceptions

Throws a io.kuzzle.sdk.KuzzleException if there is an error. See how to handle error.

Usage

Copied to clipboard!
String documents = "["
  + "   {"
  + "       \"_id\": \"some-id\","
  + "       \"body\": { \"capacity\": 4 }"
  + "   },"
  + "   {"
  + "       \"_id\": \"some-other-id\","
  + "       \"body\": { \"capacity\": 4 }"
  + "   }"
  + "]";

try {
  String response = kuzzle.getDocument().mCreateOrReplace(
    "nyc-open-data",
    "yellow-taxi",
    documents
  );

  System.out.println(response);
  /*
  [
    {
    "_id":"some-id",
    "_source":{
      "_kuzzle_info":{
      "active":true,
      "author":"-1",
      "updater":null,
      "updatedAt":null,
      "deletedAt":null,
      "createdAt":1538552685790
      },
      "capacity":4
    },
    "_index":"nyc-open-data",
    "_type":"yellow-taxi",
    "_version":1,
    "result":"created",
    "_shards":{
      "total":2,
      "successful":1,
      "failed":0
    },
    "created":true,
    "status":201
    },
    {
    "_id":"some-other-id",
    "_source":{
      "_kuzzle_info":{
      "active":true,
      "author":"-1",
      "updater":null,
      "updatedAt":null,
      "deletedAt":null,
      "createdAt":1538552685790
      },
      "capacity":4
    },
    "_index":"nyc-open-data",
    "_type":"yellow-taxi",
    "_version":1,
    "result":"created",
    "_shards":{
      "total":2,
      "successful":1,
      "failed":0
    },
    "created":true,
    "status":201
    }
  ]
  */
  System.out.println("Success");
} catch (KuzzleException e) {
  System.err.println(e.getMessage());
}