io.vertx/vertx-mongo-client/3.8.0 : io/vertx/ext/mongo/MongoClient.java

MongoClient
http://nexus.sonatype.org/oss-repository-hosting.html/vertx-parent/vertx-ext/vertx-ext-parent/vertx-mongo-client: Sonatype helps open source projects to set up Maven repositories on https://oss.sonatype.org/ (Eclipse)
package io.vertx.ext.mongo;

import io.vertx.codegen.annotations.Fluent;
import io.vertx.codegen.annotations.Nullable;
import io.vertx.codegen.annotations.VertxGen;
import io.vertx.core.AsyncResult;
import io.vertx.core.Handler;
import io.vertx.core.Vertx;
import io.vertx.core.json.JsonArray;
import io.vertx.core.json.JsonObject;
import io.vertx.core.streams.ReadStream;
import io.vertx.ext.mongo.impl.MongoClientImpl;

import java.util.List;
import java.util.UUID;

A Vert.x service used to interact with MongoDB server instances.

Some of the operations might change _id field of passed JsonObject document. 
Author: Tim Fox/**
 * A Vert.x service used to interact with MongoDB server instances.
 * <p>
 * Some of the operations might change <i>_id</i> field of passed {@link JsonObject} document.
 *
 * @author <a href="http://tfox.org">Tim Fox</a>
 */
@VertxGen
public interface MongoClient {

  The name of the default pool
/**
   * The name of the default pool
   */
  String DEFAULT_POOL_NAME = "DEFAULT_POOL";

  The name of the default database
/**
   * The name of the default database
   */
  String DEFAULT_DB_NAME = "DEFAULT_DB";

  Create a Mongo client which maintains its own data source.
Params: vertx –  the Vert.x instance
config –  the configuration
Returns: the client/**
   * Create a Mongo client which maintains its own data source.
   *
   * @param vertx  the Vert.x instance
   * @param config  the configuration
   * @return the client
   */
  static MongoClient createNonShared(Vertx vertx, JsonObject config) {
    return new MongoClientImpl(vertx, config, UUID.randomUUID().toString());
  }

  Create a Mongo client which shares its data source with any other Mongo clients created with the same
data source name
Params: vertx –  the Vert.x instance
config –  the configuration
dataSourceName –  the data source name
Returns: the client/**
   * Create a Mongo client which shares its data source with any other Mongo clients created with the same
   * data source name
   *
   * @param vertx  the Vert.x instance
   * @param config  the configuration
   * @param dataSourceName  the data source name
   * @return the client
   */
  static MongoClient createShared(Vertx vertx, JsonObject config, String dataSourceName) {
    return new MongoClientImpl(vertx, config, dataSourceName);
  }

  Like createShared(Vertx, JsonObject, String) but with the default data source name 
Params: vertx –  the Vert.x instance
config –  the configuration
Returns: the client/**
   * Like {@link #createShared(io.vertx.core.Vertx, JsonObject, String)} but with the default data source name
   * @param vertx  the Vert.x instance
   * @param config  the configuration
   * @return the client
   */
  static MongoClient createShared(Vertx vertx, JsonObject config) {
    return new MongoClientImpl(vertx, config, DEFAULT_POOL_NAME);
  }


  Save a document in the specified collection

This operation might change _id field of document parameter
Params: collection –  the collection
document –  the document
resultHandler –  result handler will be provided with the id if document didn't already have one/**
   * Save a document in the specified collection
   * <p>
   * This operation might change <i>_id</i> field of <i>document</i> parameter
   *
   * @param collection  the collection
   * @param document  the document
   * @param resultHandler  result handler will be provided with the id if document didn't already have one
   */
  @Fluent
  MongoClient save(String collection, JsonObject document, Handler<AsyncResult<@Nullable String>> resultHandler);

  Save a document in the specified collection with the specified write option

This operation might change _id field of document parameter
Params: collection –  the collection
document –  the document
writeOption –  the write option to use
resultHandler –  result handler will be provided with the id if document didn't already have one/**
   * Save a document in the specified collection with the specified write option
   * <p>
   * This operation might change <i>_id</i> field of <i>document</i> parameter
   *
   * @param collection  the collection
   * @param document  the document
   * @param writeOption  the write option to use
   * @param resultHandler  result handler will be provided with the id if document didn't already have one
   */
  @Fluent
  MongoClient saveWithOptions(String collection, JsonObject document, @Nullable WriteOption writeOption, Handler<AsyncResult<@Nullable String>> resultHandler);

  Insert a document in the specified collection

This operation might change _id field of document parameter
Params: collection –  the collection
document –  the document
resultHandler –  result handler will be provided with the id if document didn't already have one/**
   * Insert a document in the specified collection
   * <p>
   * This operation might change <i>_id</i> field of <i>document</i> parameter
   *
   * @param collection  the collection
   * @param document  the document
   * @param resultHandler  result handler will be provided with the id if document didn't already have one
   */
  @Fluent
  MongoClient insert(String collection, JsonObject document, Handler<AsyncResult<@Nullable String>> resultHandler);

  Insert a document in the specified collection with the specified write option

This operation might change _id field of document parameter
Params: collection –  the collection
document –  the document
writeOption –  the write option to use
resultHandler –  result handler will be provided with the id if document didn't already have one/**
   * Insert a document in the specified collection with the specified write option
   * <p>
   * This operation might change <i>_id</i> field of <i>document</i> parameter
   *
   * @param collection  the collection
   * @param document  the document
   * @param writeOption  the write option to use
   * @param resultHandler  result handler will be provided with the id if document didn't already have one
   */
  @Fluent
  MongoClient insertWithOptions(String collection, JsonObject document, @Nullable WriteOption writeOption, Handler<AsyncResult<@Nullable String>> resultHandler);

  Update matching documents in the specified collection
Params: collection –  the collection
query –  query used to match the documents
update – used to describe how the documents will be updated
resultHandler – will be called when complete/**
   * Update matching documents in the specified collection
   *
   * @param collection  the collection
   * @param query  query used to match the documents
   * @param update used to describe how the documents will be updated
   * @param resultHandler will be called when complete
   */
  @Deprecated @Fluent
  MongoClient update(String collection, JsonObject query, JsonObject update, Handler<AsyncResult<Void>> resultHandler);

  Update matching documents in the specified collection and return the handler with MongoClientUpdateResult result
Params: collection –  the collection
query –  query used to match the documents
update – used to describe how the documents will be updated
resultHandler – will be called when complete/**
   * Update matching documents in the specified collection and return the handler with MongoClientUpdateResult result
   *
   * @param collection  the collection
   * @param query  query used to match the documents
   * @param update used to describe how the documents will be updated
   * @param resultHandler will be called when complete
   */
  @Fluent
  MongoClient updateCollection(String collection, JsonObject query, JsonObject update,
                               Handler<AsyncResult<@Nullable MongoClientUpdateResult>> resultHandler);

  Update matching documents in the specified collection, specifying options
Params: collection –  the collection
query –  query used to match the documents
update – used to describe how the documents will be updated
options – options to configure the update
resultHandler – will be called when complete/**
   * Update matching documents in the specified collection, specifying options
   *
   * @param collection  the collection
   * @param query  query used to match the documents
   * @param update used to describe how the documents will be updated
   * @param options options to configure the update
   * @param resultHandler will be called when complete
   */
  @Deprecated @Fluent
  MongoClient updateWithOptions(String collection, JsonObject query, JsonObject update, UpdateOptions options, Handler<AsyncResult<Void>> resultHandler);

  Update matching documents in the specified collection, specifying options and return the handler with MongoClientUpdateResult result
Params: collection –  the collection
query –  query used to match the documents
update – used to describe how the documents will be updated
options – options to configure the update
resultHandler – will be called when complete/**
   * Update matching documents in the specified collection, specifying options and return the handler with MongoClientUpdateResult result
   *
   * @param collection  the collection
   * @param query  query used to match the documents
   * @param update used to describe how the documents will be updated
   * @param options options to configure the update
   * @param resultHandler will be called when complete
   */
  @Fluent
  MongoClient updateCollectionWithOptions(String collection, JsonObject query, JsonObject update, UpdateOptions options,
                                          Handler<AsyncResult<@Nullable MongoClientUpdateResult>> resultHandler);

  Replace matching documents in the specified collection

This operation might change _id field of replace parameter
Params: collection –  the collection
query –  query used to match the documents
replace –  all matching documents will be replaced with this
resultHandler – will be called when complete/**
   * Replace matching documents in the specified collection
   * <p>
   * This operation might change <i>_id</i> field of <i>replace</i> parameter
   *
   * @param collection  the collection
   * @param query  query used to match the documents
   * @param replace  all matching documents will be replaced with this
   * @param resultHandler will be called when complete
   */
  @Deprecated @Fluent
  MongoClient replace(String collection, JsonObject query, JsonObject replace, Handler<AsyncResult<Void>> resultHandler);

  Replace matching documents in the specified collection and return the handler with MongoClientUpdateResult result
Params: collection –  the collection
query –  query used to match the documents
replace –  all matching documents will be replaced with this
resultHandler – will be called when complete/**
   * Replace matching documents in the specified collection and return the handler with MongoClientUpdateResult result
   *
   * @param collection  the collection
   * @param query  query used to match the documents
   * @param replace  all matching documents will be replaced with this
   * @param resultHandler will be called when complete
   */
  @Fluent
  MongoClient replaceDocuments(String collection, JsonObject query, JsonObject replace, Handler<AsyncResult<@Nullable MongoClientUpdateResult>> resultHandler);

  Replace matching documents in the specified collection, specifying options

This operation might change _id field of replace parameter
Params: collection –  the collection
query –  query used to match the documents
replace –  all matching documents will be replaced with this
options – options to configure the replace
resultHandler – will be called when complete/**
   * Replace matching documents in the specified collection, specifying options
   * <p>
   * This operation might change <i>_id</i> field of <i>replace</i> parameter
   *
   * @param collection  the collection
   * @param query  query used to match the documents
   * @param replace  all matching documents will be replaced with this
   * @param options options to configure the replace
   * @param resultHandler will be called when complete
   */
  @Deprecated @Fluent
  MongoClient replaceWithOptions(String collection, JsonObject query, JsonObject replace, UpdateOptions options, Handler<AsyncResult<Void>> resultHandler);

  Replace matching documents in the specified collection, specifying options and return the handler with MongoClientUpdateResult result
Params: collection –  the collection
query –  query used to match the documents
replace –  all matching documents will be replaced with this
options – options to configure the replace
resultHandler – will be called when complete/**
   * Replace matching documents in the specified collection, specifying options and return the handler with MongoClientUpdateResult result
   *
   * @param collection  the collection
   * @param query  query used to match the documents
   * @param replace  all matching documents will be replaced with this
   * @param options options to configure the replace
   * @param resultHandler will be called when complete
   */
  @Fluent
  MongoClient replaceDocumentsWithOptions(String collection, JsonObject query, JsonObject replace, UpdateOptions options, Handler<AsyncResult<@Nullable MongoClientUpdateResult>> resultHandler);

  Execute a bulk operation. Can insert, update, replace, and/or delete multiple documents with one request.
Params: collection – 
         the collection
operations – 
         the operations to execute
resultHandler –  will be called with a MongoClientBulkWriteResult when complete/**
   * Execute a bulk operation. Can insert, update, replace, and/or delete multiple documents with one request.
   *
   * @param collection
   *          the collection
   * @param operations
   *          the operations to execute
   * @param resultHandler
   *          will be called with a {@link MongoClientBulkWriteResult} when complete
   */
  @Fluent
  MongoClient bulkWrite(String collection, List<BulkOperation> operations,
                        Handler<AsyncResult<@Nullable MongoClientBulkWriteResult>> resultHandler);

  Execute a bulk operation with the specified write options. Can insert, update, replace, and/or delete multiple
documents with one request.
Params: collection – 
         the collection
operations – 
         the operations to execute
bulkWriteOptions – 
         the write options
resultHandler –  will be called with a MongoClientBulkWriteResult when complete/**
   * Execute a bulk operation with the specified write options. Can insert, update, replace, and/or delete multiple
   * documents with one request.
   *
   * @param collection
   *          the collection
   * @param operations
   *          the operations to execute
   * @param bulkWriteOptions
   *          the write options
   * @param resultHandler
   *          will be called with a {@link MongoClientBulkWriteResult} when complete
   */
  @Fluent
  MongoClient bulkWriteWithOptions(String collection, List<BulkOperation> operations, BulkWriteOptions bulkWriteOptions,
                                   Handler<AsyncResult<@Nullable MongoClientBulkWriteResult>> resultHandler);

  Find matching documents in the specified collection
Params: collection –  the collection
query –  query used to match documents
resultHandler –  will be provided with list of documents/**
   * Find matching documents in the specified collection
   *
   * @param collection  the collection
   * @param query  query used to match documents
   * @param resultHandler  will be provided with list of documents
   */
  @Fluent
  MongoClient find(String collection, JsonObject query, Handler<AsyncResult<List<JsonObject>>> resultHandler);

  Find matching documents in the specified collection.
This method use batchCursor for returning each found document.
Params: collection –  the collection
query –  query used to match documents
Returns: a ReadStream emitting found documents/**
   * Find matching documents in the specified collection.
   * This method use batchCursor for returning each found document.
   *
   * @param collection  the collection
   * @param query  query used to match documents
   * @return a {@link ReadStream} emitting found documents
   */
  ReadStream<JsonObject> findBatch(String collection, JsonObject query);

  Find matching documents in the specified collection, specifying options
Params: collection –  the collection
query –  query used to match documents
options – options to configure the find
resultHandler –  will be provided with list of documents/**
   * Find matching documents in the specified collection, specifying options
   *
   * @param collection  the collection
   * @param query  query used to match documents
   * @param options options to configure the find
   * @param resultHandler  will be provided with list of documents
   */
  @Fluent
  MongoClient findWithOptions(String collection, JsonObject query, FindOptions options, Handler<AsyncResult<List<JsonObject>>> resultHandler);

  Find matching documents in the specified collection, specifying options.
This method use batchCursor for returning each found document.
Params: collection –  the collection
query –  query used to match documents
options – options to configure the find
Returns: a ReadStream emitting found documents/**
   * Find matching documents in the specified collection, specifying options.
   * This method use batchCursor for returning each found document.
   *
   * @param collection  the collection
   * @param query  query used to match documents
   * @param options options to configure the find
   * @return a {@link ReadStream} emitting found documents
   */
  ReadStream<JsonObject> findBatchWithOptions(String collection, JsonObject query, FindOptions options);

  Find a single matching document in the specified collection

This operation might change _id field of query parameter
Params: collection –  the collection
query –  the query used to match the document
fields –  the fields
resultHandler – will be provided with the document, if any/**
   * Find a single matching document in the specified collection
   * <p>
   * This operation might change <i>_id</i> field of <i>query</i> parameter
   *
   * @param collection  the collection
   * @param query  the query used to match the document
   * @param fields  the fields
   * @param resultHandler will be provided with the document, if any
   */
  @Fluent
  MongoClient findOne(String collection, JsonObject query, @Nullable JsonObject fields, Handler<AsyncResult<@Nullable JsonObject>> resultHandler);

  Find a single matching document in the specified collection and update it.

This operation might change _id field of query parameter
Params: collection –  the collection
query –  the query used to match the document
update – used to describe how the documents will be updated
resultHandler – will be provided with the document, if any/**
   * Find a single matching document in the specified collection and update it.
   * <p>
   * This operation might change <i>_id</i> field of <i>query</i> parameter
   *
   * @param collection  the collection
   * @param query  the query used to match the document
   * @param update used to describe how the documents will be updated
   * @param resultHandler will be provided with the document, if any
   */
  @Fluent
  MongoClient findOneAndUpdate(String collection, JsonObject query, JsonObject update, Handler<AsyncResult<@Nullable JsonObject>> resultHandler);

  Find a single matching document in the specified collection and update it.

This operation might change _id field of query parameter
Params: collection –  the collection
query –  the query used to match the document
update – used to describe how the documents will be updated
findOptions – options to configure the find
updateOptions – options to configure the update
resultHandler – will be provided with the document, if any/**
   * Find a single matching document in the specified collection and update it.
   * <p>
   * This operation might change <i>_id</i> field of <i>query</i> parameter
   *
   * @param collection  the collection
   * @param query  the query used to match the document
   * @param update used to describe how the documents will be updated
   * @param findOptions options to configure the find
   * @param updateOptions options to configure the update
   * @param resultHandler will be provided with the document, if any
   */
  @Fluent
  MongoClient findOneAndUpdateWithOptions(String collection, JsonObject query, JsonObject update, FindOptions findOptions, UpdateOptions updateOptions, Handler<AsyncResult<@Nullable JsonObject>> resultHandler);

  Find a single matching document in the specified collection and replace it.

This operation might change _id field of query parameter
Params: collection –  the collection
query –  the query used to match the document
replace –  the replacement document
resultHandler – will be provided with the document, if any/**
   * Find a single matching document in the specified collection and replace it.
   * <p>
   * This operation might change <i>_id</i> field of <i>query</i> parameter
   *
   * @param collection  the collection
   * @param query  the query used to match the document
   * @param replace  the replacement document
   * @param resultHandler will be provided with the document, if any
   */
  @Fluent
  MongoClient findOneAndReplace(String collection, JsonObject query, JsonObject replace, Handler<AsyncResult<@Nullable JsonObject>> resultHandler);

  Find a single matching document in the specified collection and replace it.

This operation might change _id field of query parameter
Params: collection –  the collection
query –  the query used to match the document
replace –  the replacement document
findOptions – options to configure the find
updateOptions – options to configure the update
resultHandler – will be provided with the document, if any/**
   * Find a single matching document in the specified collection and replace it.
   * <p>
   * This operation might change <i>_id</i> field of <i>query</i> parameter
   *
   * @param collection  the collection
   * @param query  the query used to match the document
   * @param replace  the replacement document
   * @param findOptions options to configure the find
   * @param updateOptions options to configure the update
   * @param resultHandler will be provided with the document, if any
   */
  @Fluent
  MongoClient findOneAndReplaceWithOptions(String collection, JsonObject query, JsonObject replace, FindOptions findOptions, UpdateOptions updateOptions, Handler<AsyncResult<@Nullable JsonObject>> resultHandler);

  Find a single matching document in the specified collection and delete it.

This operation might change _id field of query parameter
Params: collection –  the collection
query –  the query used to match the document
resultHandler – will be provided with the deleted document, if any/**
   * Find a single matching document in the specified collection and delete it.
   * <p>
   * This operation might change <i>_id</i> field of <i>query</i> parameter
   *
   * @param collection  the collection
   * @param query  the query used to match the document
   * @param resultHandler will be provided with the deleted document, if any
   */
  @Fluent
  MongoClient findOneAndDelete(String collection, JsonObject query, Handler<AsyncResult<@Nullable JsonObject>> resultHandler);

  Find a single matching document in the specified collection and delete it.

This operation might change _id field of query parameter
Params: collection –  the collection
query –  the query used to match the document
findOptions – options to configure the find
resultHandler – will be provided with the deleted document, if any/**
   * Find a single matching document in the specified collection and delete it.
   * <p>
   * This operation might change <i>_id</i> field of <i>query</i> parameter
   *
   * @param collection  the collection
   * @param query  the query used to match the document
   * @param findOptions options to configure the find
   * @param resultHandler will be provided with the deleted document, if any
   */
  @Fluent
  MongoClient findOneAndDeleteWithOptions(String collection, JsonObject query, FindOptions findOptions, Handler<AsyncResult<@Nullable JsonObject>> resultHandler);

  Count matching documents in a collection.
Params: collection –  the collection
query –  query used to match documents
resultHandler – will be provided with the number of matching documents/**
   * Count matching documents in a collection.
   *
   * @param collection  the collection
   * @param query  query used to match documents
   * @param resultHandler will be provided with the number of matching documents
   */
  @Fluent
  MongoClient count(String collection, JsonObject query, Handler<AsyncResult<Long>> resultHandler);

  Remove matching documents from a collection
Params: collection –  the collection
query –  query used to match documents
resultHandler – will be called when complete/**
   * Remove matching documents from a collection
   *
   * @param collection  the collection
   * @param query  query used to match documents
   * @param resultHandler will be called when complete
   */
  @Deprecated @Fluent
  MongoClient remove(String collection, JsonObject query, Handler<AsyncResult<Void>> resultHandler);

  Remove matching documents from a collection and return the handler with MongoClientDeleteResult result
Params: collection –  the collection
query –  query used to match documents
resultHandler – will be called when complete/**
   * Remove matching documents from a collection and return the handler with MongoClientDeleteResult result
   *
   * @param collection  the collection
   * @param query  query used to match documents
   * @param resultHandler will be called when complete
   */
  @Fluent
  MongoClient removeDocuments(String collection, JsonObject query, Handler<AsyncResult<@Nullable MongoClientDeleteResult>> resultHandler);

  Remove matching documents from a collection with the specified write option
Params: collection –  the collection
query –  query used to match documents
writeOption –  the write option to use
resultHandler – will be called when complete/**
   * Remove matching documents from a collection with the specified write option
   *
   * @param collection  the collection
   * @param query  query used to match documents
   * @param writeOption  the write option to use
   * @param resultHandler will be called when complete
   */
  @Deprecated @Fluent
  MongoClient removeWithOptions(String collection, JsonObject query, WriteOption writeOption, Handler<AsyncResult<Void>> resultHandler);

  Remove matching documents from a collection with the specified write option and return the handler with MongoClientDeleteResult result
Params: collection –  the collection
query –  query used to match documents
writeOption –  the write option to use
resultHandler – will be called when complete/**
   * Remove matching documents from a collection with the specified write option and return the handler with MongoClientDeleteResult result
   *
   * @param collection  the collection
   * @param query  query used to match documents
   * @param writeOption  the write option to use
   * @param resultHandler will be called when complete
   */
  @Fluent
  MongoClient removeDocumentsWithOptions(String collection, JsonObject query, @Nullable WriteOption writeOption, Handler<AsyncResult<@Nullable MongoClientDeleteResult>> resultHandler);

  Remove a single matching document from a collection
Params: collection –  the collection
query –  query used to match document
resultHandler – will be called when complete/**
   * Remove a single matching document from a collection
   *
   * @param collection  the collection
   * @param query  query used to match document
   * @param resultHandler will be called when complete
   */
  @Deprecated @Fluent
  MongoClient removeOne(String collection, JsonObject query, Handler<AsyncResult<Void>> resultHandler);

  Remove a single matching document from a collection and return the handler with MongoClientDeleteResult result
Params: collection –  the collection
query –  query used to match document
resultHandler – will be called when complete/**
   * Remove a single matching document from a collection and return the handler with MongoClientDeleteResult result
   *
   * @param collection  the collection
   * @param query  query used to match document
   * @param resultHandler will be called when complete
   */
  @Fluent
  MongoClient removeDocument(String collection, JsonObject query, Handler<AsyncResult<@Nullable MongoClientDeleteResult>> resultHandler);

  Remove a single matching document from a collection with the specified write option
Params: collection –  the collection
query –  query used to match document
writeOption –  the write option to use
resultHandler – will be called when complete/**
   * Remove a single matching document from a collection with the specified write option
   *
   * @param collection  the collection
   * @param query  query used to match document
   * @param writeOption  the write option to use
   * @param resultHandler will be called when complete
   */
  @Deprecated @Fluent
  MongoClient removeOneWithOptions(String collection, JsonObject query, WriteOption writeOption, Handler<AsyncResult<Void>> resultHandler);

  Remove a single matching document from a collection with the specified write option and return the handler with MongoClientDeleteResult result
Params: collection –  the collection
query –  query used to match document
writeOption –  the write option to use
resultHandler – will be called when complete/**
   * Remove a single matching document from a collection with the specified write option and return the handler with MongoClientDeleteResult result
   *
   * @param collection  the collection
   * @param query  query used to match document
   * @param writeOption  the write option to use
   * @param resultHandler will be called when complete
   */
  @Fluent
  MongoClient removeDocumentWithOptions(String collection, JsonObject query, @Nullable WriteOption writeOption, Handler<AsyncResult<@Nullable MongoClientDeleteResult>> resultHandler);

  Create a new collection
Params: collectionName –  the name of the collection
resultHandler –  will be called when complete/**
   * Create a new collection
   *
   * @param collectionName  the name of the collection
   * @param resultHandler  will be called when complete
   */
  @Fluent
  MongoClient createCollection(String collectionName, Handler<AsyncResult<Void>> resultHandler);

  Get a list of all collections in the database.
Params: resultHandler –  will be called with a list of collections./**
   * Get a list of all collections in the database.
   *
   * @param resultHandler  will be called with a list of collections.
   */
  @Fluent
  MongoClient getCollections(Handler<AsyncResult<List<String>>> resultHandler);

  Drop a collection
Params: collection –  the collection
resultHandler – will be called when complete/**
   * Drop a collection
   *
   * @param collection  the collection
   * @param resultHandler will be called when complete
   */
  @Fluent
  MongoClient dropCollection(String collection, Handler<AsyncResult<Void>> resultHandler);

  Creates an index.
Params: collection –  the collection
key –  A document that contains the field and value pairs where the field is the index key and the value
            describes the type of index for that field. For an ascending index on a field,
            specify a value of 1; for descending index, specify a value of -1.
resultHandler – will be called when complete/**
   * Creates an index.
   *
   * @param collection  the collection
   * @param key  A document that contains the field and value pairs where the field is the index key and the value
   *             describes the type of index for that field. For an ascending index on a field,
   *             specify a value of 1; for descending index, specify a value of -1.
   * @param resultHandler will be called when complete
   */
  @Fluent
  MongoClient createIndex(String collection, JsonObject key, Handler<AsyncResult<Void>> resultHandler);

  Creates an index.
Params: collection –  the collection
key –  A document that contains the field and value pairs where the field is the index key and the value
            describes the type of index for that field. For an ascending index on a field,
            specify a value of 1; for descending index, specify a value of -1.
options –  the options for the index
resultHandler – will be called when complete/**
   * Creates an index.
   *
   * @param collection  the collection
   * @param key  A document that contains the field and value pairs where the field is the index key and the value
   *             describes the type of index for that field. For an ascending index on a field,
   *             specify a value of 1; for descending index, specify a value of -1.
   * @param options  the options for the index
   * @param resultHandler will be called when complete
   */
  @Fluent
  MongoClient createIndexWithOptions(String collection, JsonObject key, IndexOptions options, Handler<AsyncResult<Void>> resultHandler);

  Get all the indexes in this collection.
Params: collection –  the collection
resultHandler – will be called when complete/**
   * Get all the indexes in this collection.
   *
   * @param collection  the collection
   * @param resultHandler will be called when complete
   */
  @Fluent
  MongoClient listIndexes(String collection, Handler<AsyncResult<JsonArray>> resultHandler);

  Drops the index given its name.
Params: collection –  the collection
indexName – the name of the index to remove
resultHandler – will be called when complete/**
   * Drops the index given its name.
   *
   * @param collection  the collection
   * @param indexName the name of the index to remove
   * @param resultHandler will be called when complete
   */
  @Fluent
  MongoClient dropIndex(String collection, String indexName, Handler<AsyncResult<Void>> resultHandler);

  Run an arbitrary MongoDB command.
Params: commandName –  the name of the command
command –  the command
resultHandler –  will be called with the result./**
   * Run an arbitrary MongoDB command.
   *
   * @param commandName  the name of the command
   * @param command  the command
   * @param resultHandler  will be called with the result.
   */
  @Fluent
  MongoClient runCommand(String commandName, JsonObject command, Handler<AsyncResult<@Nullable JsonObject>> resultHandler);

  Gets the distinct values of the specified field name.
Return a JsonArray containing distinct values (eg: [ 1 , 89 ])
Params: collection –  the collection
fieldName –  the field name
resultHandler –  will be provided with array of values./**
   * Gets the distinct values of the specified field name.
   * Return a JsonArray containing distinct values (eg: [ 1 , 89 ])
   *
   * @param collection  the collection
   * @param fieldName  the field name
   * @param resultHandler  will be provided with array of values.
   */
  @Fluent
  MongoClient distinct(String collection, String fieldName, String resultClassname, Handler<AsyncResult<JsonArray>> resultHandler);

  Gets the distinct values of the specified field name filtered by specified query.
Return a JsonArray containing distinct values (eg: [ 1 , 89 ])
Params: collection –  the collection
fieldName –  the field name
query – the query
resultHandler –  will be provided with array of values./**
   * Gets the distinct values of the specified field name filtered by specified query.
   * Return a JsonArray containing distinct values (eg: [ 1 , 89 ])
   *
   * @param collection  the collection
   * @param fieldName  the field name
   * @param query the query
   * @param resultHandler  will be provided with array of values.
   */
  @Fluent
  MongoClient distinctWithQuery(String collection, String fieldName, String resultClassname, JsonObject query, Handler<AsyncResult<JsonArray>> resultHandler);

  Gets the distinct values of the specified field name.
This method use batchCursor for returning each found value.
Each value is a json fragment with fieldName key (eg: {"num": 1}).
Params: collection –  the collection
fieldName –  the field name
Returns: a ReadStream emitting json fragments/**
   * Gets the distinct values of the specified field name.
   * This method use batchCursor for returning each found value.
   * Each value is a json fragment with fieldName key (eg: {"num": 1}).
   *
   * @param collection  the collection
   * @param fieldName  the field name
   * @return a {@link ReadStream} emitting json fragments
   */
  ReadStream<JsonObject> distinctBatch(String collection, String fieldName, String resultClassname);

  Gets the distinct values of the specified field name filtered by specified query.
This method use batchCursor for returning each found value.
Each value is a json fragment with fieldName key (eg: {"num": 1}).
Params: collection –  the collection
fieldName –  the field name
query – the query
Returns: a ReadStream emitting json fragments/**
   * Gets the distinct values of the specified field name filtered by specified query.
   * This method use batchCursor for returning each found value.
   * Each value is a json fragment with fieldName key (eg: {"num": 1}).
   *
   * @param collection  the collection
   * @param fieldName  the field name
   * @param query the query
   * @return a {@link ReadStream} emitting json fragments
   */
  ReadStream<JsonObject> distinctBatchWithQuery(String collection, String fieldName, String resultClassname, JsonObject query);

  Gets the distinct values of the specified field name filtered by specified query.
This method use batchCursor for returning each found value.
Each value is a json fragment with fieldName key (eg: {"num": 1}).
Params: collection – the collection
fieldName –  the field name
query –      the query
batchSize –  the number of documents to load in a batch
Returns: a ReadStream emitting json fragments/**
   * Gets the distinct values of the specified field name filtered by specified query.
   * This method use batchCursor for returning each found value.
   * Each value is a json fragment with fieldName key (eg: {"num": 1}).
   *
   * @param collection the collection
   * @param fieldName  the field name
   * @param query      the query
   * @param batchSize  the number of documents to load in a batch
   * @return a {@link ReadStream} emitting json fragments
   */
  ReadStream<JsonObject> distinctBatchWithQuery(String collection, String fieldName, String resultClassname, JsonObject query, int batchSize);


  Run aggregate MongoDB command with default AggregateOptions. 
Params: collection – the collection
pipeline –   aggregation pipeline to be executed/**
   * Run aggregate MongoDB command with default {@link AggregateOptions}.
   *
   * @param collection the collection
   * @param pipeline   aggregation pipeline to be executed
   */
  ReadStream<JsonObject> aggregate(final String collection, final JsonArray pipeline);

  Run aggregate MongoDB command.
Params: collection – the collection
pipeline –   aggregation pipeline to be executed
options –    options to configure the aggregation command/**
   * Run aggregate MongoDB command.
   *
   * @param collection the collection
   * @param pipeline   aggregation pipeline to be executed
   * @param options    options to configure the aggregation command
   */
  ReadStream<JsonObject> aggregateWithOptions(String collection, final JsonArray pipeline, final AggregateOptions options);

  Close the client and release its resources
/**
   * Close the client and release its resources
   */
  void close();

}
Params:	vertx – the Vert.x instance config – the configuration
Returns:	the client
Params:	collection – the collection query – query used to match documents
Returns:	a `ReadStream` emitting found documents
Params:	collection – the collection fieldName – the field name
Returns:	a `ReadStream` emitting json fragments
/

io.vertx/ vertx-mongo-client/ 3.8.0/ io/vertx/ext/mongo/MongoClient.java
