mWrite #

This is a low level route intended to bypass Kuzzle actions on document creation, notably:

check document validity,
add kuzzle metadata,
trigger realtime notifications (unless asked otherwise)

:::: tabs ::: tab Java

Arguments #

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

Argument	Type	Description
`index`	String	Index name
`collection`	String	Collection name
`documents`	ArrayList<Map<String, Object>>	An array of JObject representing the documents

documents #

An array of Map<String, Object>. Each object describes a document to create or replace, by exposing the following properties:

_id: document unique identifier (optional)
body: document content

Options #

Property	Type	Description
`waitForRefresh`	Bool (`false`)	If set to true, Kuzzle will not respond until the created/replaced documents are indexed
`notify`	Bool (`false`)	If set to true, Kuzzle will trigger realtime notifications

Return #

Returns a Map<String, Object> containing 2 arrays: successes and errors

Each created or replaced document is an object of the successes array with the following properties:

Name	Type	Description
`_id`	String	Document ID
`_version`	Integer	Version of the document in the persistent data storage
`_source`	Map<String, Object>	Document content
`created`	Bool	True if the document was created

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

Name	Type	Description
`document`	Map<String, Object>	Document that cause the error
`status`	Integer	HTTP error status
`reason`	String	Human readable reason

Usage #

Map<String, Object> document = new HashMap<String, Object>();
ArrayList<Map<String, Object>> documents = new ArrayList<Map<String, Object>>();
documents.add(document);
document.put("_id", "foo");
document.put("body", new HashMap<String, Object>());
Map<String, Object> result =
kuzzle.getBulkController().mWrite("nyc-open-data", "yellow-taxi", documents).get();

::: ::: tab Kotlin