com.mongodb.client

接口 MongoCollection<TDocument>

类型参数:

TDocument - The type that this collection will encode documents from and decode documents to.

@ThreadSafe
public interface MongoCollection<TDocument>

The MongoCollection interface.

Note: Additions to this interface will not be considered to break binary compatibility.

MongoCollection is generic allowing for different types to represent documents. Any custom classes must have a Codec registered in the CodecRegistry. The default CodecRegistry includes built-in support for: BsonDocument, Document and DBObject.

从以下版本开始:

3.0

方法概要

限定符和类型	方法和说明
AggregateIterable<TDocument>	aggregate(java.util.List<? extends Bson> pipeline) Aggregates documents according to the specified aggregation pipeline.
<TResult> AggregateIterable<TResult>	aggregate(java.util.List<? extends Bson> pipeline, java.lang.Class<TResult> resultClass) Aggregates documents according to the specified aggregation pipeline.
BulkWriteResult	bulkWrite(java.util.List<? extends WriteModel<? extends TDocument>> requests) Executes a mix of inserts, updates, replaces, and deletes.
BulkWriteResult	bulkWrite(java.util.List<? extends WriteModel<? extends TDocument>> requests, BulkWriteOptions options) Executes a mix of inserts, updates, replaces, and deletes.
long	count() Counts the number of documents in the collection.
long	count(Bson filter) Counts the number of documents in the collection according to the given options.
long	count(Bson filter, CountOptions options) Counts the number of documents in the collection according to the given options.
java.lang.String	createIndex(Bson keys) Create an index with the given keys.
java.lang.String	createIndex(Bson keys, IndexOptions indexOptions) Create an index with the given keys and options.
java.util.List<java.lang.String>	createIndexes(java.util.List<IndexModel> indexes) Create multiple indexes.
DeleteResult	deleteMany(Bson filter) Removes all documents from the collection that match the given query filter.
DeleteResult	deleteOne(Bson filter) Removes at most one document from the collection that matches the given filter.
<TResult> DistinctIterable<TResult>	distinct(java.lang.String fieldName, Bson filter, java.lang.Class<TResult> resultClass) Gets the distinct values of the specified field name.
<TResult> DistinctIterable<TResult>	distinct(java.lang.String fieldName, java.lang.Class<TResult> resultClass) Gets the distinct values of the specified field name.
void	drop() Drops this collection from the Database.
void	dropIndex(Bson keys) Drops the index given the keys used to create it.
void	dropIndex(java.lang.String indexName) Drops the index given its name.
void	dropIndexes() Drop all the indexes on this collection, except for the default on _id.
FindIterable<TDocument>	find() Finds all documents in the collection.
FindIterable<TDocument>	find(Bson filter) Finds all documents in the collection.
<TResult> FindIterable<TResult>	find(Bson filter, java.lang.Class<TResult> resultClass) Finds all documents in the collection.
<TResult> FindIterable<TResult>	find(java.lang.Class<TResult> resultClass) Finds all documents in the collection.
TDocument	findOneAndDelete(Bson filter) Atomically find a document and remove it.
TDocument	findOneAndDelete(Bson filter, FindOneAndDeleteOptions options) Atomically find a document and remove it.
TDocument	findOneAndReplace(Bson filter, TDocument replacement) Atomically find a document and replace it.
TDocument	findOneAndReplace(Bson filter, TDocument replacement, FindOneAndReplaceOptions options) Atomically find a document and replace it.
TDocument	findOneAndUpdate(Bson filter, Bson update) Atomically find a document and update it.
TDocument	findOneAndUpdate(Bson filter, Bson update, FindOneAndUpdateOptions options) Atomically find a document and update it.
CodecRegistry	getCodecRegistry() Get the codec registry for the MongoCollection.
java.lang.Class<TDocument>	getDocumentClass() Get the class of documents stored in this collection.
MongoNamespace	getNamespace() Gets the namespace of this collection.
ReadConcern	getReadConcern() Get the read concern for the MongoCollection.
ReadPreference	getReadPreference() Get the read preference for the MongoCollection.
WriteConcern	getWriteConcern() Get the write concern for the MongoCollection.
void	insertMany(java.util.List<? extends TDocument> documents) Inserts one or more documents.
void	insertMany(java.util.List<? extends TDocument> documents, InsertManyOptions options) Inserts one or more documents.
void	insertOne(TDocument document) Inserts the provided document.
void	insertOne(TDocument document, InsertOneOptions options) Inserts the provided document.
ListIndexesIterable<Document>	listIndexes() Get all the indexes in this collection.
<TResult> ListIndexesIterable<TResult>	listIndexes(java.lang.Class<TResult> resultClass) Get all the indexes in this collection.
MapReduceIterable<TDocument>	mapReduce(java.lang.String mapFunction, java.lang.String reduceFunction) Aggregates documents according to the specified map-reduce function.
<TResult> MapReduceIterable<TResult>	mapReduce(java.lang.String mapFunction, java.lang.String reduceFunction, java.lang.Class<TResult> resultClass) Aggregates documents according to the specified map-reduce function.
void	renameCollection(MongoNamespace newCollectionNamespace) Rename the collection with oldCollectionName to the newCollectionName.
void	renameCollection(MongoNamespace newCollectionNamespace, RenameCollectionOptions renameCollectionOptions) Rename the collection with oldCollectionName to the newCollectionName.
UpdateResult	replaceOne(Bson filter, TDocument replacement) Replace a document in the collection according to the specified arguments.
UpdateResult	replaceOne(Bson filter, TDocument replacement, UpdateOptions updateOptions) Replace a document in the collection according to the specified arguments.
UpdateResult	updateMany(Bson filter, Bson update) Update all documents in the collection according to the specified arguments.
UpdateResult	updateMany(Bson filter, Bson update, UpdateOptions updateOptions) Update all documents in the collection according to the specified arguments.
UpdateResult	updateOne(Bson filter, Bson update) Update a single document in the collection according to the specified arguments.
UpdateResult	updateOne(Bson filter, Bson update, UpdateOptions updateOptions) Update a single document in the collection according to the specified arguments.
MongoCollection<TDocument>	withCodecRegistry(CodecRegistry codecRegistry) Create a new MongoCollection instance with a different codec registry.
<NewTDocument> MongoCollection<NewTDocument>	withDocumentClass(java.lang.Class<NewTDocument> clazz) Create a new MongoCollection instance with a different default class to cast any documents returned from the database into..
MongoCollection<TDocument>	withReadConcern(ReadConcern readConcern) Create a new MongoCollection instance with a different read concern.
MongoCollection<TDocument>	withReadPreference(ReadPreference readPreference) Create a new MongoCollection instance with a different read preference.
MongoCollection<TDocument>	withWriteConcern(WriteConcern writeConcern) Create a new MongoCollection instance with a different write concern.

方法详细资料

getNamespace

MongoNamespace getNamespace()

Gets the namespace of this collection.

返回:

the namespace

getDocumentClass

java.lang.Class<TDocument> getDocumentClass()

Get the class of documents stored in this collection.

返回:

the class

getCodecRegistry

CodecRegistry getCodecRegistry()

Get the codec registry for the MongoCollection.

返回:

the CodecRegistry

getReadPreference

ReadPreference getReadPreference()

Get the read preference for the MongoCollection.

返回:

the ReadPreference

getWriteConcern

WriteConcern getWriteConcern()

Get the write concern for the MongoCollection.

返回:

the WriteConcern

getReadConcern

ReadConcern getReadConcern()

Get the read concern for the MongoCollection.

返回:

the ReadConcern

从以下版本开始:

3.2

MongoDB documentation

Read Concern

Since server release

3.2

withDocumentClass

<NewTDocument> MongoCollection<NewTDocument> withDocumentClass(java.lang.Class<NewTDocument> clazz)

Create a new MongoCollection instance with a different default class to cast any documents returned from the database into..

类型参数:

NewTDocument - The type that the new collection will encode documents from and decode documents to

参数:

clazz - the default class to cast any documents returned from the database into.

返回:

a new MongoCollection instance with the different default class

withCodecRegistry

MongoCollection<TDocument> withCodecRegistry(CodecRegistry codecRegistry)

Create a new MongoCollection instance with a different codec registry.

参数:

codecRegistry - the new CodecRegistry for the collection

返回:

a new MongoCollection instance with the different codec registry

withReadPreference

MongoCollection<TDocument> withReadPreference(ReadPreference readPreference)

Create a new MongoCollection instance with a different read preference.

参数:

readPreference - the new ReadPreference for the collection

返回:

a new MongoCollection instance with the different readPreference

withWriteConcern

MongoCollection<TDocument> withWriteConcern(WriteConcern writeConcern)

Create a new MongoCollection instance with a different write concern.

参数:

writeConcern - the new WriteConcern for the collection

返回:

a new MongoCollection instance with the different writeConcern

withReadConcern

MongoCollection<TDocument> withReadConcern(ReadConcern readConcern)

Create a new MongoCollection instance with a different read concern.

参数:

readConcern - the new ReadConcern for the collection

返回:

a new MongoCollection instance with the different ReadConcern

从以下版本开始:

3.2

MongoDB documentation

Read Concern

Since server release

3.2

count

long count()

Counts the number of documents in the collection.

返回:

the number of documents in the collection

count

long count(Bson filter)

Counts the number of documents in the collection according to the given options.

参数:

filter - the query filter

返回:

the number of documents in the collection

count

long count(Bson filter,
           CountOptions options)

Counts the number of documents in the collection according to the given options.

参数:

filter - the query filter

options - the options describing the count

返回:

the number of documents in the collection

distinct

<TResult> DistinctIterable<TResult> distinct(java.lang.String fieldName,
                                             java.lang.Class<TResult> resultClass)

Gets the distinct values of the specified field name.

类型参数:

TResult - the target type of the iterable.

参数:

fieldName - the field name

resultClass - the class to cast any distinct items into.

返回:

an iterable of distinct values

MongoDB documentation

Distinct

distinct

<TResult> DistinctIterable<TResult> distinct(java.lang.String fieldName,
                                             Bson filter,
                                             java.lang.Class<TResult> resultClass)

Gets the distinct values of the specified field name.

类型参数:

TResult - the target type of the iterable.

参数:

fieldName - the field name

filter - the query filter

resultClass - the class to cast any distinct items into.

返回:

an iterable of distinct values

MongoDB documentation

Distinct

find

FindIterable<TDocument> find()

Finds all documents in the collection.

返回:

the find iterable interface

MongoDB documentation

Find

find

<TResult> FindIterable<TResult> find(java.lang.Class<TResult> resultClass)

Finds all documents in the collection.

类型参数:

TResult - the target document type of the iterable.

参数:

resultClass - the class to decode each document into

返回:

the find iterable interface

MongoDB documentation

Find

find

FindIterable<TDocument> find(Bson filter)

Finds all documents in the collection.

参数:

filter - the query filter

返回:

the find iterable interface

MongoDB documentation

Find

find

<TResult> FindIterable<TResult> find(Bson filter,
                                     java.lang.Class<TResult> resultClass)

Finds all documents in the collection.

类型参数:

TResult - the target document type of the iterable.

参数:

filter - the query filter

resultClass - the class to decode each document into

返回:

the find iterable interface

MongoDB documentation

Find

aggregate

AggregateIterable<TDocument> aggregate(java.util.List<? extends Bson> pipeline)

Aggregates documents according to the specified aggregation pipeline.

参数:

pipeline - the aggregate pipeline

返回:

an iterable containing the result of the aggregation operation

MongoDB documentation

Aggregation

Since server release

2.2

aggregate

<TResult> AggregateIterable<TResult> aggregate(java.util.List<? extends Bson> pipeline,
                                               java.lang.Class<TResult> resultClass)

Aggregates documents according to the specified aggregation pipeline.

类型参数:

TResult - the target document type of the iterable.

参数:

pipeline - the aggregate pipeline

resultClass - the class to decode each document into

返回:

an iterable containing the result of the aggregation operation

MongoDB documentation

Aggregation

Since server release

2.2

mapReduce

MapReduceIterable<TDocument> mapReduce(java.lang.String mapFunction,
                                       java.lang.String reduceFunction)

Aggregates documents according to the specified map-reduce function.

参数:

mapFunction - A JavaScript function that associates or "maps" a value with a key and emits the key and value pair.

reduceFunction - A JavaScript function that "reduces" to a single object all the values associated with a particular key.

返回:

an iterable containing the result of the map-reduce operation

MongoDB documentation

map-reduce

mapReduce

<TResult> MapReduceIterable<TResult> mapReduce(java.lang.String mapFunction,
                                               java.lang.String reduceFunction,
                                               java.lang.Class<TResult> resultClass)

Aggregates documents according to the specified map-reduce function.

类型参数:

TResult - the target document type of the iterable.

参数:

mapFunction - A JavaScript function that associates or "maps" a value with a key and emits the key and value pair.

reduceFunction - A JavaScript function that "reduces" to a single object all the values associated with a particular key.

resultClass - the class to decode each resulting document into.

返回:

an iterable containing the result of the map-reduce operation

MongoDB documentation

map-reduce

bulkWrite

BulkWriteResult bulkWrite(java.util.List<? extends WriteModel<? extends TDocument>> requests)

Executes a mix of inserts, updates, replaces, and deletes.

参数:

requests - the writes to execute

返回:

the result of the bulk write

抛出:

MongoBulkWriteException - if there's an exception in the bulk write operation

MongoException - if there's an exception running the operation

bulkWrite

BulkWriteResult bulkWrite(java.util.List<? extends WriteModel<? extends TDocument>> requests,
                          BulkWriteOptions options)

Executes a mix of inserts, updates, replaces, and deletes.

参数:

requests - the writes to execute

options - the options to apply to the bulk write operation

返回:

the result of the bulk write

抛出:

MongoBulkWriteException - if there's an exception in the bulk write operation

MongoException - if there's an exception running the operation

insertOne

void insertOne(TDocument document)

Inserts the provided document. If the document is missing an identifier, the driver should generate one.

参数:

document - the document to insert

抛出:

MongoWriteException - if the write failed due some other failure specific to the insert command

MongoWriteConcernException - if the write failed due being unable to fulfil the write concern

MongoException - if the write failed due some other failure

insertOne

void insertOne(TDocument document,
               InsertOneOptions options)

Inserts the provided document. If the document is missing an identifier, the driver should generate one.

参数:

document - the document to insert

options - the options to apply to the operation

抛出:

MongoWriteException - if the write failed due some other failure specific to the insert command

MongoWriteConcernException - if the write failed due being unable to fulfil the write concern

MongoCommandException - if the write failed due to document validation reasons

MongoException - if the write failed due some other failure

从以下版本开始:

3.2

insertMany

void insertMany(java.util.List<? extends TDocument> documents)

Inserts one or more documents. A call to this method is equivalent to a call to the bulkWrite method

参数:

documents - the documents to insert

抛出:

MongoBulkWriteException - if there's an exception in the bulk write operation

MongoException - if the write failed due some other failure

另请参阅:

bulkWrite(java.util.List<? extends com.mongodb.client.model.WriteModel<? extends TDocument>>)

insertMany

void insertMany(java.util.List<? extends TDocument> documents,
                InsertManyOptions options)

Inserts one or more documents. A call to this method is equivalent to a call to the bulkWrite method

参数:

documents - the documents to insert

options - the options to apply to the operation

抛出:

DuplicateKeyException - if the write failed to a duplicate unique key

WriteConcernException - if the write failed due being unable to fulfil the write concern

MongoException - if the write failed due some other failure

deleteOne

DeleteResult deleteOne(Bson filter)

Removes at most one document from the collection that matches the given filter. If no documents match, the collection is not modified.

参数:

filter - the query filter to apply the the delete operation

返回:

the result of the remove one operation

抛出:

MongoWriteException - if the write failed due some other failure specific to the delete command

MongoWriteConcernException - if the write failed due being unable to fulfil the write concern

MongoException - if the write failed due some other failure

deleteMany

DeleteResult deleteMany(Bson filter)

Removes all documents from the collection that match the given query filter. If no documents match, the collection is not modified.

参数:

filter - the query filter to apply the the delete operation

返回:

the result of the remove many operation

抛出:

MongoWriteException - if the write failed due some other failure specific to the delete command

MongoWriteConcernException - if the write failed due being unable to fulfil the write concern

MongoException - if the write failed due some other failure

replaceOne

UpdateResult replaceOne(Bson filter,
                        TDocument replacement)

Replace a document in the collection according to the specified arguments.

参数:

filter - the query filter to apply the the replace operation

replacement - the replacement document

返回:

the result of the replace one operation

抛出:

MongoWriteException - if the write failed due some other failure specific to the replace command

MongoWriteConcernException - if the write failed due being unable to fulfil the write concern

MongoException - if the write failed due some other failure

MongoDB documentation

Replace

replaceOne

UpdateResult replaceOne(Bson filter,
                        TDocument replacement,
                        UpdateOptions updateOptions)

Replace a document in the collection according to the specified arguments.

参数:

filter - the query filter to apply the the replace operation

replacement - the replacement document

updateOptions - the options to apply to the replace operation

返回:

the result of the replace one operation

抛出:

MongoWriteException - if the write failed due some other failure specific to the replace command

MongoWriteConcernException - if the write failed due being unable to fulfil the write concern

MongoException - if the write failed due some other failure

MongoDB documentation

Replace

updateOne

UpdateResult updateOne(Bson filter,
                       Bson update)

Update a single document in the collection according to the specified arguments.

参数:

filter - a document describing the query filter, which may not be null.

update - a document describing the update, which may not be null. The update to apply must include only update operators.

返回:

the result of the update one operation

抛出:

MongoWriteException - if the write failed due some other failure specific to the update command

MongoWriteConcernException - if the write failed due being unable to fulfil the write concern

MongoException - if the write failed due some other failure

MongoDB documentation

Updates

Update Operators

updateOne

UpdateResult updateOne(Bson filter,
                       Bson update,
                       UpdateOptions updateOptions)

Update a single document in the collection according to the specified arguments.

参数:

filter - a document describing the query filter, which may not be null.

update - a document describing the update, which may not be null. The update to apply must include only update operators.

updateOptions - the options to apply to the update operation

返回:

the result of the update one operation

抛出:

MongoWriteException - if the write failed due some other failure specific to the update command

MongoWriteConcernException - if the write failed due being unable to fulfil the write concern

MongoException - if the write failed due some other failure

MongoDB documentation

Updates

Update Operators

updateMany

UpdateResult updateMany(Bson filter,
                        Bson update)

Update all documents in the collection according to the specified arguments.

参数:

filter - a document describing the query filter, which may not be null.

update - a document describing the update, which may not be null. The update to apply must include only update operators.

返回:

the result of the update one operation

抛出:

MongoWriteException - if the write failed due some other failure specific to the update command

MongoWriteConcernException - if the write failed due being unable to fulfil the write concern

MongoException - if the write failed due some other failure

MongoDB documentation

Updates

Update Operators

updateMany

UpdateResult updateMany(Bson filter,
                        Bson update,
                        UpdateOptions updateOptions)

Update all documents in the collection according to the specified arguments.

参数:

filter - a document describing the query filter, which may not be null.

update - a document describing the update, which may not be null. The update to apply must include only update operators.

updateOptions - the options to apply to the update operation

返回:

the result of the update one operation

抛出:

MongoWriteException - if the write failed due some other failure specific to the update command

MongoWriteConcernException - if the write failed due being unable to fulfil the write concern

MongoException - if the write failed due some other failure

MongoDB documentation

Updates

Update Operators

findOneAndDelete

TDocument findOneAndDelete(Bson filter)

Atomically find a document and remove it.

参数:

filter - the query filter to find the document with

返回:

the document that was removed. If no documents matched the query filter, then null will be returned

findOneAndDelete

TDocument findOneAndDelete(Bson filter,
                           FindOneAndDeleteOptions options)

Atomically find a document and remove it.

参数:

filter - the query filter to find the document with

options - the options to apply to the operation

返回:

the document that was removed. If no documents matched the query filter, then null will be returned

findOneAndReplace

TDocument findOneAndReplace(Bson filter,
                            TDocument replacement)

Atomically find a document and replace it.

参数:

filter - the query filter to apply the the replace operation

replacement - the replacement document

返回:

the document that was replaced. Depending on the value of the returnOriginal property, this will either be the document as it was before the update or as it is after the update. If no documents matched the query filter, then null will be returned

findOneAndReplace

TDocument findOneAndReplace(Bson filter,
                            TDocument replacement,
                            FindOneAndReplaceOptions options)

Atomically find a document and replace it.

参数:

filter - the query filter to apply the the replace operation

replacement - the replacement document

options - the options to apply to the operation

返回:

the document that was replaced. Depending on the value of the returnOriginal property, this will either be the document as it was before the update or as it is after the update. If no documents matched the query filter, then null will be returned

findOneAndUpdate

TDocument findOneAndUpdate(Bson filter,
                           Bson update)

Atomically find a document and update it.

参数:

filter - a document describing the query filter, which may not be null.

update - a document describing the update, which may not be null. The update to apply must include only update operators.

返回:

the document that was updated before the update was applied. If no documents matched the query filter, then null will be returned

findOneAndUpdate

TDocument findOneAndUpdate(Bson filter,
                           Bson update,
                           FindOneAndUpdateOptions options)

Atomically find a document and update it.

参数:

filter - a document describing the query filter, which may not be null.

update - a document describing the update, which may not be null. The update to apply must include only update operators.

options - the options to apply to the operation

返回:

the document that was updated. Depending on the value of the returnOriginal property, this will either be the document as it was before the update or as it is after the update. If no documents matched the query filter, then null will be returned

drop

void drop()

Drops this collection from the Database.

MongoDB documentation

Drop Collection

createIndex

java.lang.String createIndex(Bson keys)

Create an index with the given keys.

参数:

keys - an object describing the index key(s), which may not be null.

返回:

the index name

MongoDB documentation

Create indexes

createIndex

java.lang.String createIndex(Bson keys,
                             IndexOptions indexOptions)

Create an index with the given keys and options.

参数:

keys - an object describing the index key(s), which may not be null.

indexOptions - the options for the index

返回:

the index name

MongoDB documentation

Create indexes

createIndexes

java.util.List<java.lang.String> createIndexes(java.util.List<IndexModel> indexes)

Create multiple indexes.

参数:

indexes - the list of indexes

返回:

the list of index names

MongoDB documentation

Create indexes

Since server release

2.6

listIndexes

ListIndexesIterable<Document> listIndexes()

Get all the indexes in this collection.

返回:

the list indexes iterable interface

MongoDB documentation

List indexes

listIndexes

<TResult> ListIndexesIterable<TResult> listIndexes(java.lang.Class<TResult> resultClass)

Get all the indexes in this collection.

类型参数:

TResult - the target document type of the iterable.

参数:

resultClass - the class to decode each document into

返回:

the list indexes iterable interface

MongoDB documentation

List indexes

dropIndex

void dropIndex(java.lang.String indexName)

Drops the index given its name.

参数:

indexName - the name of the index to remove

MongoDB documentation

Drop indexes

dropIndex

void dropIndex(Bson keys)

Drops the index given the keys used to create it.

参数:

keys - the keys of the index to remove

MongoDB documentation

Drop indexes

dropIndexes

void dropIndexes()

Drop all the indexes on this collection, except for the default on _id.

MongoDB documentation

Drop indexes

renameCollection

void renameCollection(MongoNamespace newCollectionNamespace)

Rename the collection with oldCollectionName to the newCollectionName.

参数:

newCollectionNamespace - the namespace the collection will be renamed to

抛出:

MongoServerException - if you provide a newCollectionName that is the name of an existing collection, or if the oldCollectionName is the name of a collection that doesn't exist

MongoDB documentation

Rename collection

renameCollection

void renameCollection(MongoNamespace newCollectionNamespace,
                      RenameCollectionOptions renameCollectionOptions)

Rename the collection with oldCollectionName to the newCollectionName.

参数:

newCollectionNamespace - the name the collection will be renamed to

renameCollectionOptions - the options for renaming a collection

抛出:

MongoServerException - if you provide a newCollectionName that is the name of an existing collection and dropTarget is false, or if the oldCollectionName is the name of a collection that doesn't exist

MongoDB documentation

Rename collection