AbstractMongoCollection (mongodb-async-driver 1.2.2 API)

java.lang.Object
- com.allanbank.mongodb.client.AbstractMongoCollection

All Implemented Interfaces:

MongoCollection

Direct Known Subclasses:

MongoCollectionImpl
```
public abstract class AbstractMongoCollection
extends Object
implements MongoCollection
```
Helper class for forward all methods to the canonical version (which is abstract in this class).
This class keeps the clutter in the derived class to a minimum and also deals with the conversion of the asynchronous method invocations into synchronous methods for those uses cases that do not require an asynchronous interface.

API Warning:

This class is NOT part of the drivers API. This class may be mutated in incompatible ways between any two releases of the driver.

Copyright ©:

2011-2013, Allanbank Consulting, Inc., All Rights Reserved

Nested Class Summary
- Nested classes/interfaces inherited from interface com.allanbank.mongodb.MongoCollection
  MongoCollection.ValidateMode

Field Summary

Fields
Modifier and Type	Field and Description
`static boolean`	`DELETE_SINGLE_DELETE_DEFAULT` The default for if a delete should only delete the first document it matches.
`static Document`	`EMPTY_INDEX_OPTIONS` The default empty index options.
`static boolean`	`INSERT_CONTINUE_ON_ERROR_DEFAULT` The default for if an insert should continue on an error.
`protected Client`	`myClient` The client for interacting with MongoDB.
`protected MongoDatabase`	`myDatabase` The name of the database we interact with.
`protected String`	`myName` The name of the collection we interact with.
`static Document`	`UNIQUE_INDEX_OPTIONS` The default for a UNIQUE index options.
`static boolean`	`UPDATE_MULTIUPDATE_DEFAULT` The default for doing a multiple-update on an update.
`static boolean`	`UPDATE_UPSERT_DEFAULT` The default for doing an upsert on an update.

Fields inherited from interface com.allanbank.mongodb.MongoCollection
ALL

Constructor Summary

Constructors
Constructor and Description
`AbstractMongoCollection(Client client, MongoDatabase database, String name)` Create a new AbstractMongoCollection.

Method Summary

Methods
Modifier and Type	Method and Description
`List<Document>`	`aggregate(Aggregate.Builder command)` Invokes a aggregate command on the server.
`List<Document>`	`aggregate(Aggregate command)` Invokes a aggregate command on the server.
`Future<List<Document>>`	`aggregateAsync(Aggregate.Builder command)` Invokes a aggregate command on the server.
`Future<List<Document>>`	`aggregateAsync(Aggregate command)` Invokes a aggregate command on the server.
`void`	`aggregateAsync(Callback<List<Document>> results, Aggregate.Builder command)` Invokes a aggregate command on the server.
`abstract void`	`aggregateAsync(Callback<List<Document>> results, Aggregate command)` Invokes a aggregate command on the server.
`protected GetLastError`	`asGetLastError(Durability durability)` Converts the `Durability` into a `GetLastError` command.
`protected String`	`buildIndexName(Element... keys)` Generates a name for the index based on the keys.
`long`	`count()` Counts the set of documents in the collection.
`long`	`count(DocumentAssignable query)` Counts the set of documents matching the query document in the collection.
`long`	`count(DocumentAssignable query, ReadPreference readPreference)` Counts the set of documents matching the query document in the collection.
`long`	`count(ReadPreference readPreference)` Counts the set of documents in the collection.
`Future<Long>`	`countAsync()` Counts the set of documents in the collection.
`void`	`countAsync(Callback<Long> results)` Counts the set of documents in the collection.
`void`	`countAsync(Callback<Long> results, DocumentAssignable query)` Counts the set of documents matching the query document in the collection.
`abstract void`	`countAsync(Callback<Long> results, DocumentAssignable query, ReadPreference readPreference)` Counts the set of documents matching the query document in the collection.
`void`	`countAsync(Callback<Long> results, ReadPreference readPreference)` Counts the set of documents in the collection.
`Future<Long>`	`countAsync(DocumentAssignable query)` Counts the set of documents matching the query document in the collection.
`Future<Long>`	`countAsync(DocumentAssignable query, ReadPreference readPreference)` Counts the set of documents matching the query document in the collection.
`Future<Long>`	`countAsync(ReadPreference readPreference)` Counts the set of documents in the collection.
`void`	`createIndex(boolean unique, Element... keys)` Creates an index with a generated name, across the keys specified and if `unique` is true ensuring entries are unique.
`void`	`createIndex(DocumentAssignable options, Element... keys)` Creates an index with a generated name, across the keys specified allowing duplicate entries.
`void`	`createIndex(Element... keys)` Creates an index with a generated name, across the keys specified allowing duplicate entries.
`void`	`createIndex(String name, boolean unique, Element... keys)` Creates an index with the specified name, across the keys specified and if `unique` is true ensuring entries are unique.
`abstract void`	`createIndex(String name, DocumentAssignable options, Element... keys)` Creates an index with a generated name, across the keys specified allowing duplicate entries.
`long`	`delete(DocumentAssignable query)` Deletes a set of documents matching a query from the collection.
`long`	`delete(DocumentAssignable query, boolean singleDelete)` Deletes a set of documents matching a query from the collection.
`long`	`delete(DocumentAssignable query, boolean singleDelete, Durability durability)` Deletes a set of documents matching a query from the collection.
`long`	`delete(DocumentAssignable query, Durability durability)` Deletes a set of documents matching a query from the collection.
`void`	`deleteAsync(Callback<Long> results, DocumentAssignable query)` Deletes a set of documents matching a query from the collection.
`void`	`deleteAsync(Callback<Long> results, DocumentAssignable query, boolean singleDelete)` Deletes a set of documents matching a query from the collection.
`abstract void`	`deleteAsync(Callback<Long> results, DocumentAssignable query, boolean singleDelete, Durability durability)` Deletes a set of documents matching a query from the collection.
`void`	`deleteAsync(Callback<Long> results, DocumentAssignable query, Durability durability)` Deletes a set of documents matching a query from the collection.
`Future<Long>`	`deleteAsync(DocumentAssignable query)` Deletes a set of documents matching a query from the collection.
`Future<Long>`	`deleteAsync(DocumentAssignable query, boolean singleDelete)` Deletes a set of documents matching a query from the collection.
`Future<Long>`	`deleteAsync(DocumentAssignable query, boolean singleDelete, Durability durability)` Deletes a set of documents matching a query from the collection.
`Future<Long>`	`deleteAsync(DocumentAssignable query, Durability durability)` Deletes a set of documents matching a query from the collection.
`ArrayElement`	`distinct(Distinct.Builder command)` Invokes a distinct command on the server.
`ArrayElement`	`distinct(Distinct command)` Invokes a distinct command on the server.
`void`	`distinctAsync(Callback<ArrayElement> results, Distinct.Builder command)` Invokes a distinct command on the server.
`abstract void`	`distinctAsync(Callback<ArrayElement> results, Distinct command)` Invokes a distinct command on the server.
`Future<ArrayElement>`	`distinctAsync(Distinct.Builder command)` Invokes a distinct command on the server.
`Future<ArrayElement>`	`distinctAsync(Distinct command)` Invokes a distinct command on the server.
`boolean`	`dropIndex(IntegerElement... keys)` Deletes the indexes matching the keys specified.
`abstract boolean`	`dropIndex(String name)` Deletes the indexes with the provided name.
`Document`	`explain(DocumentAssignable query)` Explains the way that the document will be performed.
`Document`	`explain(Find.Builder query)` Explains the way that the document will be performed.
`Document`	`explain(Find query)` Explains the way that the document will be performed.
`void`	`explainAsync(Callback<Document> results, Find.Builder query)` Explains the way that the document will be performed.
`abstract void`	`explainAsync(Callback<Document> results, Find query)` Explains the way that the document will be performed.
`Future<Document>`	`explainAsync(Find.Builder query)` Explains the way that the document will be performed.
`Future<Document>`	`explainAsync(Find query)` Explains the way that the document will be performed.
`MongoIterator<Document>`	`find(DocumentAssignable query)` Finds the set of documents matching the query document in the collection.
`MongoIterator<Document>`	`find(Find.Builder query)` Finds the set of documents matching the query in the collection.
`MongoIterator<Document>`	`find(Find query)` Finds the set of documents matching the query in the collection.
`Document`	`findAndModify(FindAndModify.Builder command)` Invokes a findAndModify command on the server.
`Document`	`findAndModify(FindAndModify command)` Invokes a findAndModify command on the server.
`void`	`findAndModifyAsync(Callback<Document> results, FindAndModify.Builder command)` Invokes a findAndModify command on the server.
`abstract void`	`findAndModifyAsync(Callback<Document> results, FindAndModify command)` Invokes a findAndModify command on the server.
`Future<Document>`	`findAndModifyAsync(FindAndModify.Builder command)` Invokes a findAndModify command on the server.
`Future<Document>`	`findAndModifyAsync(FindAndModify command)` Invokes a findAndModify command on the server.
`void`	`findAsync(Callback<MongoIterator<Document>> results, DocumentAssignable query)` Finds the set of documents matching the query document in the collection.
`void`	`findAsync(Callback<MongoIterator<Document>> results, Find.Builder query)` Finds the set of documents matching the query in the collection.
`abstract void`	`findAsync(Callback<MongoIterator<Document>> results, Find query)` Finds the set of documents matching the query in the collection.
`Future<MongoIterator<Document>>`	`findAsync(DocumentAssignable query)` Finds the set of documents matching the query document in the collection.
`Future<MongoIterator<Document>>`	`findAsync(Find.Builder query)` Finds the set of documents matching the query in the collection.
`Future<MongoIterator<Document>>`	`findAsync(Find query)` Finds the set of documents matching the query in the collection.
`Document`	`findOne(DocumentAssignable query)` Finds a single matching document in the collection.
`Document`	`findOne(Find.Builder query)` Finds a single matching document in the collection.
`Document`	`findOne(Find query)` Overridden to call the `findOneAsync(Callback, Find)`.
`void`	`findOneAsync(Callback<Document> results, DocumentAssignable query)` Finds a single matching document in the collection.
`void`	`findOneAsync(Callback<Document> results, Find.Builder query)` Finds a single matching document in the collection.
`abstract void`	`findOneAsync(Callback<Document> results, Find query)` Finds a single matching document in the collection.
`Future<Document>`	`findOneAsync(DocumentAssignable query)` Finds a single matching document in the collection.
`Future<Document>`	`findOneAsync(Find.Builder query)` Finds a single matching document in the collection.
`Future<Document>`	`findOneAsync(Find query)` Finds a single matching document in the collection.
`String`	`getDatabaseName()` Returns the name of the database.
`Durability`	`getDurability()` Returns the durability for write operations sent to the server from this `MongoCollection` instance.
`String`	`getName()` Returns the name of the collection.
`ReadPreference`	`getReadPreference()` Returns the read preference for queries from this `MongoCollection` instance.
`ArrayElement`	`groupBy(GroupBy.Builder command)` Invokes a group command on the server.
`ArrayElement`	`groupBy(GroupBy command)` Invokes a group command on the server.
`void`	`groupByAsync(Callback<ArrayElement> results, GroupBy.Builder command)` Invokes a group command on the server.
`abstract void`	`groupByAsync(Callback<ArrayElement> results, GroupBy command)` Invokes a group command on the server.
`Future<ArrayElement>`	`groupByAsync(GroupBy.Builder command)` Invokes a group command on the server.
`Future<ArrayElement>`	`groupByAsync(GroupBy command)` Invokes a group command on the server.
`int`	`insert(boolean continueOnError, DocumentAssignable... documents)` Inserts a set of documents into the collection.
`int`	`insert(boolean continueOnError, Durability durability, DocumentAssignable... documents)` Inserts a set of documents into the collection.
`int`	`insert(DocumentAssignable... documents)` Inserts a set of documents into the collection.
`int`	`insert(Durability durability, DocumentAssignable... documents)` Inserts a set of documents into the collection.
`Future<Integer>`	`insertAsync(boolean continueOnError, DocumentAssignable... documents)` Inserts a set of documents into the collection.
`Future<Integer>`	`insertAsync(boolean continueOnError, Durability durability, DocumentAssignable... documents)` Inserts a set of documents into the collection.
`void`	`insertAsync(Callback<Integer> results, boolean continueOnError, DocumentAssignable... documents)` Inserts a set of documents into the collection.
`abstract void`	`insertAsync(Callback<Integer> results, boolean continueOnError, Durability durability, DocumentAssignable... documents)` Inserts a set of documents into the collection.
`void`	`insertAsync(Callback<Integer> results, DocumentAssignable... documents)` Inserts a set of documents into the collection.
`void`	`insertAsync(Callback<Integer> results, Durability durability, DocumentAssignable... documents)` Inserts a set of documents into the collection.
`Future<Integer>`	`insertAsync(DocumentAssignable... documents)` Inserts a set of documents into the collection.
`Future<Integer>`	`insertAsync(Durability durability, DocumentAssignable... documents)` Inserts a set of documents into the collection.
`List<Document>`	`mapReduce(MapReduce.Builder command)` Invokes a mapReduce command on the server.
`List<Document>`	`mapReduce(MapReduce command)` Invokes a mapReduce command on the server.
`void`	`mapReduceAsync(Callback<List<Document>> results, MapReduce.Builder command)` Invokes a mapReduce command on the server.
`abstract void`	`mapReduceAsync(Callback<List<Document>> results, MapReduce command)` Invokes a mapReduce command on the server.
`Future<List<Document>>`	`mapReduceAsync(MapReduce.Builder command)` Invokes a mapReduce command on the server.
`Future<List<Document>>`	`mapReduceAsync(MapReduce command)` Invokes a mapReduce command on the server.
`int`	`save(DocumentAssignable document)` Saves the `document` to the collection.
`int`	`save(DocumentAssignable document, Durability durability)` Saves the `document` to the collection.
`void`	`saveAsync(Callback<Integer> results, DocumentAssignable document)` Saves the `document` to the collection.
`abstract void`	`saveAsync(Callback<Integer> results, DocumentAssignable document, Durability durability)` Saves the `document` to the collection.
`Future<Integer>`	`saveAsync(DocumentAssignable document)` Saves the `document` to the collection.
`Future<Integer>`	`saveAsync(DocumentAssignable document, Durability durability)` Saves the `document` to the collection.
`void`	`setDurability(Durability durability)` Sets the durability for write operations from this `MongoCollection` instance.
`void`	`setReadPreference(ReadPreference readPreference)` Sets the value of the read preference for a queries from this `MongoCollection` instance.
`MongoCursorControl`	`streamingFind(Callback<Document> results, DocumentAssignable query)` Deprecated.
`MongoCursorControl`	`streamingFind(Callback<Document> results, Find query)` Deprecated.
`MongoCursorControl`	`streamingFind(StreamCallback<Document> results, DocumentAssignable query)` Finds the set of documents matching the query document in the collection and streams them to the provided callback one at a time.
`MongoCursorControl`	`streamingFind(StreamCallback<Document> results, Find.Builder query)` Finds the set of documents matching the query in the collection and streams them to the provided callback one at a time.
`abstract MongoCursorControl`	`streamingFind(StreamCallback<Document> results, Find query)` Finds the set of documents matching the query in the collection and streams them to the provided callback one at a time.
`List<TextResult>`	`textSearch(Text.Builder command)` Invokes a `text` command on the server.
`List<TextResult>`	`textSearch(Text command)` Invokes a `text` command on the server.
`void`	`textSearchAsync(Callback<List<TextResult>> results, Text.Builder command)` Invokes a `text` command on the server.
`abstract void`	`textSearchAsync(Callback<List<TextResult>> results, Text command)` Invokes a `text` command on the server.
`Future<List<TextResult>>`	`textSearchAsync(Text.Builder command)` Invokes a `text` command on the server.
`Future<List<TextResult>>`	`textSearchAsync(Text command)` Invokes a `text` command on the server.
`long`	`update(DocumentAssignable query, DocumentAssignable update)` Applies updates to a set of documents within the collection.
`long`	`update(DocumentAssignable query, DocumentAssignable update, boolean multiUpdate, boolean upsert)` Applies updates to a set of documents within the collection.
`long`	`update(DocumentAssignable query, DocumentAssignable update, boolean multiUpdate, boolean upsert, Durability durability)` Applies updates to a set of documents within the collection.
`long`	`update(DocumentAssignable query, DocumentAssignable update, Durability durability)` Applies updates to a set of documents within the collection.
`void`	`updateAsync(Callback<Long> results, DocumentAssignable query, DocumentAssignable update)` Applies updates to a set of documents within the collection.
`void`	`updateAsync(Callback<Long> results, DocumentAssignable query, DocumentAssignable update, boolean multiUpdate, boolean upsert)` Applies updates to a set of documents within the collection.
`abstract void`	`updateAsync(Callback<Long> results, DocumentAssignable query, DocumentAssignable update, boolean multiUpdate, boolean upsert, Durability durability)` Applies updates to a set of documents within the collection.
`void`	`updateAsync(Callback<Long> results, DocumentAssignable query, DocumentAssignable update, Durability durability)` Applies updates to a set of documents within the collection.
`Future<Long>`	`updateAsync(DocumentAssignable query, DocumentAssignable update)` Applies updates to a set of documents within the collection.
`Future<Long>`	`updateAsync(DocumentAssignable query, DocumentAssignable update, boolean multiUpdate, boolean upsert)` Applies updates to a set of documents within the collection.
`Future<Long>`	`updateAsync(DocumentAssignable query, DocumentAssignable update, boolean multiUpdate, boolean upsert, Durability durability)` Applies updates to a set of documents within the collection.
`Future<Long>`	`updateAsync(DocumentAssignable query, DocumentAssignable update, Durability durability)` Applies updates to a set of documents within the collection.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.allanbank.mongodb.MongoCollection
drop, isCapped, stats, updateOptions, validate

- Field Detail
  - DELETE_SINGLE_DELETE_DEFAULT
```
public static final boolean DELETE_SINGLE_DELETE_DEFAULT
```
    The default for if a delete should only delete the first document it matches.
    
    See Also:
    Constant Field Values
  - EMPTY_INDEX_OPTIONS
```
public static final Document EMPTY_INDEX_OPTIONS
```
    The default empty index options.
  - INSERT_CONTINUE_ON_ERROR_DEFAULT
```
public static final boolean INSERT_CONTINUE_ON_ERROR_DEFAULT
```
    The default for if an insert should continue on an error.
    
    See Also:
    Constant Field Values
  - UNIQUE_INDEX_OPTIONS
```
public static final Document UNIQUE_INDEX_OPTIONS
```
    The default for a UNIQUE index options.
  - UPDATE_MULTIUPDATE_DEFAULT
```
public static final boolean UPDATE_MULTIUPDATE_DEFAULT
```
    The default for doing a multiple-update on an update.
    
    See Also:
    Constant Field Values
  - UPDATE_UPSERT_DEFAULT
```
public static final boolean UPDATE_UPSERT_DEFAULT
```
    The default for doing an upsert on an update.
    
    See Also:
    Constant Field Values
  - myClient
```
protected final Client myClient
```
    The client for interacting with MongoDB.
  - myDatabase
```
protected final MongoDatabase myDatabase
```
    The name of the database we interact with.
  - myName
```
protected final String myName
```
    The name of the collection we interact with.
- Constructor Detail
  - AbstractMongoCollection
```
public AbstractMongoCollection(Client client,
                       MongoDatabase database,
                       String name)
```
    Create a new AbstractMongoCollection.
    
    Parameters:
    client - The client for interacting with MongoDB.
    database - The database we interact with.
    name - The name of the collection we interact with.
- Method Detail
  - aggregate
```
public List<Document> aggregate(Aggregate command)
                         throws MongoDbException
```
    Invokes a aggregate command on the server.
    Overridden to call the aggregateAsync(Aggregate).
    
    Specified by:
    
    aggregate in interface MongoCollection
    
    Parameters:
    command - The details of the aggregation request.
    
    Returns:
    The aggregation results returned.
    
    Throws:
    
    MongoDbException - On an error executing the aggregate command.
    See Also:
    aggregateAsync(Aggregate)
  - aggregate
```
public List<Document> aggregate(Aggregate.Builder command)
                         throws MongoDbException
```
    Invokes a aggregate command on the server.
    Overridden to call the aggregate(Aggregate).
    
    Specified by:
    
    aggregate in interface MongoCollection
    
    Parameters:
    command - The details of the aggregation request.
    
    Returns:
    The aggregation results returned.
    
    Throws:
    
    MongoDbException - On an error executing the aggregate command.
  - aggregateAsync
```
public Future<List<Document>> aggregateAsync(Aggregate command)
                                      throws MongoDbException
```
    Invokes a aggregate command on the server.
    Overridden to call the aggregateAsync(Callback, Aggregate).
    
    Specified by:
    
    aggregateAsync in interface MongoCollection
    
    Parameters:
    command - The details of the aggregation request.
    
    Returns:
    Future for the aggregation results returned.
    
    Throws:
    
    MongoDbException - On an error executing the aggregate command.
    See Also:
    aggregateAsync(Callback, Aggregate)
  - aggregateAsync
```
public Future<List<Document>> aggregateAsync(Aggregate.Builder command)
                                      throws MongoDbException
```
    Invokes a aggregate command on the server.
    Overridden to call the aggregateAsync(Aggregate).
    
    Specified by:
    
    aggregateAsync in interface MongoCollection
    
    Parameters:
    command - The details of the aggregation request.
    
    Returns:
    Future for the aggregation results returned.
    
    Throws:
    
    MongoDbException - On an error executing the aggregate command.
  - aggregateAsync
```
public abstract void aggregateAsync(Callback<List<Document>> results,
                  Aggregate command)
                             throws MongoDbException
```
    Invokes a aggregate command on the server.
    This is the canonical aggregate method that implementations must override.
    
    Specified by:
    
    aggregateAsync in interface MongoCollection
    
    Parameters:
    results - Callback for the aggregation results returned.
    command - The details of the aggregation request.
    
    Throws:
    
    MongoDbException - On an error executing the aggregate command.
    See Also:
    MongoCollection.aggregateAsync(Callback, Aggregate)
  - aggregateAsync
```
public void aggregateAsync(Callback<List<Document>> results,
                  Aggregate.Builder command)
                    throws MongoDbException
```
    Invokes a aggregate command on the server.
    Overridden to call the aggregateAsync(Callback, Aggregate).
    
    Specified by:
    
    aggregateAsync in interface MongoCollection
    
    Parameters:
    results - Callback for the aggregation results returned.
    command - The details of the aggregation request.
    
    Throws:
    
    MongoDbException - On an error executing the aggregate command.
  - count
```
public long count()
           throws MongoDbException
```
    Counts the set of documents in the collection.
    This is equivalent to calling countAsync().get()
    
    Overridden to call the count(DocumentAssignable,ReadPreference) method with getReadPreference() as the readPreference argument and an empty query document.
    
    Specified by:
    
    count in interface MongoCollection
    
    Returns:
    The number of documents in the collection.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - count
```
public long count(DocumentAssignable query)
           throws MongoDbException
```
    Counts the set of documents matching the query document in the collection.
    This is equivalent to calling countAsync(...).get()
    
    Overridden to call the count(DocumentAssignable, ReadPreference) method with getReadPreference() as the readPreference argument.
    
    Specified by:
    
    count in interface MongoCollection
    
    Parameters:
    query - The query document.
    
    Returns:
    The number of matching documents.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - count
```
public long count(DocumentAssignable query,
         ReadPreference readPreference)
           throws MongoDbException
```
    Counts the set of documents matching the query document in the collection.
    Overridden to call the countAsync(DocumentAssignable, ReadPreference) method.
    
    Specified by:
    
    count in interface MongoCollection
    
    Parameters:
    query - The query document.
    readPreference - The preference for which servers to use to retrieve the results.
    
    Returns:
    The number of matching documents.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - count
```
public long count(ReadPreference readPreference)
           throws MongoDbException
```
    Counts the set of documents in the collection.
    This is equivalent to calling countAsync().get()
    
    Overridden to call the count(DocumentAssignable,ReadPreference) method with an empty query document.
    
    Specified by:
    
    count in interface MongoCollection
    
    Parameters:
    readPreference - The preference for which servers to use to retrieve the results.
    
    Returns:
    The number of documents in the collection.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - countAsync
```
public Future<Long> countAsync()
                        throws MongoDbException
```
    Counts the set of documents in the collection.
    This is equivalent to calling countAsync().get()
    
    Overridden to call the countAsync(DocumentAssignable,ReadPreference) method with getReadPreference() as the readPreference argument and an empty query document.
    
    Specified by:
    
    countAsync in interface MongoCollection
    
    Returns:
    The number of documents in the collection.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - countAsync
```
public void countAsync(Callback<Long> results)
                throws MongoDbException
```
    Counts the set of documents in the collection.
    This is equivalent to calling countAsync(results, BuilderFactory.start())
    
    Overridden to call the countAsync(Callback,DocumentAssignable,ReadPreference) method with getReadPreference() as the readPreference argument and an empty query document.
    
    Specified by:
    
    countAsync in interface MongoCollection
    
    Parameters:
    results - The callback to notify of the results.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - countAsync
```
public void countAsync(Callback<Long> results,
              DocumentAssignable query)
                throws MongoDbException
```
    Counts the set of documents matching the query document in the collection.
    Overridden to call the countAsync(Callback, DocumentAssignable, ReadPreference) method with getReadPreference() as the readPreference argument.
    
    Specified by:
    
    countAsync in interface MongoCollection
    
    Parameters:
    results - The callback to notify of the results.
    query - The query document.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - countAsync
```
public abstract void countAsync(Callback<Long> results,
              DocumentAssignable query,
              ReadPreference readPreference)
                         throws MongoDbException
```
    Counts the set of documents matching the query document in the collection.
    This is the canonical count method that implementations must override.
    
    Specified by:
    
    countAsync in interface MongoCollection
    
    Parameters:
    results - The callback to notify of the results.
    query - The query document.
    readPreference - The preference for which servers to use to retrieve the results.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - countAsync
```
public void countAsync(Callback<Long> results,
              ReadPreference readPreference)
                throws MongoDbException
```
    Counts the set of documents in the collection.
    This is equivalent to calling countAsync(results, BuilderFactory.start(), readPreference)
    
    Overridden to call the countAsync(Callback,DocumentAssignable,ReadPreference) method with an empty query document.
    
    Specified by:
    
    countAsync in interface MongoCollection
    
    Parameters:
    results - The callback to notify of the results.
    readPreference - The preference for which servers to use to retrieve the results.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - countAsync
```
public Future<Long> countAsync(DocumentAssignable query)
                        throws MongoDbException
```
    Counts the set of documents matching the query document in the collection.
    Overridden to call the countAsync(Callback, DocumentAssignable, ReadPreference) method with getReadPreference() as the readPreference argument.
    
    Specified by:
    
    countAsync in interface MongoCollection
    
    Parameters:
    query - The query document.
    
    Returns:
    A future that will be updated with the number of matching documents.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - countAsync
```
public Future<Long> countAsync(DocumentAssignable query,
                      ReadPreference readPreference)
                        throws MongoDbException
```
    Counts the set of documents matching the query document in the collection.
    Overridden to call the countAsync(Callback, DocumentAssignable, ReadPreference) method.
    
    Specified by:
    
    countAsync in interface MongoCollection
    
    Parameters:
    query - The query document.
    readPreference - The preference for which servers to use to retrieve the results.
    
    Returns:
    A future that will be updated with the number of matching documents.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - countAsync
```
public Future<Long> countAsync(ReadPreference readPreference)
                        throws MongoDbException
```
    Counts the set of documents in the collection.
    This is equivalent to calling countAsync().get()
    
    Overridden to call the countAsync(DocumentAssignable,ReadPreference) method with an empty query document.
    
    Specified by:
    
    countAsync in interface MongoCollection
    
    Parameters:
    readPreference - The preference for which servers to use to retrieve the results.
    
    Returns:
    The number of documents in the collection.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - createIndex
```
public void createIndex(boolean unique,
               Element... keys)
                 throws MongoDbException
```
    Creates an index with a generated name, across the keys specified and if unique is true ensuring entries are unique.
    This method is intended to be used with the Index class's static methods:
    import static com.allanbank.mongodb.builder.Index.asc; import static com.allanbank.mongodb.builder.Index.desc; MongoCollection collection = ...; collection.createIndex( true, asc("f"), desc("g") ); ...
    Overridden to call the createIndex(String, boolean, Element...) method with null for the name.
    Specified by:
    
    createIndex in interface MongoCollection
    
    Parameters:
    unique - If true then the index created will enforce entries are unique.
    keys - The keys to use for the index.
    
    Throws:
    
    MongoDbException - On a failure building the index.
    See Also:
    createIndex(String, boolean, Element...)
  - createIndex
```
public void createIndex(DocumentAssignable options,
               Element... keys)
                 throws MongoDbException
```
    Creates an index with a generated name, across the keys specified allowing duplicate entries.
    This method is intended to be used with the Index class's static methods:
    import static com.allanbank.mongodb.bson.builder.BuilderFactory.start; import static com.allanbank.mongodb.builder.Index.asc; import static com.allanbank.mongodb.builder.Index.desc; MongoCollection collection = ...; collection.createIndex(start().add("sparse", true), asc("f") ); ...
    Overridden to call the createIndex(String,DocumentAssignable,Element...) method with null for name.
    Specified by:
    
    createIndex in interface MongoCollection
    
    Parameters:
    options - The options for the index.
    keys - The keys to use for the index.
    
    Throws:
    
    MongoDbException - On a failure building the index.
    See Also:
    createIndex(String,DocumentAssignable,Element...)
  - createIndex
```
public void createIndex(Element... keys)
                 throws MongoDbException
```
    Creates an index with a generated name, across the keys specified allowing duplicate entries.
    This method is intended to be used with the Index class's static methods:
    import static com.allanbank.mongodb.builder.Index.asc; import static com.allanbank.mongodb.builder.Index.desc; MongoCollection collection = ...; collection.createIndex( asc("f"), desc("g") ); ...
    Overridden to call the createIndex(DocumentAssignable, Element...) method with EMPTY_INDEX_OPTIONS for options.
    Specified by:
    
    createIndex in interface MongoCollection
    
    Parameters:
    keys - The keys to use for the index.
    
    Throws:
    
    MongoDbException - On a failure building the index.
    See Also:
    createIndex(DocumentAssignable, Element...)
  - createIndex
```
public void createIndex(String name,
               boolean unique,
               Element... keys)
                 throws MongoDbException
```
    Creates an index with the specified name, across the keys specified and if unique is true ensuring entries are unique.
    This method is intended to be used with the Index class's static methods:
    import static com.allanbank.mongodb.builder.Index.asc; import static com.allanbank.mongodb.builder.Index.desc; MongoCollection collection = ...; collection.createIndex( "f_and_g", false, asc("f"), desc("g") ); ...
    Overridden to call the createIndex(String,DocumentAssignable,Element...) method with UNIQUE_INDEX_OPTIONS if unique is true or EMPTY_INDEX_OPTIONS id unique is false.
    Specified by:
    
    createIndex in interface MongoCollection
    
    Parameters:
    name - The name of the index. If null then a name is generated based on the keys.
    unique - If true then the index created will enforce entries are unique.
    keys - The keys to use for the index.
    
    Throws:
    
    MongoDbException - On a failure building the index.
    See Also:
    createIndex(String, DocumentAssignable, Element...)
  - createIndex
```
public abstract void createIndex(String name,
               DocumentAssignable options,
               Element... keys)
                          throws MongoDbException
```
    Creates an index with a generated name, across the keys specified allowing duplicate entries.
    This method is intended to be used with the Index class's static methods:
    import static com.allanbank.mongodb.bson.builder.BuilderFactory.start; import static com.allanbank.mongodb.builder.Index.asc; import static com.allanbank.mongodb.builder.Index.desc; MongoCollection collection = ...; collection.createIndex("sparse_f", start().add("sparse", true), asc("f") ); ...
    This is the canonical createIndex method that implementations must override.
    Specified by:
    
    createIndex in interface MongoCollection
    
    Parameters:
    name - The name of the index. If null then a name is generated based on the keys.
    options - The options for the index.
    keys - The keys to use for the index.
    
    Throws:
    
    MongoDbException - On a failure building the index.
    See Also:
    MongoCollection.createIndex(String,DocumentAssignable,Element...)
  - delete
```
public long delete(DocumentAssignable query)
            throws MongoDbException
```
    Deletes a set of documents matching a query from the collection.
    Overridden to call the delete(DocumentAssignable, boolean, Durability) method with false as the singleDelete argument and the default durability.
    
    Specified by:
    
    delete in interface MongoCollection
    
    Parameters:
    query - Query to locate the documents to be deleted.
    
    Returns:
    The results of the delete. If the durability of the operation is NONE then this will be -1.
    
    Throws:
    
    MongoDbException - On an error deleting the documents.
    See Also:
    delete(DocumentAssignable, boolean, Durability)
  - delete
```
public long delete(DocumentAssignable query,
          boolean singleDelete)
            throws MongoDbException
```
    Deletes a set of documents matching a query from the collection.
    Overridden to call the delete(DocumentAssignable, boolean, Durability) method with the default durability.
    
    Specified by:
    
    delete in interface MongoCollection
    
    Parameters:
    query - Query to locate the documents to be deleted.
    singleDelete - If true then only a single document will be deleted. If running in a sharded environment then this field must be false or the query must contain the shard key.
    
    Returns:
    The results of the delete. If the durability of the operation is NONE then this will be -1.
    
    Throws:
    
    MongoDbException - On an error deleting the documents.
    See Also:
    delete(DocumentAssignable, boolean, Durability)
  - delete
```
public long delete(DocumentAssignable query,
          boolean singleDelete,
          Durability durability)
            throws MongoDbException
```
    Deletes a set of documents matching a query from the collection.
    Overridden to call the deleteAsync(DocumentAssignable, boolean, Durability) method.
    
    Specified by:
    
    delete in interface MongoCollection
    
    Parameters:
    query - Query to locate the documents to be deleted.
    singleDelete - If true then only a single document will be deleted. If running in a sharded environment then this field must be false or the query must contain the shard key.
    durability - The durability for the delete.
    
    Returns:
    The results of the delete. If the durability of the operation is NONE then this will be -1.
    
    Throws:
    
    MongoDbException - On an error deleting the documents.
    See Also:
    deleteAsync(DocumentAssignable, boolean, Durability)
  - delete
```
public long delete(DocumentAssignable query,
          Durability durability)
            throws MongoDbException
```
    Deletes a set of documents matching a query from the collection.
    Overridden to call the deleteAsync(DocumentAssignable, boolean, Durability) method with false as the singleDelete argument.
    
    Specified by:
    
    delete in interface MongoCollection
    
    Parameters:
    query - Query to locate the documents to be deleted.
    durability - The durability for the delete.
    
    Returns:
    The results of the delete. If the durability of the operation is NONE then this will be -1.
    
    Throws:
    
    MongoDbException - On an error deleting the documents.
    See Also:
    delete(DocumentAssignable, boolean, Durability)
  - deleteAsync
```
public void deleteAsync(Callback<Long> results,
               DocumentAssignable query)
                 throws MongoDbException
```
    Deletes a set of documents matching a query from the collection.
    Overridden to call the deleteAsync(Callback, DocumentAssignable, boolean, Durability) method with false as the singleDelete argument and the default durability.
    
    Specified by:
    
    deleteAsync in interface MongoCollection
    
    Parameters:
    results - Callback that will be notified of the results of the query. If the durability of the operation is NONE then this will be -1.
    query - Query to locate the documents to be deleted.
    
    Throws:
    
    MongoDbException - On an error deleting the documents.
    See Also:
    deleteAsync(Callback, DocumentAssignable, boolean, Durability)
  - deleteAsync
```
public void deleteAsync(Callback<Long> results,
               DocumentAssignable query,
               boolean singleDelete)
                 throws MongoDbException
```
    Deletes a set of documents matching a query from the collection.
    Overridden to call the deleteAsync(Callback, DocumentAssignable, boolean, Durability) method with the default durability.
    
    Specified by:
    
    deleteAsync in interface MongoCollection
    
    Parameters:
    results - Callback that will be notified of the results of the query. If the durability of the operation is NONE then this will be -1.
    query - Query to locate the documents to be deleted.
    singleDelete - If true then only a single document will be deleted. If running in a sharded environment then this field must be false or the query must contain the shard key.
    
    Throws:
    
    MongoDbException - On an error deleting the documents.
    See Also:
    MongoCollection.deleteAsync(Callback, DocumentAssignable)
  - deleteAsync
```
public abstract void deleteAsync(Callback<Long> results,
               DocumentAssignable query,
               boolean singleDelete,
               Durability durability)
                          throws MongoDbException
```
    Deletes a set of documents matching a query from the collection.
    This is the canonical delete method that implementations must override.
    
    Specified by:
    
    deleteAsync in interface MongoCollection
    
    Parameters:
    results - Callback that will be notified of the results of the query. If the durability of the operation is NONE then this will be -1.
    query - Query to locate the documents to be deleted.
    singleDelete - If true then only a single document will be deleted. If running in a sharded environment then this field must be false or the query must contain the shard key.
    durability - The durability for the delete.
    
    Throws:
    
    MongoDbException - On an error deleting the documents.
    See Also:
    MongoCollection.deleteAsync(Callback, DocumentAssignable, boolean, Durability)
  - deleteAsync
```
public void deleteAsync(Callback<Long> results,
               DocumentAssignable query,
               Durability durability)
                 throws MongoDbException
```
    Deletes a set of documents matching a query from the collection.
    Overridden to call the deleteAsync(Callback, DocumentAssignable, boolean, Durability) method with false as the singleDelete argument.
    
    Specified by:
    
    deleteAsync in interface MongoCollection
    
    Parameters:
    results - Callback that will be notified of the results of the query. If the durability of the operation is NONE then this will be -1.
    query - Query to locate the documents to be deleted.
    durability - The durability for the delete.
    
    Throws:
    
    MongoDbException - On an error deleting the documents.
    See Also:
    MongoCollection.deleteAsync(Callback, DocumentAssignable, boolean)
  - deleteAsync
```
public Future<Long> deleteAsync(DocumentAssignable query)
                         throws MongoDbException
```
    Deletes a set of documents matching a query from the collection.
    Overridden to call the deleteAsync(Callback, DocumentAssignable, boolean, Durability) method with false as the singleDelete argument and the default durability.
    
    Specified by:
    
    deleteAsync in interface MongoCollection
    
    Parameters:
    query - Query to locate the documents to be deleted.
    
    Returns:
    Future that will be updated with the results of the delete. If the durability of the operation is NONE then this will be -1.
    
    Throws:
    
    MongoDbException - On an error deleting the documents.
    See Also:
    MongoCollection.deleteAsync(Callback, DocumentAssignable)
  - deleteAsync
```
public Future<Long> deleteAsync(DocumentAssignable query,
                       boolean singleDelete)
                         throws MongoDbException
```
    Deletes a set of documents matching a query from the collection.
    Overridden to call the deleteAsync(Callback, DocumentAssignable, boolean, Durability) method with the default durability.
    
    Specified by:
    
    deleteAsync in interface MongoCollection
    
    Parameters:
    query - Query to locate the documents to be deleted.
    singleDelete - If true then only a single document will be deleted. If running in a sharded environment then this field must be false or the query must contain the shard key.
    
    Returns:
    Future that will be updated with the results of the delete. If the durability of the operation is NONE then this will be -1.
    
    Throws:
    
    MongoDbException - On an error deleting the documents.
    See Also:
    MongoCollection.deleteAsync(Callback, DocumentAssignable)
  - deleteAsync
```
public Future<Long> deleteAsync(DocumentAssignable query,
                       boolean singleDelete,
                       Durability durability)
                         throws MongoDbException
```
    Deletes a set of documents matching a query from the collection.
    Overridden to call the deleteAsync(Callback, DocumentAssignable) method.
    
    Specified by:
    
    deleteAsync in interface MongoCollection
    
    Parameters:
    query - Query to locate the documents to be deleted.
    singleDelete - If true then only a single document will be deleted. If running in a sharded environment then this field must be false or the query must contain the shard key.
    durability - The durability for the delete.
    
    Returns:
    Future that will be updated with the results of the delete. If the durability of the operation is NONE then this will be -1.
    
    Throws:
    
    MongoDbException - On an error deleting the documents.
    See Also:
    MongoCollection.deleteAsync(Callback, DocumentAssignable)
  - deleteAsync
```
public Future<Long> deleteAsync(DocumentAssignable query,
                       Durability durability)
                         throws MongoDbException
```
    Deletes a set of documents matching a query from the collection.
    Overridden to call the deleteAsync(Callback, DocumentAssignable) method with false as the singleDelete argument.
    
    Specified by:
    
    deleteAsync in interface MongoCollection
    
    Parameters:
    query - Query to locate the documents to be deleted.
    durability - The durability for the delete.
    
    Returns:
    Future that will be updated with the results of the delete. If the durability of the operation is NONE then this will be -1.
    
    Throws:
    
    MongoDbException - On an error deleting the documents.
    See Also:
    MongoCollection.deleteAsync(Callback, DocumentAssignable)
  - distinct
```
public ArrayElement distinct(Distinct command)
                      throws MongoDbException
```
    Invokes a distinct command on the server.
    Overridden to call the distinctAsync(Distinct).
    
    Specified by:
    
    distinct in interface MongoCollection
    
    Parameters:
    command - The details of the distinct request.
    
    Returns:
    The distinct results returned.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - distinct
```
public ArrayElement distinct(Distinct.Builder command)
                      throws MongoDbException
```
    Invokes a distinct command on the server.
    Overridden to call the distinct(Distinct).
    
    Specified by:
    
    distinct in interface MongoCollection
    
    Parameters:
    command - The details of the distinct request.
    
    Returns:
    The distinct results returned.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - distinctAsync
```
public abstract void distinctAsync(Callback<ArrayElement> results,
                 Distinct command)
                            throws MongoDbException
```
    Invokes a distinct command on the server.
    This is the canonical disitnct method that implementations must override.
    
    Specified by:
    
    distinctAsync in interface MongoCollection
    
    Parameters:
    results - Callback for the distinct results returned.
    command - The details of the distinct request.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - distinctAsync
```
public void distinctAsync(Callback<ArrayElement> results,
                 Distinct.Builder command)
                   throws MongoDbException
```
    Invokes a distinct command on the server.
    Overridden to call the distinctAsync(Callback, Distinct).
    
    Specified by:
    
    distinctAsync in interface MongoCollection
    
    Parameters:
    results - Callback for the distinct results returned.
    command - The details of the distinct request.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - distinctAsync
```
public Future<ArrayElement> distinctAsync(Distinct command)
                                   throws MongoDbException
```
    Invokes a distinct command on the server.
    Overridden to call the distinctAsync(Callback, Distinct).
    
    Specified by:
    
    distinctAsync in interface MongoCollection
    
    Parameters:
    command - The details of the distinct request.
    
    Returns:
    Future for the distinct results returned.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - distinctAsync
```
public Future<ArrayElement> distinctAsync(Distinct.Builder command)
                                   throws MongoDbException
```
    Invokes a distinct command on the server.
    Overridden to call the distinctAsync(Distinct).
    
    Specified by:
    
    distinctAsync in interface MongoCollection
    
    Parameters:
    command - The details of the distinct request.
    
    Returns:
    Future for the distinct results returned.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - dropIndex
```
public boolean dropIndex(IntegerElement... keys)
                  throws MongoDbException
```
    Deletes the indexes matching the keys specified.
    This method is intended to be used with the Index class's static methods:
    import static com.allanbank.mongodb.builder.Index.asc; import static com.allanbank.mongodb.builder.Index.desc; MongoCollection collection = ...; collection.dropIndex( asc("f"), desc("g") ); ...
    To generate the name of the index and then drop it.
    Specified by:
    
    dropIndex in interface MongoCollection
    
    Parameters:
    keys - The keys for the index to be dropped.
    
    Returns:
    If any indexes were removed.
    
    Throws:
    
    MongoDbException - On an error deleting the indexes.
  - dropIndex
```
public abstract boolean dropIndex(String name)
                           throws MongoDbException
```
    Deletes the indexes with the provided name.
    This is the canonical dropIndex method that implementations must override.
    
    Specified by:
    
    dropIndex in interface MongoCollection
    
    Parameters:
    name - The name of the index.
    
    Returns:
    If any indexes were removed.
    
    Throws:
    
    MongoDbException - On an error deleting the indexes.
  - explain
```
public Document explain(DocumentAssignable query)
                 throws MongoDbException
```
    Explains the way that the document will be performed.
    Overridden to call the explain(Find) method.
    
    Specified by:
    
    explain in interface MongoCollection
    
    Parameters:
    query - The query document.
    
    Returns:
    The document describing the method used to execute the query.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
    See Also:
    explain(Find)
  - explain
```
public Document explain(Find query)
                 throws MongoDbException
```
    Explains the way that the document will be performed.
    This is equivalent to calling explainAsync(...).get()
    
    Overridden to call the explainAsync(Find) method.
    
    Specified by:
    
    explain in interface MongoCollection
    
    Parameters:
    query - The query details.
    
    Returns:
    The document describing the method used to execute the query.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
    See Also:
    explainAsync(Find)
  - explain
```
public Document explain(Find.Builder query)
                 throws MongoDbException
```
    Explains the way that the document will be performed.
    This is equivalent to calling explainAsync(...).get()
    
    Overridden to call the explain(Find) method.
    
    Specified by:
    
    explain in interface MongoCollection
    
    Parameters:
    query - The query details.
    
    Returns:
    The document describing the method used to execute the query.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - explainAsync
```
public abstract void explainAsync(Callback<Document> results,
                Find query)
                           throws MongoDbException
```
    Explains the way that the document will be performed.
    This is the canonical count method that implementations must override.
    
    Specified by:
    
    explainAsync in interface MongoCollection
    
    Parameters:
    results - Callback that will be notified of the results of the explain.
    query - The query details.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - explainAsync
```
public void explainAsync(Callback<Document> results,
                Find.Builder query)
                  throws MongoDbException
```
    Explains the way that the document will be performed.
    Overridden to call the explainAsync(Callback,Find) method.
    
    Specified by:
    
    explainAsync in interface MongoCollection
    
    Parameters:
    results - Callback that will be notified of the results of the explain.
    query - The query details.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - explainAsync
```
public Future<Document> explainAsync(Find query)
                              throws MongoDbException
```
    Explains the way that the document will be performed.
    Overridden to call the explainAsync(Callback,Find) method.
    
    Specified by:
    
    explainAsync in interface MongoCollection
    
    Parameters:
    query - The query details.
    
    Returns:
    The document describing the method used to execute the query.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
    See Also:
    explainAsync(Callback,Find)
  - explainAsync
```
public Future<Document> explainAsync(Find.Builder query)
                              throws MongoDbException
```
    Explains the way that the document will be performed.
    Overridden to call the explainAsync(Find) method.
    
    Specified by:
    
    explainAsync in interface MongoCollection
    
    Parameters:
    query - The query details.
    
    Returns:
    The document describing the method used to execute the query.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - find
```
public MongoIterator<Document> find(DocumentAssignable query)
                             throws MongoDbException
```
    Finds the set of documents matching the query document in the collection.
    This is equivalent to calling findAsync(...).get()
    
    Overridden to call the findAsync(DocumentAssignable) method.
    
    Specified by:
    
    find in interface MongoCollection
    
    Parameters:
    query - The query document.
    
    Returns:
    The MongoIterator over the documents.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
    See Also:
    findAsync(DocumentAssignable)
  - find
```
public MongoIterator<Document> find(Find query)
                             throws MongoDbException
```
    Finds the set of documents matching the query in the collection.
    This is equivalent to calling findAsync(...).get()
    
    Overridden to call the findAsync(Find) method.
    
    Specified by:
    
    find in interface MongoCollection
    
    Parameters:
    query - The query details.
    
    Returns:
    The MongoIterator over the documents.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
    See Also:
    findAsync(Find)
  - find
```
public MongoIterator<Document> find(Find.Builder query)
                             throws MongoDbException
```
    Finds the set of documents matching the query in the collection.
    This is equivalent to calling findAsync(...).get()
    
    Overridden to call the find(Find) method.
    
    Specified by:
    
    find in interface MongoCollection
    
    Parameters:
    query - The query details.
    
    Returns:
    The MongoIterator over the documents.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - findAndModify
```
public Document findAndModify(FindAndModify command)
                       throws MongoDbException
```
    Invokes a findAndModify command on the server. The query is used to locate a document to apply a set of updates to.
    Overridden to call the findAndModifyAsync(FindAndModify).
    
    Specified by:
    
    findAndModify in interface MongoCollection
    
    Parameters:
    command - The details of the find and modify request.
    
    Returns:
    The found document.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
    See Also:
    findAndModifyAsync(FindAndModify)
  - findAndModify
```
public Document findAndModify(FindAndModify.Builder command)
                       throws MongoDbException
```
    Invokes a findAndModify command on the server. The query is used to locate a document to apply a set of updates to.
    Overridden to call the findAndModify(FindAndModify).
    
    Specified by:
    
    findAndModify in interface MongoCollection
    
    Parameters:
    command - The details of the find and modify request.
    
    Returns:
    The found document.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - findAndModifyAsync
```
public abstract void findAndModifyAsync(Callback<Document> results,
                      FindAndModify command)
                                 throws MongoDbException
```
    Invokes a findAndModify command on the server. The query is used to locate a document to apply a set of updates to.
    This is the canonical findAndModify method that implementations must override.
    
    Specified by:
    
    findAndModifyAsync in interface MongoCollection
    
    Parameters:
    results - Callback for the the found document.
    command - The details of the find and modify request.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
    See Also:
    MongoCollection.findAndModifyAsync(Callback, FindAndModify)
  - findAndModifyAsync
```
public void findAndModifyAsync(Callback<Document> results,
                      FindAndModify.Builder command)
                        throws MongoDbException
```
    Invokes a findAndModify command on the server. The query is used to locate a document to apply a set of updates to.
    Overridden to call the findAndModifyAsync(Callback,FindAndModify).
    
    Specified by:
    
    findAndModifyAsync in interface MongoCollection
    
    Parameters:
    results - Callback for the the found document.
    command - The details of the find and modify request.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - findAndModifyAsync
```
public Future<Document> findAndModifyAsync(FindAndModify command)
                                    throws MongoDbException
```
    Invokes a findAndModify command on the server. The query is used to locate a document to apply a set of updates to.
    Overridden to call the findAndModifyAsync(Callback, FindAndModify).
    
    Specified by:
    
    findAndModifyAsync in interface MongoCollection
    
    Parameters:
    command - The details of the find and modify request.
    
    Returns:
    Future for the found document.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
    See Also:
    findAndModifyAsync(Callback, FindAndModify)
  - findAndModifyAsync
```
public Future<Document> findAndModifyAsync(FindAndModify.Builder command)
                                    throws MongoDbException
```
    Invokes a findAndModify command on the server. The query is used to locate a document to apply a set of updates to.
    Overridden to call the findAndModifyAsync(FindAndModify).
    
    Specified by:
    
    findAndModifyAsync in interface MongoCollection
    
    Parameters:
    command - The details of the find and modify request.
    
    Returns:
    Future for the found document.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - findAsync
```
public void findAsync(Callback<MongoIterator<Document>> results,
             DocumentAssignable query)
               throws MongoDbException
```
    Finds the set of documents matching the query document in the collection.
    Overridden to call the findAsync(Callback, Find).
    
    Specified by:
    
    findAsync in interface MongoCollection
    
    Parameters:
    results - Callback that will be notified of the results of the query.
    query - The query document.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
    See Also:
    findAsync(Callback, DocumentAssignable)
  - findAsync
```
public abstract void findAsync(Callback<MongoIterator<Document>> results,
             Find query)
                        throws MongoDbException
```
    Finds the set of documents matching the query in the collection.
    This is the canonical find method that implementations must override.
    
    Specified by:
    
    findAsync in interface MongoCollection
    
    Parameters:
    results - Callback that will be notified of the results of the query.
    query - The query details.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
    See Also:
    MongoCollection.findAsync(Callback, Find)
  - findAsync
```
public void findAsync(Callback<MongoIterator<Document>> results,
             Find.Builder query)
               throws MongoDbException
```
    Finds the set of documents matching the query in the collection.
    Overridden to call the findAsync(Callback,Find) method.
    
    Specified by:
    
    findAsync in interface MongoCollection
    
    Parameters:
    results - Callback that will be notified of the results of the query.
    query - The query details.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - findAsync
```
public Future<MongoIterator<Document>> findAsync(DocumentAssignable query)
                                          throws MongoDbException
```
    Finds the set of documents matching the query document in the collection.
    Overridden to call the findAsync(Callback, DocumentAssignable).
    
    Specified by:
    
    findAsync in interface MongoCollection
    
    Parameters:
    query - The query document.
    
    Returns:
    A future for the MongoIterator over the documents.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
    See Also:
    findAsync(Callback, DocumentAssignable)
  - findAsync
```
public Future<MongoIterator<Document>> findAsync(Find query)
                                          throws MongoDbException
```
    Finds the set of documents matching the query in the collection.
    Overridden to call the findAsync(Callback, Find).
    
    Specified by:
    
    findAsync in interface MongoCollection
    
    Parameters:
    query - The query details.
    
    Returns:
    A future for the MongoIterator over the documents.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
    See Also:
    findAsync(Callback, Find)
  - findAsync
```
public Future<MongoIterator<Document>> findAsync(Find.Builder query)
                                          throws MongoDbException
```
    Finds the set of documents matching the query in the collection.
    Overridden to call the findAsync(Find) method.
    
    Specified by:
    
    findAsync in interface MongoCollection
    
    Parameters:
    query - The query details.
    
    Returns:
    A future for the MongoIterator over the documents.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - findOne
```
public Document findOne(DocumentAssignable query)
                 throws MongoDbException
```
    Finds a single matching document in the collection.
    Overridden to call the findOneAsync(DocumentAssignable).
    
    Specified by:
    
    findOne in interface MongoCollection
    
    Parameters:
    query - The query document.
    
    Returns:
    The first found document.
    
    Throws:
    
    MongoDbException - On an error finding the document.
    See Also:
    findOneAsync(DocumentAssignable)
  - findOne
```
public Document findOne(Find query)
                 throws MongoDbException
```
    Overridden to call the findOneAsync(Callback, Find).
    
    Specified by:
    
    findOne in interface MongoCollection
    
    Parameters:
    query - The query details.
    
    Returns:
    The first found document.
    
    Throws:
    
    MongoDbException - On an error finding the document.
    See Also:
    findOneAsync(Callback, Find)
  - findOne
```
public Document findOne(Find.Builder query)
                 throws MongoDbException
```
    Finds a single matching document in the collection.
    Note that following options in the Find class do not make sense and are silently ignored by this method.
    - Batch Size - Automatically set to 1.
    - Limit - Automatically set to 1.
    - Tailable - This method only returns 1 document.
    Overridden to call the findOne(Find) method.
    Specified by:
    
    findOne in interface MongoCollection
    
    Parameters:
    query - The query details.
    
    Returns:
    The first found document.
    
    Throws:
    
    MongoDbException - On an error finding the document.
  - findOneAsync
```
public void findOneAsync(Callback<Document> results,
                DocumentAssignable query)
                  throws MongoDbException
```
    Finds a single matching document in the collection.
    Overridden to call the findOneAsync(Callback, Find).
    
    Specified by:
    
    findOneAsync in interface MongoCollection
    
    Parameters:
    results - Callback that will be notified of the results of the query.
    query - The query document.
    
    Throws:
    
    MongoDbException - On an error finding the document.
    See Also:
    findOneAsync(Callback, Find)
  - findOneAsync
```
public abstract void findOneAsync(Callback<Document> results,
                Find query)
                           throws MongoDbException
```
    Finds a single matching document in the collection.
    Note that following options in the Find class do not make sense and are silently ignored by this method.
    - Batch Size - Automatically set to 1.
    - Limit - Automatically set to 1.
    - Tailable - This method only returns 1 document.
    This is the canonical findOne method that implementations must override.
    Specified by:
    
    findOneAsync in interface MongoCollection
    
    Parameters:
    results - Callback that will be notified of the results of the query.
    query - The query details.
    
    Throws:
    
    MongoDbException - On an error finding the document.
    See Also:
    MongoCollection.findOneAsync(Callback, Find)
  - findOneAsync
```
public void findOneAsync(Callback<Document> results,
                Find.Builder query)
                  throws MongoDbException
```
    Finds a single matching document in the collection.
    Note that following options in the Find class do not make sense and are silently ignored by this method.
    - Batch Size - Automatically set to 1.
    - Limit - Automatically set to 1.
    - Tailable - This method only returns 1 document.
    Overridden to call the findOneAsync(Callback, Find) method.
    Specified by:
    
    findOneAsync in interface MongoCollection
    
    Parameters:
    results - Callback that will be notified of the results of the query.
    query - The query details.
    
    Throws:
    
    MongoDbException - On an error finding the document.
  - findOneAsync
```
public Future<Document> findOneAsync(DocumentAssignable query)
                              throws MongoDbException
```
    Finds a single matching document in the collection.
    Overridden to call the findOneAsync(Callback, DocumentAssignable).
    
    Specified by:
    
    findOneAsync in interface MongoCollection
    
    Parameters:
    query - The query document.
    
    Returns:
    The first found document.
    
    Throws:
    
    MongoDbException - On an error finding the document.
    See Also:
    findOneAsync(Callback, DocumentAssignable)
  - findOneAsync
```
public Future<Document> findOneAsync(Find query)
                              throws MongoDbException
```
    Finds a single matching document in the collection.
    Note that following options in the Find class do not make sense and are silently ignored by this method.
    - Batch Size - Automatically set to 1.
    - Limit - Automatically set to 1.
    - Tailable - This method only returns 1 document.
    Overridden to call the findOneAsync(Callback, Find).
    Specified by:
    
    findOneAsync in interface MongoCollection
    
    Parameters:
    query - The query details.
    
    Returns:
    The first found document.
    
    Throws:
    
    MongoDbException - On an error finding the document.
    See Also:
    findOneAsync(Callback, Find)
  - findOneAsync
```
public Future<Document> findOneAsync(Find.Builder query)
                              throws MongoDbException
```
    Finds a single matching document in the collection.
    Note that following options in the Find class do not make sense and are silently ignored by this method.
    - Batch Size - Automatically set to 1.
    - Limit - Automatically set to 1.
    - Tailable - This method only returns 1 document.
    Overridden to call the findOneAsync(Find) method.
    Specified by:
    
    findOneAsync in interface MongoCollection
    
    Parameters:
    query - The query details.
    
    Returns:
    The first found document.
    
    Throws:
    
    MongoDbException - On an error finding the document.
  - getDatabaseName
```
public String getDatabaseName()
```
    Returns the name of the database.
    
    Specified by:
    
    getDatabaseName in interface MongoCollection
    
    Returns:
    The name of the database.
  - getDurability
```
public Durability getDurability()
```
    Returns the durability for write operations sent to the server from this MongoCollection instance.
    Defaults to the Durability from the parent MongoDatabase instance.
    
    Specified by:
    
    getDurability in interface MongoCollection
    
    Returns:
    The durability for write operations on the server.
    See Also:
    MongoDatabase.getDurability()
  - getName
```
public String getName()
```
    Returns the name of the collection.
    
    Specified by:
    
    getName in interface MongoCollection
    
    Returns:
    The name of the collection.
  - getReadPreference
```
public ReadPreference getReadPreference()
```
    Returns the read preference for queries from this MongoCollection instance.
    Defaults to ReadPreference from the parent MongoDatabase instance.
    
    Specified by:
    
    getReadPreference in interface MongoCollection
    
    Returns:
    The default read preference for a query.
    See Also:
    MongoDatabase.getReadPreference()
  - groupBy
```
public ArrayElement groupBy(GroupBy command)
                     throws MongoDbException
```
    Invokes a group command on the server.
    Overridden to call the groupByAsync(GroupBy).
    
    Specified by:
    
    groupBy in interface MongoCollection
    
    Parameters:
    command - The details of the group request.
    
    Returns:
    The group results returned.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - groupBy
```
public ArrayElement groupBy(GroupBy.Builder command)
                     throws MongoDbException
```
    Invokes a group command on the server.
    Overridden to call the groupBy(GroupBy).
    
    Specified by:
    
    groupBy in interface MongoCollection
    
    Parameters:
    command - The details of the group request.
    
    Returns:
    The group results returned.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - groupByAsync
```
public abstract void groupByAsync(Callback<ArrayElement> results,
                GroupBy command)
                           throws MongoDbException
```
    Invokes a group command on the server.
    This is the canonical groupBy method that implementations must override.
    
    Specified by:
    
    groupByAsync in interface MongoCollection
    
    Parameters:
    results - Callback for the group results returned.
    command - The details of the group request.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - groupByAsync
```
public void groupByAsync(Callback<ArrayElement> results,
                GroupBy.Builder command)
                  throws MongoDbException
```
    Invokes a group command on the server.
    Overridden to call the groupByAsync(Callback,GroupBy).
    
    Specified by:
    
    groupByAsync in interface MongoCollection
    
    Parameters:
    results - Callback for the group results returned.
    command - The details of the group request.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - groupByAsync
```
public Future<ArrayElement> groupByAsync(GroupBy command)
                                  throws MongoDbException
```
    Invokes a group command on the server.
    Overridden to call the groupByAsync(Callback, GroupBy).
    
    Specified by:
    
    groupByAsync in interface MongoCollection
    
    Parameters:
    command - The details of the group request.
    
    Returns:
    Future for the group results returned.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - groupByAsync
```
public Future<ArrayElement> groupByAsync(GroupBy.Builder command)
                                  throws MongoDbException
```
    Invokes a group command on the server.
    Overridden to call the groupByAsync(GroupBy).
    
    Specified by:
    
    groupByAsync in interface MongoCollection
    
    Parameters:
    command - The details of the group request.
    
    Returns:
    Future for the group results returned.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - insert
```
public int insert(boolean continueOnError,
         DocumentAssignable... documents)
           throws MongoDbException
```
    Inserts a set of documents into the collection.
    This is equivalent to calling insertAsync(...).get()
    
    Overridden to call the insert(boolean, Durability, DocumentAssignable...) method with the default durability.
    
    Specified by:
    
    insert in interface MongoCollection
    
    Parameters:
    continueOnError - If the insert should continue if one of the documents causes an error.
    documents - The documents to add to the collection.
    
    Returns:
    Currently, returns zero. Once SERVER-4381 is fixed then expected to return the number of documents inserted. If the durability is NONE then returns -1.
    
    Throws:
    
    MongoDbException - On an error inserting the documents.
    See Also:
    insert(boolean, Durability, DocumentAssignable[])
  - insert
```
public int insert(boolean continueOnError,
         Durability durability,
         DocumentAssignable... documents)
           throws MongoDbException
```
    Inserts a set of documents into the collection.
    This is equivalent to calling insertAsync(...).get()
    
    Overridden to call the insertAsync(boolean, Durability, DocumentAssignable...) method.
    
    Specified by:
    
    insert in interface MongoCollection
    
    Parameters:
    continueOnError - If the insert should continue if one of the documents causes an error.
    durability - The durability for the insert.
    documents - The documents to add to the collection.
    
    Returns:
    Currently, returns zero. Once SERVER-4381 is fixed then expected to return the number of documents inserted. If the durability is NONE then returns -1.
    
    Throws:
    
    MongoDbException - On an error inserting the documents.
    See Also:
    insertAsync(boolean, Durability, DocumentAssignable[])
  - insert
```
public int insert(DocumentAssignable... documents)
           throws MongoDbException
```
    Inserts a set of documents into the collection.
    This is equivalent to calling insertAsync(...).get()
    
    Overridden to call the insert(boolean, Durability, DocumentAssignable...) method with continueOnError set to false and the default durability.
    
    Specified by:
    
    insert in interface MongoCollection
    
    Parameters:
    documents - The documents to add to the collection.
    
    Returns:
    Currently, returns zero. Once SERVER-4381 is fixed then expected to return the number of documents inserted. If the durability is NONE then returns -1.
    
    Throws:
    
    MongoDbException - On an error inserting the documents.
    See Also:
    MongoCollection.insertAsync(boolean, Durability, DocumentAssignable[])
  - insert
```
public int insert(Durability durability,
         DocumentAssignable... documents)
           throws MongoDbException
```
    Inserts a set of documents into the collection.
    This is equivalent to calling insertAsync(...).get()
    
    Overridden to call the insert(boolean, Durability, DocumentAssignable...) method with continueOnError set to false.
    
    Specified by:
    
    insert in interface MongoCollection
    
    Parameters:
    durability - The durability for the insert.
    documents - The documents to add to the collection.
    
    Returns:
    Currently, returns zero. Once SERVER-4381 is fixed then expected to return the number of documents inserted. If the durability is NONE then returns -1.
    
    Throws:
    
    MongoDbException - On an error inserting the documents.
    See Also:
    insert(boolean, Durability, DocumentAssignable[])
  - insertAsync
```
public Future<Integer> insertAsync(boolean continueOnError,
                          DocumentAssignable... documents)
                            throws MongoDbException
```
    Inserts a set of documents into the collection.
    Overridden to call the insertAsync(Callback, boolean, Durability, DocumentAssignable...) method with the default durability.
    
    Specified by:
    
    insertAsync in interface MongoCollection
    
    Parameters:
    continueOnError - If the insert should continue if one of the documents causes an error.
    documents - The documents to add to the collection.
    
    Returns:
    Future that will be updated with the results of the insert. Currently, the value is always zero. Once SERVER-4381 is fixed then expected to be the number of documents inserted. If the durability is NONE then returns -1.
    
    Throws:
    
    MongoDbException - On an error inserting the documents.
    See Also:
    MongoCollection.insertAsync(Callback, boolean, Durability, DocumentAssignable[])
  - insertAsync
```
public Future<Integer> insertAsync(boolean continueOnError,
                          Durability durability,
                          DocumentAssignable... documents)
                            throws MongoDbException
```
    Inserts a set of documents into the collection.
    Overridden to call the insertAsync(Callback, boolean, Durability, DocumentAssignable...) method with continueOnError set to false and the default durability.
    
    Specified by:
    
    insertAsync in interface MongoCollection
    
    Parameters:
    continueOnError - If the insert should continue if one of the documents causes an error.
    durability - The durability for the insert.
    documents - The documents to add to the collection.
    
    Returns:
    Future that will be updated with the results of the insert. Currently, the value is always zero. Once SERVER-4381 is fixed then expected to be the number of documents inserted. If the durability is NONE then returns -1.
    
    Throws:
    
    MongoDbException - On an error inserting the documents.
    See Also:
    MongoCollection.insertAsync(Callback, boolean, Durability, DocumentAssignable[])
  - insertAsync
```
public void insertAsync(Callback<Integer> results,
               boolean continueOnError,
               DocumentAssignable... documents)
                 throws MongoDbException
```
    Inserts a set of documents into the collection.
    Overridden to call the insertAsync(Callback, boolean, Durability, DocumentAssignable...) method the default durability.
    
    Specified by:
    
    insertAsync in interface MongoCollection
    
    Parameters:
    results - Callback that will be notified with the results of the insert. Currently, the value is always zero. Once SERVER-4381 is fixed then expected to be the number of documents inserted. If the durability is NONE then returns -1.
    continueOnError - If the insert should continue if one of the documents causes an error.
    documents - The documents to add to the collection.
    
    Throws:
    
    MongoDbException - On an error inserting the documents.
    See Also:
    MongoCollection.insertAsync(Callback, boolean, Durability, DocumentAssignable[])
  - insertAsync
```
public abstract void insertAsync(Callback<Integer> results,
               boolean continueOnError,
               Durability durability,
               DocumentAssignable... documents)
                          throws MongoDbException
```
    Inserts a set of documents into the collection.
    This is the canonical insert method that implementations must override.
    
    Specified by:
    
    insertAsync in interface MongoCollection
    
    Parameters:
    results - Callback that will be notified with the results of the insert. Currently, the value is always zero. Once SERVER-4381 is fixed then expected to be the number of documents inserted. If the durability is NONE then returns -1.
    continueOnError - If the insert should continue if one of the documents causes an error.
    durability - The durability for the insert.
    documents - The documents to add to the collection.
    
    Throws:
    
    MongoDbException - On an error inserting the documents.
    See Also:
    MongoCollection.insertAsync(Callback, boolean, Durability, DocumentAssignable[])
  - insertAsync
```
public void insertAsync(Callback<Integer> results,
               DocumentAssignable... documents)
                 throws MongoDbException
```
    Inserts a set of documents into the collection.
    Overridden to call the insertAsync(Callback, boolean, Durability, DocumentAssignable...) method with continueOnError set to false and the default durability.
    
    Specified by:
    
    insertAsync in interface MongoCollection
    
    Parameters:
    results - Callback that will be notified with the results of the insert. Currently, the value is always zero. Once SERVER-4381 is fixed then expected to be the number of documents inserted. If the durability is NONE then returns -1.
    documents - The documents to add to the collection.
    
    Throws:
    
    MongoDbException - On an error inserting the documents.
    See Also:
    MongoCollection.insertAsync(Callback, boolean, Durability, DocumentAssignable[])
  - insertAsync
```
public void insertAsync(Callback<Integer> results,
               Durability durability,
               DocumentAssignable... documents)
                 throws MongoDbException
```
    Inserts a set of documents into the collection.
    Overridden to call the insertAsync(Callback, boolean, Durability, DocumentAssignable...) method with continueOnError set to false.
    
    Specified by:
    
    insertAsync in interface MongoCollection
    
    Parameters:
    results - Callback that will be notified with the results of the insert. Currently, the value is always zero. Once SERVER-4381 is fixed then expected to be the number of documents inserted. If the durability is NONE then returns -1.
    durability - The durability for the insert.
    documents - The documents to add to the collection.
    
    Throws:
    
    MongoDbException - On an error inserting the documents.
    See Also:
    MongoCollection.insertAsync(Callback, boolean, Durability, DocumentAssignable[])
  - insertAsync
```
public Future<Integer> insertAsync(DocumentAssignable... documents)
                            throws MongoDbException
```
    Inserts a set of documents into the collection.
    Overridden to call the insertAsync(Callback, boolean, Durability, DocumentAssignable...) method with continueOnError set to false and the default durability.
    
    Specified by:
    
    insertAsync in interface MongoCollection
    
    Parameters:
    documents - The documents to add to the collection.
    
    Returns:
    Future that will be updated with the results of the insert. Currently, the value is always zero. Once SERVER-4381 is fixed then expected to be the number of documents inserted. If the durability is NONE then returns -1.
    
    Throws:
    
    MongoDbException - On an error inserting the documents.
    See Also:
    MongoCollection.insertAsync(Callback, boolean, Durability, DocumentAssignable[])
  - insertAsync
```
public Future<Integer> insertAsync(Durability durability,
                          DocumentAssignable... documents)
                            throws MongoDbException
```
    Inserts a set of documents into the collection.
    Overridden to call the insertAsync(Callback, boolean, Durability, DocumentAssignable...) method with continueOnError set to false.
    
    Specified by:
    
    insertAsync in interface MongoCollection
    
    Parameters:
    durability - The durability for the insert.
    documents - The documents to add to the collection.
    
    Returns:
    Future that will be updated with the results of the insert. Currently, the value is always zero. Once SERVER-4381 is fixed then expected to be the number of documents inserted. If the durability is NONE then returns -1.
    
    Throws:
    
    MongoDbException - On an error inserting the documents.
    See Also:
    MongoCollection.insertAsync(Callback, boolean, Durability, DocumentAssignable[])
  - mapReduce
```
public List<Document> mapReduce(MapReduce command)
                         throws MongoDbException
```
    Invokes a mapReduce command on the server.
    Overridden to call the mapReduceAsync(MapReduce).
    
    Specified by:
    
    mapReduce in interface MongoCollection
    
    Parameters:
    command - The details of the map/reduce request.
    
    Returns:
    The map/reduce results returned. Note this might be empty if the output type is not inline.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
    See Also:
    mapReduceAsync(MapReduce)
  - mapReduce
```
public List<Document> mapReduce(MapReduce.Builder command)
                         throws MongoDbException
```
    Invokes a mapReduce command on the server.
    Overridden to call the mapReduce(MapReduce).
    
    Specified by:
    
    mapReduce in interface MongoCollection
    
    Parameters:
    command - The details of the map/reduce request.
    
    Returns:
    The map/reduce results returned. Note this might be empty if the output type is not inline.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - mapReduceAsync
```
public abstract void mapReduceAsync(Callback<List<Document>> results,
                  MapReduce command)
                             throws MongoDbException
```
    Invokes a mapReduce command on the server.
    This is the canonical mapReduce method that implementations must override.
    
    Specified by:
    
    mapReduceAsync in interface MongoCollection
    
    Parameters:
    results - Callback for the map/reduce results returned. Note this might be empty if the output type is not inline.
    command - The details of the map/reduce request.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
    See Also:
    MongoCollection.mapReduceAsync(Callback, MapReduce)
  - mapReduceAsync
```
public void mapReduceAsync(Callback<List<Document>> results,
                  MapReduce.Builder command)
                    throws MongoDbException
```
    Invokes a mapReduce command on the server.
    Overridden to call the mapReduceAsync(Callback,MapReduce).
    
    Specified by:
    
    mapReduceAsync in interface MongoCollection
    
    Parameters:
    results - Callback for the map/reduce results returned. Note this might be empty if the output type is not inline.
    command - The details of the map/reduce request.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - mapReduceAsync
```
public Future<List<Document>> mapReduceAsync(MapReduce command)
                                      throws MongoDbException
```
    Invokes a mapReduce command on the server.
    Overridden to call the mapReduceAsync(Callback, MapReduce).
    
    Specified by:
    
    mapReduceAsync in interface MongoCollection
    
    Parameters:
    command - The details of the map/reduce request.
    
    Returns:
    Future for the map/reduce results returned. Note this might be empty if the output type is not inline.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
    See Also:
    mapReduceAsync(Callback, MapReduce)
  - mapReduceAsync
```
public Future<List<Document>> mapReduceAsync(MapReduce.Builder command)
                                      throws MongoDbException
```
    Invokes a mapReduce command on the server.
    Overridden to call the mapReduceAsync(MapReduce).
    
    Specified by:
    
    mapReduceAsync in interface MongoCollection
    
    Parameters:
    command - The details of the map/reduce request.
    
    Returns:
    Future for the map/reduce results returned. Note this might be empty if the output type is not inline.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - save
```
public int save(DocumentAssignable document)
         throws MongoDbException
```
    Saves the document to the collection.
    If the document does not contain an _id field then this method is equivalent to: insert(document).
    
    If the document does contain an _id field then this method is equivalent to: update(BuilderFactory.start().add(document.get("_id")), document, false, true).
    
    Overridden to call the save(DocumentAssignable, Durability) using the default durability.
    
    Specified by:
    
    save in interface MongoCollection
    
    Parameters:
    document - The document to save to the collection.
    
    Returns:
    Future that will be updated with the results of the save. If the durability of the operation is NONE then this will be -1.
    
    Throws:
    
    MongoDbException - On an error saving the documents.
  - save
```
public int save(DocumentAssignable document,
       Durability durability)
         throws MongoDbException
```
    Saves the document to the collection.
    If the document does not contain an _id field then this method is equivalent to: insert(durability, document).
    
    If the document does contain an _id field then this method is equivalent to: update(BuilderFactory.start().add(document.get("_id")), document, false, true, durability).
    
    Overridden to call the saveAsync(DocumentAssignable, Durability) .
    
    Specified by:
    
    save in interface MongoCollection
    
    Parameters:
    document - The document to save to the collection.
    durability - The durability for the save.
    
    Returns:
    Future that will be updated with the results of the save. If the durability of the operation is NONE then this will be -1.
    
    Throws:
    
    MongoDbException - On an error saving the documents.
  - saveAsync
```
public void saveAsync(Callback<Integer> results,
             DocumentAssignable document)
               throws MongoDbException
```
    Saves the document to the collection.
    If the document does not contain an _id field then this method is equivalent to: insertAsync(results, document).
    
    If the document does contain an _id field then this method is equivalent to: updateAsync(results, BuilderFactory.start().add(document.get("_id")), document, false, true).
    
    Overridden to call the saveAsync(Callback, DocumentAssignable, Durability) using the default durability.
    
    Specified by:
    
    saveAsync in interface MongoCollection
    
    Parameters:
    results - Callback that will be notified with the results of the insert. If the durability of the operation is NONE then this will be -1.
    document - The document to save to the collection.
    
    Throws:
    
    MongoDbException - On an error saving the documents.
  - saveAsync
```
public abstract void saveAsync(Callback<Integer> results,
             DocumentAssignable document,
             Durability durability)
                        throws MongoDbException
```
    Saves the document to the collection.
    If the document does not contain an _id field then this method is equivalent to: insertAsync(results, durability, document).
    
    If the document does contain an _id field then this method is equivalent to: updateAsync(results, BuilderFactory.start().add(document.get("_id")), document, false, true, durability).
    
    This is the canonical save method that implementations must override.
    
    Specified by:
    
    saveAsync in interface MongoCollection
    
    Parameters:
    results - Callback that will be notified with the results of the insert. If the durability of the operation is NONE then this will be -1.
    document - The document to save to the collection.
    durability - The durability for the save.
    
    Throws:
    
    MongoDbException - On an error saving the documents.
  - saveAsync
```
public Future<Integer> saveAsync(DocumentAssignable document)
                          throws MongoDbException
```
    Saves the document to the collection.
    If the document does not contain an _id field then this method is equivalent to: insertAsync(document).
    
    If the document does contain an _id field then this method is equivalent to: updateAsync(BuilderFactory.start().add(document.get("_id")), document, false, true).
    
    Overridden to call the saveAsync(Callback, DocumentAssignable, Durability) using the default durability.
    
    Specified by:
    
    saveAsync in interface MongoCollection
    
    Parameters:
    document - The document to save to the collection.
    
    Returns:
    Future that will be updated with the results of the save. If the durability of the operation is NONE then this will be -1.
    
    Throws:
    
    MongoDbException - On an error saving the documents.
  - saveAsync
```
public Future<Integer> saveAsync(DocumentAssignable document,
                        Durability durability)
                          throws MongoDbException
```
    Saves the document to the collection.
    If the document does not contain an _id field then this method is equivalent to: insertAsync(durability, document).
    
    If the document does contain an _id field then this method is equivalent to: updateAsync(BuilderFactory.start().add(document.get("_id")), document, false, true, durability).
    
    Overridden to call the saveAsync(Callback, DocumentAssignable, Durability).
    
    Specified by:
    
    saveAsync in interface MongoCollection
    
    Parameters:
    document - The document to save to the collection.
    durability - The durability for the save.
    
    Returns:
    Future that will be updated with the results of the save. If the durability of the operation is NONE then this will be -1.
    
    Throws:
    
    MongoDbException - On an error saving the documents.
  - setDurability
```
public void setDurability(Durability durability)
```
    Sets the durability for write operations from this MongoCollection instance.
    Defaults to the Durability from the parent MongoDatabase instance if set to null.
    
    Specified by:
    
    setDurability in interface MongoCollection
    
    Parameters:
    durability - The durability for write operations on the server.
    See Also:
    MongoDatabase.getDurability()
  - setReadPreference
```
public void setReadPreference(ReadPreference readPreference)
```
    Sets the value of the read preference for a queries from this MongoCollection instance.
    Defaults to the ReadPreference from the parent MongoDatabase instance if set to null.
    
    Specified by:
    
    setReadPreference in interface MongoCollection
    
    Parameters:
    readPreference - The read preference for a query.
    See Also:
    MongoDatabase.getReadPreference()
  - streamingFind
```
@Deprecated
public MongoCursorControl streamingFind(Callback<Document> results,
                                          DocumentAssignable query)
                                 throws MongoDbException
```
    Deprecated.
    
    Finds the set of documents matching the query document in the collection and streams them to the provided callback one at a time.
    The sequence of callbacks will be terminated by either calling the results.callback(...) method with null or by calling the results.exception(...) method on an error.
    
    Applications can terminate the stream by throwing a RuntimeException from the Callback.callback(V) method (which will then call the Callback.exception(java.lang.Throwable) method).
    
    Only a single thread will invoke the callback at a time but that thread may change over time.
    
    If the callback processing requires any significant time (including I/O) it is recommended that an Executor be configured within the MongoClientConfiguration to off-load the processing from the receive thread.
    
    Overridden to call the streamingFind(Callback, Find).
    
    Specified by:
    
    streamingFind in interface MongoCollection
    
    Parameters:
    results - Callback that will be notified of the results of the query.
    query - The query document.
    
    Returns:
    A MongoCursorControl to control the cursor streaming documents to the caller. This includes the ability to stop the cursor and persist its state.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
    See Also:
    streamingFind(Callback, Find)
  - streamingFind
```
@Deprecated
public MongoCursorControl streamingFind(Callback<Document> results,
                                          Find query)
                                 throws MongoDbException
```
    Deprecated.
    
    Finds the set of documents matching the query in the collection and streams them to the provided callback one at a time.
    The sequence of callbacks will be terminated by either calling the results.callback(...) method with null or by calling the results.exception(...) method on an error.
    
    Applications can terminate the stream by throwing a RuntimeException from the Callback.callback(V) method (which will then call the Callback.exception(java.lang.Throwable) method).
    
    Only a single thread will invoke the callback at a time but that thread may change over time.
    
    If the callback processing requires any significant time (including I/O) it is recommended that an Executor be configured within the MongoClientConfiguration to off-load the processing from the receive thread.
    
    Overridden to call the streamingFind(StreamCallback, Find).
    
    Specified by:
    
    streamingFind in interface MongoCollection
    
    Parameters:
    results - Callback that will be notified of the results of the query.
    query - The query details.
    
    Returns:
    A MongoCursorControl to control the cursor streaming documents to the caller. This includes the ability to stop the cursor and persist its state.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
    See Also:
    streamingFind(StreamCallback, Find)
  - streamingFind
```
public MongoCursorControl streamingFind(StreamCallback<Document> results,
                               DocumentAssignable query)
                                 throws MongoDbException
```
    Finds the set of documents matching the query document in the collection and streams them to the provided callback one at a time.
    The sequence of callbacks will be terminated by either calling the results.done() method or by calling the results.exception(...) method (in the event of an error).
    
    Applications can terminate the stream by throwing a RuntimeException from the Callback.callback(V) method (which will then call the Callback.exception(java.lang.Throwable) method or by closing the MongoCursorControl returned from this method.
    
    Only a single thread will invoke the callback at a time but that thread may change over time.
    
    If the callback processing requires any significant time (including I/O) it is recommended that an Executor be configured within the MongoClientConfiguration to off-load the processing from the receive thread.
    
    Overridden to call the streamingFind(StreamCallback, Find).
    
    Specified by:
    
    streamingFind in interface MongoCollection
    
    Parameters:
    results - Callback that will be notified of the results of the query.
    query - The query document.
    
    Returns:
    A MongoCursorControl to control the cursor streaming documents to the caller. This includes the ability to stop the cursor and persist its state.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
    See Also:
    streamingFind(StreamCallback, Find)
  - streamingFind
```
public abstract MongoCursorControl streamingFind(StreamCallback<Document> results,
                               Find query)
                                          throws MongoDbException
```
    Finds the set of documents matching the query in the collection and streams them to the provided callback one at a time.
    The sequence of callbacks will be terminated by either calling the results.done() method or by calling the results.exception(...) method (in the event of an error).
    
    Applications can terminate the stream by throwing a RuntimeException from the Callback.callback(V) method (which will then call the Callback.exception(java.lang.Throwable) method or by closing the MongoCursorControl returned from this method.
    
    Only a single thread will invoke the callback at a time but that thread may change over time.
    
    If the callback processing requires any significant time (including I/O) it is recommended that an Executor be configured within the MongoClientConfiguration to off-load the processing from the receive thread.
    
    This is the canonical streamingFind method that implementations must override.
    
    Specified by:
    
    streamingFind in interface MongoCollection
    
    Parameters:
    results - Callback that will be notified of the results of the query.
    query - The query details.
    
    Returns:
    A MongoCursorControl to control the cursor streaming documents to the caller. This includes the ability to stop the cursor and persist its state.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - streamingFind
```
public MongoCursorControl streamingFind(StreamCallback<Document> results,
                               Find.Builder query)
                                 throws MongoDbException
```
    Finds the set of documents matching the query in the collection and streams them to the provided callback one at a time.
    The sequence of callbacks will be terminated by either calling the results.done() method or by calling the results.exception(...) method (in the event of an error).
    
    Applications can terminate the stream by throwing a RuntimeException from the Callback.callback(V) method (which will then call the Callback.exception(java.lang.Throwable) method or by closing the MongoCursorControl returned from this method.
    
    Only a single thread will invoke the callback at a time but that thread may change over time.
    
    If the callback processing requires any significant time (including I/O) it is recommended that an Executor be configured within the MongoClientConfiguration to off-load the processing from the receive thread.
    
    Overridden to call the streamingFind(StreamCallback, Find) method.
    
    Specified by:
    
    streamingFind in interface MongoCollection
    
    Parameters:
    results - Callback that will be notified of the results of the query.
    query - The query details.
    
    Returns:
    A MongoCursorControl to control the cursor streaming documents to the caller. This includes the ability to stop the cursor and persist its state.
    
    Throws:
    
    MongoDbException - On an error finding the documents.
  - textSearch
```
public List<TextResult> textSearch(Text command)
                            throws MongoDbException
```
    Invokes a text command on the server.
    Overridden to call the textSearchAsync(Text).
    
    Specified by:
    
    textSearch in interface MongoCollection
    
    Parameters:
    command - The details of the text request.
    
    Returns:
    The text results returned.
    
    Throws:
    
    MongoDbException - On an error executing the text command.
    See Also:
    textSearchAsync(Text)
  - textSearch
```
public List<TextResult> textSearch(Text.Builder command)
                            throws MongoDbException
```
    Invokes a text command on the server.
    Overridden to call the textSearch(Text).
    
    Specified by:
    
    textSearch in interface MongoCollection
    
    Parameters:
    command - The details of the text request.
    
    Returns:
    The text results returned.
    
    Throws:
    
    MongoDbException - On an error executing the text command.
    See Also:
    MongoDB Text Queries
  - textSearchAsync
```
public abstract void textSearchAsync(Callback<List<TextResult>> results,
                   Text command)
                              throws MongoDbException
```
    Invokes a text command on the server.
    This is the canonical textSearch method that implementations must override.
    
    Specified by:
    
    textSearchAsync in interface MongoCollection
    
    Parameters:
    results - Callback for the text results returned.
    command - The details of the text request.
    
    Throws:
    
    MongoDbException - On an error executing the text command.
    See Also:
    MongoCollection.textSearchAsync(Callback, Text)
  - textSearchAsync
```
public void textSearchAsync(Callback<List<TextResult>> results,
                   Text.Builder command)
                     throws MongoDbException
```
    Invokes a text command on the server.
    Overridden to call the textSearchAsync(Callback, Text).
    
    Specified by:
    
    textSearchAsync in interface MongoCollection
    
    Parameters:
    results - Callback for the text results returned.
    command - The details of the text request.
    
    Throws:
    
    MongoDbException - On an error executing the text command.
  - textSearchAsync
```
public Future<List<TextResult>> textSearchAsync(Text command)
                                         throws MongoDbException
```
    Invokes a text command on the server.
    Overridden to call the textSearchAsync(Callback, Text).
    
    Specified by:
    
    textSearchAsync in interface MongoCollection
    
    Parameters:
    command - The details of the text request.
    
    Returns:
    Future for the text results returned.
    
    Throws:
    
    MongoDbException - On an error executing the text command.
    See Also:
    textSearchAsync(Callback, Text)
  - textSearchAsync
```
public Future<List<TextResult>> textSearchAsync(Text.Builder command)
                                         throws MongoDbException
```
    Invokes a text command on the server.
    Overridden to call the textSearchAsync(Text).
    
    Specified by:
    
    textSearchAsync in interface MongoCollection
    
    Parameters:
    command - The details of the text request.
    
    Returns:
    Future for the text results returned.
    
    Throws:
    
    MongoDbException - On an error executing the text command.
    See Also:
    MongoDB Text Queries
  - update
```
public long update(DocumentAssignable query,
          DocumentAssignable update)
            throws MongoDbException
```
    Applies updates to a set of documents within the collection. The documents to update are selected by the query and the updates are describe by the update document.
    Overridden to call the update(DocumentAssignable, DocumentAssignable, boolean, boolean, Durability) method with multiUpdate set to true, upsert set to false, and using the default durability.
    
    Specified by:
    
    update in interface MongoCollection
    
    Parameters:
    query - The query to select the documents to update.
    update - The updates to apply to the selected documents.
    
    Returns:
    The number of documents updated. If the durability of the operation is NONE then this will be -1.
    
    Throws:
    
    MongoDbException - On an error updating the documents.
    See Also:
    update(DocumentAssignable, DocumentAssignable, boolean, boolean, Durability)
  - update
```
public long update(DocumentAssignable query,
          DocumentAssignable update,
          boolean multiUpdate,
          boolean upsert)
            throws MongoDbException
```
    Applies updates to a set of documents within the collection. The documents to update are selected by the query and the updates are describe by the update document.
    Overridden to call the update(DocumentAssignable, DocumentAssignable, boolean, boolean, Durability) method with the default durability.
    
    Specified by:
    
    update in interface MongoCollection
    
    Parameters:
    query - The query to select the documents to update.
    update - The updates to apply to the selected documents.
    multiUpdate - If true then the update is applied to all of the matching documents, otherwise only the first document found is updated.
    upsert - If true then if no document is found then a new document is created and updated, otherwise no operation is performed.
    
    Returns:
    The number of documents updated. If the durability of the operation is NONE then this will be -1.
    
    Throws:
    
    MongoDbException - On an error updating the documents.
    See Also:
    update(DocumentAssignable, DocumentAssignable, boolean, boolean, Durability)
  - update
```
public long update(DocumentAssignable query,
          DocumentAssignable update,
          boolean multiUpdate,
          boolean upsert,
          Durability durability)
            throws MongoDbException
```
    Applies updates to a set of documents within the collection. The documents to update are selected by the query and the updates are describe by the update document.
    Overridden to call the updateAsync(DocumentAssignable, DocumentAssignable, boolean, boolean, Durability) method.
    
    Specified by:
    
    update in interface MongoCollection
    
    Parameters:
    query - The query to select the documents to update.
    update - The updates to apply to the selected documents.
    multiUpdate - If true then the update is applied to all of the matching documents, otherwise only the first document found is updated.
    upsert - If true then if no document is found then a new document is created and updated, otherwise no operation is performed.
    durability - The durability for the insert.
    
    Returns:
    The number of documents updated. If the durability of the operation is NONE then this will be -1.
    
    Throws:
    
    MongoDbException - On an error updating the documents.
    See Also:
    updateAsync(DocumentAssignable, DocumentAssignable, boolean, boolean, Durability)
  - update
```
public long update(DocumentAssignable query,
          DocumentAssignable update,
          Durability durability)
            throws MongoDbException
```
    Applies updates to a set of documents within the collection. The documents to update are selected by the query and the updates are describe by the update document.
    Overridden to call the update(DocumentAssignable, DocumentAssignable, boolean, boolean, Durability) method with multiUpdate set to true, and upsert set to false.
    
    Specified by:
    
    update in interface MongoCollection
    
    Parameters:
    query - The query to select the documents to update.
    update - The updates to apply to the selected documents.
    durability - The durability for the update.
    
    Returns:
    The number of documents updated. If the durability of the operation is NONE then this will be -1.
    
    Throws:
    
    MongoDbException - On an error updating the documents.
    See Also:
    update(DocumentAssignable, DocumentAssignable, boolean, boolean, Durability)
  - updateAsync
```
public void updateAsync(Callback<Long> results,
               DocumentAssignable query,
               DocumentAssignable update)
                 throws MongoDbException
```
    Applies updates to a set of documents within the collection. The documents to update are selected by the query and the updates are describe by the update document.
    Overridden to call the updateAsync(Callback, DocumentAssignable, DocumentAssignable, boolean, boolean, Durability) with multiUpdate set to true, upsert set to false, and using the default durability.
    
    Specified by:
    
    updateAsync in interface MongoCollection
    
    Parameters:
    results - The Callback that will be notified of the number of documents updated. If the durability of the operation is NONE then this will be -1.
    query - The query to select the documents to update.
    update - The updates to apply to the selected documents.
    
    Throws:
    
    MongoDbException - On an error updating the documents.
    See Also:
    updateAsync(Callback, DocumentAssignable, DocumentAssignable, boolean, boolean, Durability)
  - updateAsync
```
public void updateAsync(Callback<Long> results,
               DocumentAssignable query,
               DocumentAssignable update,
               boolean multiUpdate,
               boolean upsert)
                 throws MongoDbException
```
    Applies updates to a set of documents within the collection. The documents to update are selected by the query and the updates are describe by the update document.
    Overridden to call the updateAsync(Callback, DocumentAssignable, DocumentAssignable, boolean, boolean, Durability) using the default durability.
    
    Specified by:
    
    updateAsync in interface MongoCollection
    
    Parameters:
    results - The Callback that will be notified of the number of documents updated. If the durability of the operation is NONE then this will be -1.
    query - The query to select the documents to update.
    update - The updates to apply to the selected documents.
    multiUpdate - If true then the update is applied to all of the matching documents, otherwise only the first document found is updated.
    upsert - If true then if no document is found then a new document is created and updated, otherwise no operation is performed.
    
    Throws:
    
    MongoDbException - On an error updating the documents.
    See Also:
    updateAsync(Callback, DocumentAssignable, DocumentAssignable, boolean, boolean, Durability)
  - updateAsync
```
public abstract void updateAsync(Callback<Long> results,
               DocumentAssignable query,
               DocumentAssignable update,
               boolean multiUpdate,
               boolean upsert,
               Durability durability)
                          throws MongoDbException
```
    Applies updates to a set of documents within the collection. The documents to update are selected by the query and the updates are describe by the update document.
    This is the canonical update method that implementations must override.
    
    Specified by:
    
    updateAsync in interface MongoCollection
    
    Parameters:
    results - The Callback that will be notified of the number of documents updated. If the durability of the operation is NONE then this will be -1.
    query - The query to select the documents to update.
    update - The updates to apply to the selected documents.
    multiUpdate - If true then the update is applied to all of the matching documents, otherwise only the first document found is updated.
    upsert - If true then if no document is found then a new document is created and updated, otherwise no operation is performed.
    durability - The durability for the update.
    
    Throws:
    
    MongoDbException - On an error updating the documents.
    See Also:
    MongoCollection.updateAsync(Callback, DocumentAssignable, DocumentAssignable, boolean, boolean, Durability)
  - updateAsync
```
public void updateAsync(Callback<Long> results,
               DocumentAssignable query,
               DocumentAssignable update,
               Durability durability)
                 throws MongoDbException
```
    Applies updates to a set of documents within the collection. The documents to update are selected by the query and the updates are describe by the update document.
    Overridden to call the updateAsync(Callback, DocumentAssignable, DocumentAssignable, boolean, boolean, Durability) with multiUpdate set to true, and upsert set to false.
    
    Specified by:
    
    updateAsync in interface MongoCollection
    
    Parameters:
    results - The Callback that will be notified of the number of documents updated. If the durability of the operation is NONE then this will be -1.
    query - The query to select the documents to update.
    update - The updates to apply to the selected documents.
    durability - The durability for the update.
    
    Throws:
    
    MongoDbException - On an error updating the documents.
    See Also:
    updateAsync(Callback, DocumentAssignable, DocumentAssignable, boolean, boolean, Durability)
  - updateAsync
```
public Future<Long> updateAsync(DocumentAssignable query,
                       DocumentAssignable update)
                         throws MongoDbException
```
    Applies updates to a set of documents within the collection. The documents to update are selected by the query and the updates are describe by the update document.
    Overridden to call the updateAsync(Callback, DocumentAssignable, DocumentAssignable, boolean, boolean, Durability) with multiUpdate set to true, upsert set to false, and using the default durability.
    
    Specified by:
    
    updateAsync in interface MongoCollection
    
    Parameters:
    query - The query to select the documents to update.
    update - The updates to apply to the selected documents.
    
    Returns:
    A Future that will be updated with the number of documents updated. If the durability of the operation is NONE then this will be -1.
    
    Throws:
    
    MongoDbException - On an error updating the documents.
    See Also:
    updateAsync(Callback, DocumentAssignable, DocumentAssignable, boolean, boolean, Durability)
  - updateAsync
```
public Future<Long> updateAsync(DocumentAssignable query,
                       DocumentAssignable update,
                       boolean multiUpdate,
                       boolean upsert)
                         throws MongoDbException
```
    Applies updates to a set of documents within the collection. The documents to update are selected by the query and the updates are describe by the update document.
    Overridden to call the updateAsync(Callback, DocumentAssignable, DocumentAssignable, boolean, boolean, Durability) using the default durability.
    
    Specified by:
    
    updateAsync in interface MongoCollection
    
    Parameters:
    query - The query to select the documents to update.
    update - The updates to apply to the selected documents.
    multiUpdate - If true then the update is applied to all of the matching documents, otherwise only the first document found is updated.
    upsert - If true then if no document is found then a new document is created and updated, otherwise no operation is performed.
    
    Returns:
    A Future that will be updated with the number of documents updated. If the durability of the operation is NONE then this will be -1.
    
    Throws:
    
    MongoDbException - On an error updating the documents.
    See Also:
    updateAsync(Callback, DocumentAssignable, DocumentAssignable, boolean, boolean, Durability)
  - updateAsync
```
public Future<Long> updateAsync(DocumentAssignable query,
                       DocumentAssignable update,
                       boolean multiUpdate,
                       boolean upsert,
                       Durability durability)
                         throws MongoDbException
```
    Applies updates to a set of documents within the collection. The documents to update are selected by the query and the updates are describe by the update document.
    Overridden to call the updateAsync(Callback, DocumentAssignable, DocumentAssignable, boolean, boolean, Durability) method.
    
    Specified by:
    
    updateAsync in interface MongoCollection
    
    Parameters:
    query - The query to select the documents to update.
    update - The updates to apply to the selected documents.
    multiUpdate - If true then the update is applied to all of the matching documents, otherwise only the first document found is updated.
    upsert - If true then if no document is found then a new document is created and updated, otherwise no operation is performed.
    durability - The durability for the update.
    
    Returns:
    A Future that will be updated with the number of documents updated. If the durability of the operation is NONE then this will be -1.
    
    Throws:
    
    MongoDbException - On an error updating the documents.
    See Also:
    updateAsync(Callback, DocumentAssignable, DocumentAssignable, boolean, boolean, Durability)
  - updateAsync
```
public Future<Long> updateAsync(DocumentAssignable query,
                       DocumentAssignable update,
                       Durability durability)
                         throws MongoDbException
```
    Applies updates to a set of documents within the collection. The documents to update are selected by the query and the updates are describe by the update document.
    Overridden to call the updateAsync(Callback, DocumentAssignable, DocumentAssignable, boolean, boolean, Durability) with multiUpdate set to true, and upsert set to false.
    
    Specified by:
    
    updateAsync in interface MongoCollection
    
    Parameters:
    query - The query to select the documents to update.
    update - The updates to apply to the selected documents.
    durability - The durability for the update.
    
    Returns:
    A Future that will be updated with the number of documents updated. If the durability of the operation is NONE then this will be -1.
    
    Throws:
    
    MongoDbException - On an error updating the documents.
    See Also:
    updateAsync(Callback, DocumentAssignable, DocumentAssignable, boolean, boolean, Durability)
  - asGetLastError
```
protected GetLastError asGetLastError(Durability durability)
```
    Converts the Durability into a GetLastError command.
    
    Parameters:
    durability - The Durability to convert.
    
    Returns:
    The GetLastError command.
  - buildIndexName
```
protected String buildIndexName(Element... keys)
```
    Generates a name for the index based on the keys.
    
    Parameters:
    keys - The keys for the index.
    
    Returns:
    The name for the index.

Class AbstractMongoCollection

Nested Class Summary

Nested classes/interfaces inherited from interface com.allanbank.mongodb.MongoCollection

Field Summary

Fields inherited from interface com.allanbank.mongodb.MongoCollection

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface com.allanbank.mongodb.MongoCollection

Field Detail

DELETE_SINGLE_DELETE_DEFAULT

EMPTY_INDEX_OPTIONS

INSERT_CONTINUE_ON_ERROR_DEFAULT

UNIQUE_INDEX_OPTIONS

UPDATE_MULTIUPDATE_DEFAULT

UPDATE_UPSERT_DEFAULT

myClient

myDatabase

myName

Constructor Detail

AbstractMongoCollection

Method Detail

aggregate

aggregate

aggregateAsync

aggregateAsync

aggregateAsync

aggregateAsync

count

count

count

count

countAsync

countAsync

countAsync

countAsync

countAsync

countAsync

countAsync

countAsync

createIndex

createIndex

createIndex

createIndex

createIndex

delete

delete

delete

delete

deleteAsync

deleteAsync

deleteAsync

deleteAsync

deleteAsync

deleteAsync

deleteAsync

deleteAsync

distinct

distinct

distinctAsync

distinctAsync

distinctAsync

distinctAsync

dropIndex

dropIndex

explain

explain

explain

explainAsync

explainAsync

explainAsync

explainAsync

find

find

find

findAndModify

findAndModify

findAndModifyAsync

findAndModifyAsync

findAndModifyAsync