com.mongodb

Class BulkWriteResult

java.lang.Object

com.mongodb.BulkWriteResult

public abstract class BulkWriteResult
extends Object

The result of a successful bulk write operation.

Since:

2.12

Constructor Summary

Constructors

Constructor and Description
BulkWriteResult()

Method Summary

Methods

Modifier and Type	Method and Description
abstract int	getInsertedCount() Returns the number of documents inserted by the write operation.
abstract int	getMatchedCount() Returns the number of documents matched by updates or replacements in the write operation.
abstract int	getModifiedCount() Returns the number of documents modified by updates or replacements in the write operation.
abstract int	getRemovedCount() Returns the number of documents removed by the write operation.
abstract List<BulkWriteUpsert>	getUpserts() Gets an unmodifiable list of upserted items, or the empty list if there were none.
abstract boolean	isAcknowledged() Returns true if the write was acknowledged.
abstract boolean	isModifiedCountAvailable() Returns true if the server was able to provide a count of modified documents.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BulkWriteResult

public BulkWriteResult()

Method Detail

isAcknowledged

public abstract boolean isAcknowledged()

Returns true if the write was acknowledged.

Returns:

true if the write was acknowledged

See Also:

WriteConcern.UNACKNOWLEDGED

getInsertedCount

public abstract int getInsertedCount()

Returns the number of documents inserted by the write operation.

Returns:

the number of documents inserted by the write operation

Throws:

UnacknowledgedWriteException - if the write was unacknowledged.

See Also:

WriteConcern.UNACKNOWLEDGED

getMatchedCount

public abstract int getMatchedCount()

Returns the number of documents matched by updates or replacements in the write operation. This will include documents that matched the query but where the modification didn't result in any actual change to the document; for example, if you set the value of some field, and the field already has that value, that will still count as an update.

Returns:

the number of documents matched by updates in the write operation

Throws:

UnacknowledgedWriteException - if the write was unacknowledged.

See Also:

WriteConcern.UNACKNOWLEDGED

getRemovedCount

public abstract int getRemovedCount()

Returns the number of documents removed by the write operation.

Returns:

the number of documents removed by the write operation

Throws:

UnacknowledgedWriteException - if the write was unacknowledged.

See Also:

WriteConcern.UNACKNOWLEDGED

isModifiedCountAvailable

public abstract boolean isModifiedCountAvailable()

Returns true if the server was able to provide a count of modified documents. If this method returns false (which can happen if the server is not at least version 2.6) then the getModifiedCount method will throw UnsupportedOperationException.

Returns:

true if modifiedCount is available

Throws:

UnacknowledgedWriteException - if the write was unacknowledged.

See Also:

WriteConcern.UNACKNOWLEDGED, getModifiedCount()

getModifiedCount

public abstract int getModifiedCount()

Returns the number of documents modified by updates or replacements in the write operation. This will only count documents that were actually changed; for example, if you set the value of some field, and the field already has that value, that will not count as a modification.

If the server is not able to provide a count of modified documents (which can happen if the server is not at least version 2.6), then this method will throw an UnsupportedOperationException

Returns:

the number of documents modified by the write operation

Throws:

UnacknowledgedWriteException - if the write was unacknowledged.

UnsupportedOperationException - if no modified count is available

See Also:

WriteConcern.UNACKNOWLEDGED, isModifiedCountAvailable()

Since server release

2.6

getUpserts

public abstract List<BulkWriteUpsert> getUpserts()

Gets an unmodifiable list of upserted items, or the empty list if there were none.

Returns:

a list of upserted items, or the empty list if there were none.

Throws:

UnacknowledgedWriteException - if the write was unacknowledged.

See Also:

WriteConcern.UNACKNOWLEDGED