Deprecated API

Contents

• Packages
• Interfaces
• Classes
• Enums
• Exceptions
• Fields
• Methods
• Constructors
• Enum Constants

Packages

Package	Description
com.mongodb.async
com.mongodb.binding
com.mongodb.operation

Interfaces

Interface	Description
com.mongodb.async.AsyncAggregateResponseBatchCursor
com.mongodb.async.AsyncBatchCursor	Prefer the Reactive Streams-based asynchronous driver (mongodb-driver-reactivestreams artifactId)
com.mongodb.async.SingleResultCallback	Prefer the Reactive Streams-based asynchronous driver (mongodb-driver-reactivestreams artifactId)
com.mongodb.binding.AsyncConnectionSource
com.mongodb.binding.AsyncReadBinding
com.mongodb.binding.AsyncReadWriteBinding
com.mongodb.binding.AsyncWriteBinding
com.mongodb.binding.ConnectionSource
com.mongodb.binding.ReadBinding
com.mongodb.binding.ReadWriteBinding
com.mongodb.binding.ReferenceCounted
com.mongodb.binding.WriteBinding
com.mongodb.connection.AsyncConnection
com.mongodb.connection.Cluster
com.mongodb.connection.ClusterFactory
com.mongodb.connection.Connection
com.mongodb.connection.Server
com.mongodb.event.ConnectionListener	- No longer used
com.mongodb.management.MBeanServer
com.mongodb.operation.AggregateResponseBatchCursor
com.mongodb.operation.AsyncOperationExecutor	there is no replacement for this interface
com.mongodb.operation.AsyncReadOperation
com.mongodb.operation.AsyncWriteOperation
com.mongodb.operation.BatchCursor
com.mongodb.operation.MapReduceAsyncBatchCursor
com.mongodb.operation.MapReduceBatchCursor
com.mongodb.operation.OperationExecutor	there is no replacement for this interface
com.mongodb.operation.ReadOperation
com.mongodb.operation.WriteOperation
com.mongodb.session.SessionContext	there is no replacement for this class
com.mongodb.util.ObjectSerializer	there is no replacement for this interface

Classes

Class	Description
com.mongodb.AggregationOutput	Replace with use of aggregate methods in DBCollection that return instances of Cursor.
com.mongodb.binding.AsyncClusterBinding
com.mongodb.binding.AsyncSingleConnectionReadBinding
com.mongodb.binding.AsyncSingleServerBinding
com.mongodb.binding.ClusterBinding
com.mongodb.binding.SingleConnectionReadBinding
com.mongodb.binding.SingleServerBinding
com.mongodb.bulk.DeleteRequest
com.mongodb.bulk.IndexRequest
com.mongodb.bulk.InsertRequest
com.mongodb.bulk.UpdateRequest
com.mongodb.bulk.WriteRequest
com.mongodb.Bytes	there is no replacement for this class
com.mongodb.client.gridfs.model.GridFSDownloadByNameOptions	use GridFSDownloadOptions instead.
com.mongodb.client.model.FindOptions	there is no replacement for this class
com.mongodb.client.model.ParallelCollectionScanOptions	this is an unused class and there should be no reason to use it
com.mongodb.connection.BulkWriteBatchCombiner
com.mongodb.connection.ByteBufferBsonOutput
com.mongodb.connection.DefaultClusterFactory
com.mongodb.connection.QueryResult
com.mongodb.connection.SplittablePayload
com.mongodb.DBAddress	This class is no longer needed, as the driver does not rely on it for anything anymore. Use ServerAddress instead.
com.mongodb.event.ClusterEventMulticaster	register multiple cluster listeners instead
com.mongodb.event.CommandEventMulticaster	register multiple command listeners instead
com.mongodb.event.CommandListenerMulticaster	register multiple command listeners in the settings
com.mongodb.event.ConnectionClosedEvent	there is no replacement for this class
com.mongodb.event.ConnectionMessageReceivedEvent	- No longer used
com.mongodb.event.ConnectionMessagesSentEvent	- No longer used
com.mongodb.event.ConnectionOpenedEvent	there is no replacement for this class
com.mongodb.event.ConnectionPoolEventMulticaster	register multiple command listeners instead
com.mongodb.event.ConnectionPoolWaitQueueEnteredEvent	In the next major release, this event will no longer be published
com.mongodb.event.ConnectionPoolWaitQueueExitedEvent	In the next major release, this event will no longer be published
com.mongodb.event.ServerEventMulticaster	register multiple server listeners instead
com.mongodb.event.ServerMonitorEventMulticaster	register multiple server monitor listeners instead
com.mongodb.gridfs.CLI	there is no replacement for this class
com.mongodb.GroupCommand	the group command was deprecated in MongoDB 3.4
com.mongodb.management.MBeanServerFactory
com.mongodb.management.NullMBeanServer
com.mongodb.Mongo	Replaced by MongoClient. Any non-deprecated methods will be moved to MongoClient. The rest will be removed along with this class.
com.mongodb.Mongo.Holder
com.mongodb.MongoOptions	Please use MongoClientOptions instead.
com.mongodb.MongoURI	Replaced by MongoClientURI
com.mongodb.operation.AbortTransactionOperation
com.mongodb.operation.AggregateOperation
com.mongodb.operation.AggregateToCollectionOperation
com.mongodb.operation.BaseFindAndModifyOperation
com.mongodb.operation.BaseWriteOperation
com.mongodb.operation.ChangeStreamOperation
com.mongodb.operation.CommandReadOperation
com.mongodb.operation.CommandWriteOperation
com.mongodb.operation.CommitTransactionOperation
com.mongodb.operation.CountOperation
com.mongodb.operation.CreateCollectionOperation
com.mongodb.operation.CreateIndexesOperation
com.mongodb.operation.CreateUserOperation	use CommandWriteOperation directly or the mongod shell helpers.
com.mongodb.operation.CreateViewOperation
com.mongodb.operation.CurrentOpOperation
com.mongodb.operation.DeleteOperation
com.mongodb.operation.DistinctOperation
com.mongodb.operation.DropCollectionOperation
com.mongodb.operation.DropDatabaseOperation
com.mongodb.operation.DropIndexOperation
com.mongodb.operation.DropUserOperation	use CommandWriteOperation directly or the mongod shell helpers.
com.mongodb.operation.FindAndDeleteOperation
com.mongodb.operation.FindAndReplaceOperation
com.mongodb.operation.FindAndUpdateOperation
com.mongodb.operation.FindOperation
com.mongodb.operation.FsyncUnlockOperation
com.mongodb.operation.GroupOperation
com.mongodb.operation.InsertOperation
com.mongodb.operation.ListCollectionsOperation
com.mongodb.operation.ListDatabasesOperation
com.mongodb.operation.ListIndexesOperation
com.mongodb.operation.MapReduceStatistics
com.mongodb.operation.MapReduceToCollectionOperation
com.mongodb.operation.MapReduceWithInlineResultsOperation
com.mongodb.operation.MixedBulkWriteOperation
com.mongodb.operation.ParallelCollectionScanOperation
com.mongodb.operation.RenameCollectionOperation
com.mongodb.operation.TransactionOperation
com.mongodb.operation.UpdateOperation
com.mongodb.operation.UpdateUserOperation	use CommandWriteOperation directly or the mongod shell helpers.
com.mongodb.operation.UserExistsOperation	use CommandWriteOperation directly or the mongod shell helpers.
com.mongodb.ParallelScanOptions	the parallelCollectionScan command will be removed in MongoDB 4.2
com.mongodb.ReflectionDBObject	Replaced by PojoCodecProvider
com.mongodb.ReplicaSetStatus	Prefer MongoClientOptions.Builder.addClusterListener(ClusterListener)
com.mongodb.selector.LatencyMinimizingServerSelector
com.mongodb.selector.PrimaryServerSelector	Use either ReadPreferenceServerSelector or WritableServerSelector, depending on your requirements
com.mongodb.selector.ReadPreferenceServerSelector
com.mongodb.selector.ServerAddressSelector
com.mongodb.selector.WritableServerSelector
com.mongodb.util.JSON	This class has been superseded by to toJson and parse methods on BasicDBObject
com.mongodb.util.JSONCallback	This class has been superseded by to toJson and parse methods on BasicDBObject
com.mongodb.util.JSONSerializers	This class has been superseded by to toJson and parse methods on BasicDBObject
com.mongodb.util.Util	there is no replacement for this class
com.mongodb.WriteConcern.Majority	Prefer WriteConcern.MAJORITY, WriteConcern.withWTimeout(long, TimeUnit), WriteConcern.withJournal(Boolean)
org.bson.BSON	there is no replacement for this class
org.bson.io.Bits	there is no replacement for this utility class
org.bson.util.ClassMap	there is no replacement for this class

Enums

Enum	Description
com.mongodb.AggregationOptions.OutputMode	There is no replacement for this. Applications can assume that the driver will use a cursor for server versions that support it (>= 2.6). The driver will ignore this as of MongoDB 3.6, which does not support inline results for the aggregate command.
com.mongodb.client.model.AggregationLevel
com.mongodb.client.model.changestream.ChangeStreamLevel
com.mongodb.operation.OrderBy

Exceptions

Exceptions	Description
com.mongodb.MongoWaitQueueFullException	In the next major release the limit on wait queue size will be removed, so this exception will no longer be thrown
com.mongodb.util.JSONParseException	there is no replacement for this class

Fields

Field	Description
com.mongodb.gridfs.GridFS.MAX_CHUNKSIZE	You can calculate max chunkSize with a similar formula Mongo.getMaxBsonObjectSize() - 500*1000. Please ensure that you left enough space for metadata (500kb is enough).
com.mongodb.MongoCredential.MONGODB_CR_MECHANISM	This mechanism was replaced by MongoCredential.SCRAM_SHA_1_MECHANISM in MongoDB 3.0, and is now deprecated
com.mongodb.QueryOperators.COMMENT
com.mongodb.QueryOperators.EXPLAIN
com.mongodb.QueryOperators.HINT
com.mongodb.QueryOperators.MAX
com.mongodb.QueryOperators.MAX_SCAN
com.mongodb.QueryOperators.MIN
com.mongodb.QueryOperators.ORDER_BY
com.mongodb.QueryOperators.RETURN_KEY
com.mongodb.QueryOperators.SHOW_DISK_LOC
com.mongodb.QueryOperators.SNAPSHOT
com.mongodb.WriteConcern.FSYNC_SAFE	Prefer WriteConcern.JOURNALED
com.mongodb.WriteConcern.FSYNCED	Prefer WriteConcern.JOURNALED
com.mongodb.WriteConcern.JOURNAL_SAFE	Prefer WriteConcern.JOURNALED
com.mongodb.WriteConcern.NORMAL	Prefer WriteConcern.UNACKNOWLEDGED
com.mongodb.WriteConcern.REPLICA_ACKNOWLEDGED	Prefer WriteConcern#W2
com.mongodb.WriteConcern.REPLICAS_SAFE	Prefer WriteConcern.W2
com.mongodb.WriteConcern.SAFE	Prefer WriteConcern.ACKNOWLEDGED

Methods

Method	Description
com.mongodb.AggregationOptions.Builder.outputMode(AggregationOptions.OutputMode)	There is no replacement for this. Applications can assume that the driver will use a cursor for server versions that support it (>= 2.6). The driver will ignore this as of MongoDB 3.6, which does not support inline results for the aggregate command.
com.mongodb.AggregationOptions.getOutputMode()	There is no replacement for this. Applications can assume that the driver will use a cursor for server versions that support it (>= 2.6). The driver will ignore this as of MongoDB 3.6, which does not support inline results for the aggregate command.
com.mongodb.bulk.BulkWriteResult.isModifiedCountAvailable()	no longer needed since all supported server versions support modified count
com.mongodb.bulk.UpdateRequest.getUpdate()	use UpdateRequest.getUpdateValue() instead
com.mongodb.BulkWriteResult.isModifiedCountAvailable()	no longer needed since all supported server versions support modified count
com.mongodb.client.AggregateIterable.useCursor(Boolean)	There is no replacement for this. Applications can assume that the driver will use a cursor for server versions that support it (>= 2.6). The driver will ignore this as of MongoDB 3.6, which does not support inline results for the aggregate command.
com.mongodb.client.FindIterable.maxScan(long)	Deprecated as of MongoDB 4.0 release
com.mongodb.client.FindIterable.modifiers(Bson)	use the individual setters instead
com.mongodb.client.FindIterable.snapshot(boolean)	Deprecated in MongoDB 3.6 release and removed in MongoDB 4.0 release
com.mongodb.client.gridfs.GridFSBucket.downloadToStreamByName(String, OutputStream)	use GridFSBucket.downloadToStream(String, OutputStream) instead.
com.mongodb.client.gridfs.GridFSBucket.getDisableMD5()	there is no replacement for this method, as MD5 is being removed
com.mongodb.client.gridfs.GridFSBucket.openDownloadStreamByName(String)	use GridFSBucket.openDownloadStream(String) instead.
com.mongodb.client.gridfs.GridFSBucket.withDisableMD5(boolean)	there is no replacement for this method, as MD5 is being removed
com.mongodb.client.gridfs.GridFSUploadStream.getFileId()	use GridFSUploadStream.getObjectId() instead.
com.mongodb.client.gridfs.model.GridFSFile.getAliases()	any aliases should be stored in the metadata document instead.
com.mongodb.client.gridfs.model.GridFSFile.getContentType()	content type information should be stored the metadata document instead.
com.mongodb.client.gridfs.model.GridFSFile.getExtraElements()	any extra information should be stored in the metadata document instead.
com.mongodb.client.gridfs.model.GridFSFile.getMD5()	file hashing is deprecated and may be removed in the future.
com.mongodb.client.model.CreateCollectionOptions.autoIndex(boolean)	this option was deprecated in MongoDB 3.2 and removed in MongodB 4.0
com.mongodb.client.model.CreateCollectionOptions.isAutoIndex()	this option was deprecated in MongoDB 3.2 and removed in MongodB 4.0
com.mongodb.client.model.CreateCollectionOptions.isUsePowerOf2Sizes()	As of MongoDB 3.0, power of 2 sizes is ignored by the MongoDB server
com.mongodb.client.model.CreateCollectionOptions.usePowerOf2Sizes(Boolean)	As of MongoDB 3.0, power of 2 sizes is ignored by the MongoDB server
com.mongodb.client.model.DBCollectionFindOptions.getModifiers()	use the individual setters instead
com.mongodb.client.model.DBCollectionFindOptions.modifiers(DBObject)	use the individual setters instead
com.mongodb.client.model.Filters.text(String, String)	use Filters.text(String, TextSearchOptions)
com.mongodb.client.model.FindOptions.getMaxScan()	Deprecated as of MongoDB 4.0 release
com.mongodb.client.model.FindOptions.getModifiers()	use the individual modifier methods instead.
com.mongodb.client.model.FindOptions.isSnapshot()	Deprecated in MongoDB 3.6 release and removed in MongoDB 4.0 release
com.mongodb.client.model.FindOptions.maxScan(long)	Deprecated as of MongoDB 4.0 release
com.mongodb.client.model.FindOptions.modifiers(Bson)	use the individual modifier methods instead.
com.mongodb.client.model.FindOptions.snapshot(boolean)	Deprecated in MongoDB 3.6 release and removed in MongoDB 4.0 release
com.mongodb.client.model.ReplaceOneModel.getOptions()	use ReplaceOneModel.getReplaceOptions() instead
com.mongodb.client.model.ReplaceOptions.createReplaceOptions(UpdateOptions)	there is no replacement for this method
com.mongodb.client.MongoCollection.count()	use MongoCollection.countDocuments() or MongoCollection.estimatedDocumentCount() instead
com.mongodb.client.MongoCollection.replaceOne(Bson, TDocument, UpdateOptions)	use MongoCollection.replaceOne(Bson, Object, ReplaceOptions) instead
com.mongodb.client.MongoIterable.forEach(Block<? super TResult>)	Prefer Iterable.forEach(Consumer), which was added in Java 8
com.mongodb.client.result.UpdateResult.isModifiedCountAvailable()	no longer needed since all supported server versions support modified count
com.mongodb.connection.AsyncConnection.commandAsync(String, BsonDocument, boolean, FieldNameValidator, Decoder<T>, SingleResultCallback<T>)	Prefer AsyncConnection.commandAsync(String, BsonDocument, FieldNameValidator, ReadPreference, Decoder, SessionContext, SingleResultCallback)
com.mongodb.connection.AsyncConnection.killCursorAsync(List<Long>, SingleResultCallback<Void>)	Replaced by AsyncConnection.killCursorAsync(MongoNamespace, List, SingleResultCallback)
com.mongodb.connection.AsyncConnection.queryAsync(MongoNamespace, BsonDocument, BsonDocument, int, int, boolean, boolean, boolean, boolean, boolean, boolean, Decoder<T>, SingleResultCallback<QueryResult<T>>)	Replaced by AsyncConnection.queryAsync(MongoNamespace, BsonDocument, BsonDocument, int, int, int, boolean, boolean, boolean, boolean, boolean, boolean, Decoder, SingleResultCallback)
com.mongodb.connection.ClusterDescription.getAll()	Use ClusterDescription.getServerDescriptions() instead
com.mongodb.connection.ClusterDescription.getAny()	Replace with a filter on ServerDescription in the caller
com.mongodb.connection.ClusterDescription.getAnyPrimaryOrSecondary()	Replace with a filter on ServerDescription in the caller
com.mongodb.connection.ClusterDescription.getByServerAddress(ServerAddress)	Replace with a filter on ServerDescription in the caller
com.mongodb.connection.ClusterDescription.getPrimaries()	Replace with a filter on ServerDescription in the caller
com.mongodb.connection.ClusterDescription.getSecondaries()	Replace with a filter on ServerDescription in the caller
com.mongodb.connection.ClusterSettings.Builder.description(String)	Prefer MongoClientSettings.Builder.applicationName(String)
com.mongodb.connection.ClusterSettings.Builder.maxWaitQueueSize(int)	in the next major release, wait queue size limitations will be removed
com.mongodb.connection.ClusterSettings.getDescription()	Prefer MongoClientSettings.getApplicationName()
com.mongodb.connection.ClusterSettings.getMaxWaitQueueSize()	in the next major release, wait queue size limitations will be removed
com.mongodb.connection.Connection.command(String, BsonDocument, boolean, FieldNameValidator, Decoder<T>)	Prefer Connection.command(String, BsonDocument, FieldNameValidator, ReadPreference, Decoder, SessionContext)
com.mongodb.connection.Connection.killCursor(List<Long>)	Replaced by Connection.killCursor(MongoNamespace, List)
com.mongodb.connection.Connection.query(MongoNamespace, BsonDocument, BsonDocument, int, int, boolean, boolean, boolean, boolean, boolean, boolean, Decoder<T>)	Replaced by Connection.query(MongoNamespace, BsonDocument, BsonDocument, int, int, int, boolean, boolean, boolean, boolean, boolean, boolean, Decoder)
com.mongodb.connection.ConnectionDescription.getServerVersion()	Use ConnectionDescription.getMaxWireVersion() instead
com.mongodb.connection.ConnectionPoolSettings.Builder.maxWaitQueueSize(int)	in the next major release, wait queue size limitations will be removed
com.mongodb.connection.ConnectionPoolSettings.getMaxWaitQueueSize()	in the next major release, wait queue size limitations will be removed
com.mongodb.connection.DefaultClusterFactory.create(ClusterSettings, ServerSettings, ConnectionPoolSettings, StreamFactory, StreamFactory, List<MongoCredential>, ClusterListener, ConnectionPoolListener, ConnectionListener, CommandListener)	use DefaultClusterFactory.createCluster(ClusterSettings, ServerSettings, ConnectionPoolSettings, StreamFactory, StreamFactory, List, CommandListener, String, MongoDriverInformation, List) instead
com.mongodb.connection.DefaultClusterFactory.createCluster(ClusterSettings, ServerSettings, ConnectionPoolSettings, StreamFactory, StreamFactory, List<MongoCredential>, CommandListener, String, MongoDriverInformation)	use DefaultClusterFactory.createCluster(ClusterSettings, ServerSettings, ConnectionPoolSettings, StreamFactory, StreamFactory, List, CommandListener, String, MongoDriverInformation, List) instead
com.mongodb.connection.ServerDescription.Builder.version(ServerVersion)	Use ServerDescription.Builder.maxWireVersion instead
com.mongodb.connection.ServerDescription.getVersion()	Use ServerDescription.getMaxWireVersion() instead
com.mongodb.connection.SocketSettings.Builder.keepAlive(boolean)	configuring keep-alive has been deprecated. It now defaults to true and disabling it is not recommended.
com.mongodb.connection.SocketSettings.isKeepAlive()	configuring keep-alive has been deprecated. It now defaults to true and disabling it is not recommended.
com.mongodb.ConnectionString.getCredentialList()	Prefer ConnectionString.getCredential()
com.mongodb.ConnectionString.getRetryWrites()	Prefer ConnectionString.getRetryWritesValue()
com.mongodb.ConnectionString.getStreamType()	Use MongoClientSettings.Builder.streamFactoryFactory(StreamFactoryFactory) to configure the stream type programmatically
com.mongodb.ConnectionString.getThreadsAllowedToBlockForConnectionMultiplier()	in the next major release, wait queue size limitations will be removed
com.mongodb.ConnectionString.getURI()
com.mongodb.DB.addOption(int)	Replaced with DBCursor.addOption(int)
com.mongodb.DB.addUser(String, char[])	Use DB.command to call either the createUser or updateUser command
com.mongodb.DB.doEval(String, Object...)	The eval command was deprecated in MongoDB 3.0
com.mongodb.DB.doGetCollection(String)	there is no replacement for this method
com.mongodb.DB.eval(String, Object...)	The eval command was deprecated in MongoDB 3.0
com.mongodb.DB.getCollectionFromString(String)	Prefer DB.getCollection(String)
com.mongodb.DB.getMongo()	Use DB.getMongoClient() instead
com.mongodb.DB.getOptions()	Replaced with DBCursor.getOptions()
com.mongodb.DB.getStats()	Prefer DB.command(DBObject) to run the dbStats command
com.mongodb.DB.removeUser(String)	Use DB.command to call the dropUser command
com.mongodb.DB.resetOptions()	Replaced with DBCursor.resetOptions()
com.mongodb.DB.setOptions(int)	Replaced with DBCursor.setOptions(int)
com.mongodb.DB.slaveOk()	Replaced with ReadPreference.secondaryPreferred()
com.mongodb.DBCollection.addOption(int)	Replaced with DBCursor.addOption(int)
com.mongodb.DBCollection.aggregate(DBObject, DBObject...)	Use DBCollection.aggregate(List, AggregationOptions) instead
com.mongodb.DBCollection.find(DBObject, DBObject, int, int, int)	use DBCursor.skip(int), DBCursor.batchSize(int) and DBCursor.setOptions(int) on the DBCursor returned from DBCollection.find(DBObject, DBObject)
com.mongodb.DBCollection.getCount(DBObject, DBObject)	Prefer DBCollection.count(DBObject, DBCollectionCountOptions)
com.mongodb.DBCollection.getHintFields()	Prefer DBCursor.hint(DBObject)
com.mongodb.DBCollection.getOptions()	Replaced with DBCursor.getOptions()
com.mongodb.DBCollection.group(DBObject, DBObject, DBObject, String)	The group command was deprecated in MongoDB 3.4
com.mongodb.DBCollection.parallelScan(ParallelScanOptions)	the parallelCollectionScan command will be removed in MongoDB 4.2
com.mongodb.DBCollection.resetOptions()	Replaced with DBCursor.resetOptions()
com.mongodb.DBCollection.setHintFields(List<? extends DBObject>)	Prefer DBCursor.hint(DBObject)
com.mongodb.DBCollection.setOptions(int)	Replaced with DBCursor.setOptions(int)
com.mongodb.DBCollection.slaveOk()	Replaced with ReadPreference.secondaryPreferred()
com.mongodb.DBCursor.addOption(int)	Prefer per-option methods, e.g. DBCursor.cursorType(CursorType), DBCursor.noCursorTimeout(boolean), etc.
com.mongodb.DBCursor.addSpecial(String, Object)	Prefer per-operator methods, e.g. DBCursor.comment(String), DBCursor.explain(), etc.
com.mongodb.DBCursor.explain()	Replace with direct use of the explain command using the runCommand helper method
com.mongodb.DBCursor.getOptions()
com.mongodb.DBCursor.hint(String)	Prefer DBCursor.hint(DBObject)
com.mongodb.DBCursor.maxScan(int)	Deprecated as of MongoDB 4.0 release
com.mongodb.DBCursor.resetOptions()
com.mongodb.DBCursor.setOptions(int)
com.mongodb.DBCursor.showDiskLoc()	showDiskLoc has been deprecated in the MongoDB server. There is no replacement for it.
com.mongodb.DBCursor.slaveOk()	Replaced with ReadPreference.secondaryPreferred()
com.mongodb.DBCursor.snapshot()	Deprecated in MongoDB 3.6 release and removed in MongoDB 4.0 release
com.mongodb.event.ConnectionPoolListener.waitQueueEntered(ConnectionPoolWaitQueueEnteredEvent)	In the next major release, this event will no longer be published
com.mongodb.event.ConnectionPoolListener.waitQueueExited(ConnectionPoolWaitQueueExitedEvent)	In the next major release, this event will no longer be published
com.mongodb.gridfs.GridFSFile.containsKey(String)
com.mongodb.gridfs.GridFSFile.getMD5()	there is no replacement for this method
com.mongodb.gridfs.GridFSFile.validate()	there is no replacement for this method
com.mongodb.LazyDBList.toString()	there is no replacement for this method, as the driver no longer supports generating top-level JSON arrays. To encode an instance of this class to JSON it must be embedded inside a document.
com.mongodb.management.ConnectionPoolStatisticsMBean.getWaitQueueSize()	In the next major release, wait queue events will no longer be published so this statistic will be unavailable
com.mongodb.Mongo.addOption(int)	Add options instead on instances of DBCursor
com.mongodb.Mongo.fsync(boolean)
com.mongodb.Mongo.fsyncAndLock()
com.mongodb.Mongo.getAddress()
com.mongodb.Mongo.getAllAddress()
com.mongodb.Mongo.getConnectPoint()
com.mongodb.Mongo.getDatabaseNames()	Replaced with MongoClient.listDatabaseNames()
com.mongodb.Mongo.getDB(String)	This method is not currently scheduled for removal, but prefer MongoClient.getDatabase(String) for new code. Note that DB and MongoDatabase can be used together in the same application, whith the same MongoClient instance.
com.mongodb.Mongo.getMaxBsonObjectSize()
com.mongodb.Mongo.getMongoOptions()	Please use MongoClient class to connect to server and corresponding MongoClient.getMongoClientOptions()
com.mongodb.Mongo.getOptions()	Get options instead from instances of DBCursor
com.mongodb.Mongo.getReplicaSetStatus()
com.mongodb.Mongo.getServerAddressList()
com.mongodb.Mongo.getUsedDatabases()
com.mongodb.Mongo.Holder.connect(MongoURI)	Please use Mongo.Holder.connect(MongoClientURI) instead.
com.mongodb.Mongo.isLocked()
com.mongodb.Mongo.resetOptions()	Reset options instead on instances of DBCursor
com.mongodb.Mongo.setOptions(int)	Set options on instances of DBCursor
com.mongodb.Mongo.setReadPreference(ReadPreference)	Set the default read preference with either MongoClientURI or MongoClientOptions
com.mongodb.Mongo.setWriteConcern(WriteConcern)	Set the default write concern with either MongoClientURI or MongoClientOptions
com.mongodb.Mongo.slaveOk()	Replaced with ReadPreference.secondaryPreferred()
com.mongodb.Mongo.unlock()
com.mongodb.MongoClient.getCredentialsList()	Prefer MongoClient.getCredential()
com.mongodb.MongoClientOptions.Builder.alwaysUseMBeans(boolean)	there is no replacement for this property
com.mongodb.MongoClientOptions.Builder.description(String)	Prefer MongoClientOptions.Builder.applicationName(String)
com.mongodb.MongoClientOptions.Builder.legacyDefaults()	there is no replacement for this method
com.mongodb.MongoClientOptions.Builder.socketFactory(SocketFactory)	Prefer MongoClientOptions.Builder.sslEnabled(boolean) and MongoClientOptions.Builder.sslContext(SSLContext)
com.mongodb.MongoClientOptions.Builder.socketKeepAlive(boolean)	configuring keep-alive has been deprecated. It now defaults to true and disabling it is not recommended.
com.mongodb.MongoClientOptions.Builder.threadsAllowedToBlockForConnectionMultiplier(int)	in the next major release, wait queue size limitations will be removed
com.mongodb.MongoClientOptions.getDescription()	Prefer MongoClientOptions.getApplicationName()
com.mongodb.MongoClientOptions.getSocketFactory()	Prefer MongoClientOptions.isSslEnabled() and MongoClientOptions.getSslContext()
com.mongodb.MongoClientOptions.getThreadsAllowedToBlockForConnectionMultiplier()	in the next major release, wait queue size limitations will be removed
com.mongodb.MongoClientOptions.isAlwaysUseMBeans()	there is no replacement for this property
com.mongodb.MongoClientOptions.isSocketKeepAlive()	configuring keep-alive has been deprecated. It now defaults to true and disabling it is not recommended.
com.mongodb.MongoCredential.createMongoCRCredential(String, String, char[])	MONGODB-CR was replaced by SCRAM-SHA-1 in MongoDB 3.0, and is now deprecated. Use the MongoCredential.createCredential(String, String, char[]) factory method instead.
com.mongodb.operation.AggregateOperation.getUseCursor()	There is no replacement for this. Applications can assume that the driver will use a cursor for server versions that support it (>= 2.6). The driver will ignore this as of MongoDB 3.6, which does not support inline results for the aggregate command.
com.mongodb.operation.AggregateOperation.useCursor(Boolean)	There is no replacement for this. Applications can assume that the driver will use a cursor for server versions that support it (>= 2.6). The driver will ignore this as of MongoDB 3.6, which does not support inline results for the aggregate command.
com.mongodb.operation.ChangeStreamOperation.getResumeToken()	use ChangeStreamOperation.getResumeAfter() instead
com.mongodb.operation.CreateCollectionOperation.isUsePowerOf2Sizes()	As of MongoDB 3.0, power of 2 sizes is ignored by the MongoDB server
com.mongodb.operation.CreateCollectionOperation.usePowerOf2Sizes(Boolean)	As of MongoDB 3.0, power of 2 sizes is ignored by the MongoDB server
com.mongodb.operation.FindOperation.getMaxScan()	Deprecated as of MongoDB 4.0 release
com.mongodb.operation.FindOperation.isSnapshot()	Deprecated in MongoDB 3.6 release and removed in MongoDB 4.0 release
com.mongodb.operation.FindOperation.maxScan(long)	Deprecated as of MongoDB 4.0 release
com.mongodb.operation.FindOperation.modifiers(BsonDocument)	use the individual setters instead
com.mongodb.operation.FindOperation.snapshot(boolean)	Deprecated in MongoDB 3.6 release and removed in MongoDB 4.0 release
com.mongodb.operation.FsyncUnlockOperation.execute(WriteBinding)	use FsyncUnlockOperation.execute(ReadBinding) instead.
com.mongodb.ReflectionDBObject.JavaWrapper.containsKey(String)
com.mongodb.ServerAddress.sameHost(String)	use the ServerAddress.equals(Object) method instead
com.mongodb.WriteConcern.callGetLastError()	Prefer WriteConcern.isAcknowledged()
com.mongodb.WriteConcern.fsync()	Prefer WriteConcern.getJournal()
com.mongodb.WriteConcern.getFsync()	Prefer WriteConcern.getJournal()
com.mongodb.WriteConcern.getJ()	Prefer WriteConcern.getJournal()
com.mongodb.WriteConcern.getWtimeout()	Prefer WriteConcern.getWTimeout(TimeUnit)
com.mongodb.WriteConcern.majorityWriteConcern(int, boolean, boolean)	Prefer WriteConcern.MAJORITY, WriteConcern.withWTimeout(long, TimeUnit), WriteConcern.withJournal(Boolean)
com.mongodb.WriteConcern.withFsync(boolean)	Prefer WriteConcern.withJournal(Boolean)
com.mongodb.WriteConcern.withJ(boolean)	Prefer WriteConcern.withJournal(Boolean)
org.bson.BasicBSONCallback.gotBinaryArray(String, byte[])
org.bson.BasicBSONObject.containsKey(String)
org.bson.BsonBinaryReader.mark()
org.bson.BsonBinaryReader.reset()
org.bson.BSONCallback.gotBinaryArray(String, byte[])	this method is no longer called by the decoder
org.bson.BsonDocumentReader.mark()
org.bson.BsonDocumentReader.reset()
org.bson.BSONObject.containsKey(String)	Please use BSONObject.containsField(String) instead
org.bson.BsonReader.mark()	Use BsonReader.getMark() instead
org.bson.BsonReader.reset()	Prefer BsonReader.getMark()
org.bson.EmptyBSONCallback.gotBinaryArray(String, byte[])
org.bson.io.BsonInput.mark(int)	Use BsonInput.getMark(int) instead
org.bson.io.BsonInput.reset()	Prefer BsonInput.getMark(int)
org.bson.io.ByteBufferBsonInput.mark(int)
org.bson.io.ByteBufferBsonInput.reset()
org.bson.json.JsonReader.mark()
org.bson.json.JsonReader.reset()
org.bson.LazyBSONObject.containsKey(String)
org.bson.types.BasicBSONList.containsKey(String)
org.bson.types.ObjectId.createFromLegacyFormat(int, int, int)	Use ObjectId(int, int) instead
org.bson.types.ObjectId.getCounter()
org.bson.types.ObjectId.getCurrentCounter()
org.bson.types.ObjectId.getGeneratedMachineIdentifier()
org.bson.types.ObjectId.getGeneratedProcessIdentifier()
org.bson.types.ObjectId.getMachineIdentifier()
org.bson.types.ObjectId.getProcessIdentifier()
org.bson.types.ObjectId.getTime()	Use #getDate instead
org.bson.types.ObjectId.getTimeSecond()	Use #getTimestamp instead
org.bson.types.ObjectId.toStringMongod()	use ObjectId.toHexString()

Constructors

Constructor	Description
com.mongodb.binding.AsyncClusterBinding(Cluster, ReadPreference)	Prefer AsyncClusterBinding(Cluster, ReadPreference, ReadConcern)
com.mongodb.binding.ClusterBinding(Cluster, ReadPreference)	Prefer ClusterBinding(Cluster, ReadPreference, ReadConcern)
com.mongodb.bulk.WriteConcernError(int, String, BsonDocument)
com.mongodb.client.gridfs.model.GridFSFile(BsonValue, String, long, int, Date, String, Document)	there is no replacement for this constructor
com.mongodb.client.model.changestream.ChangeStreamDocument(BsonDocument, MongoNamespace, TDocument, BsonDocument, OperationType, UpdateDescription)	Prefer ChangeStreamDocument(OperationType, BsonDocument, BsonDocument, BsonDocument, Object, BsonDocument, BsonTimestamp, UpdateDescription)
com.mongodb.client.model.FindOptions(FindOptions)	this constructor is unused
com.mongodb.client.model.ReplaceOneModel(Bson, T, UpdateOptions)	use ReplaceOneModel(Bson, Object, ReplaceOptions) instead
com.mongodb.connection.AsynchronousSocketChannelStreamFactoryFactory()	Use AsynchronousSocketChannelStreamFactoryFactory.builder() instead to construct the AsynchronousSocketChannelStreamFactoryFactory.
com.mongodb.connection.ConnectionDescription(ConnectionId, ServerVersion, ServerType, int, int, int)	Prefer ConnectionDescription(ConnectionId, ServerVersion, int, ServerType, int, int, int, List)
com.mongodb.connection.netty.NettyStreamFactoryFactory()	Use NettyStreamFactoryFactory.builder() instead to construct the NettyStreamFactoryFactory.
com.mongodb.connection.TlsChannelStreamFactoryFactory(AsynchronousTlsChannelGroup)	Prefer TlsChannelStreamFactoryFactory()
com.mongodb.DB(Mongo, String)	Prefer Mongo.getDB(String)
com.mongodb.event.ConnectionRemovedEvent(ConnectionId)	Prefer ConnectionRemovedEvent(ConnectionId, Reason)
com.mongodb.Mongo()	Replaced by MongoClient())
com.mongodb.MongoClient(ServerAddress, List<MongoCredential>)	Prefer MongoClient(ServerAddress, MongoCredential, MongoClientOptions)
com.mongodb.MongoNodeIsRecoveringException(ServerAddress)	Prefer MongoNodeIsRecoveringException(BsonDocument, ServerAddress)
com.mongodb.MongoNotPrimaryException(ServerAddress)	Prefer MongoNotPrimaryException(BsonDocument, ServerAddress)
com.mongodb.MongoOptions()	use MongoClientOptions
com.mongodb.MongoURI(String)	Replaced by MongoClientURI(String)
com.mongodb.operation.AggregateToCollectionOperation(MongoNamespace, List<BsonDocument>)	Prefer AggregateToCollectionOperation(MongoNamespace, List, WriteConcern)
com.mongodb.operation.BaseWriteOperation(MongoNamespace, boolean, WriteConcern)	use BaseWriteOperation(MongoNamespace, boolean, WriteConcern, boolean) instead
com.mongodb.operation.CreateIndexesOperation(MongoNamespace, List<IndexRequest>)	Prefer CreateIndexesOperation(MongoNamespace, List, WriteConcern)
com.mongodb.operation.DeleteOperation(MongoNamespace, boolean, WriteConcern, List<DeleteRequest>)	use DeleteOperation(MongoNamespace, boolean, WriteConcern, boolean, List) instead
com.mongodb.operation.DropCollectionOperation(MongoNamespace)	Prefer DropCollectionOperation(MongoNamespace, WriteConcern)
com.mongodb.operation.DropDatabaseOperation(String)
com.mongodb.operation.DropIndexOperation(MongoNamespace, String)	Prefer DropIndexOperation(MongoNamespace, String, WriteConcern)
com.mongodb.operation.FindAndDeleteOperation(MongoNamespace, Decoder<T>)	use FindAndDeleteOperation(MongoNamespace, WriteConcern, boolean, Decoder) instead
com.mongodb.operation.FindAndReplaceOperation(MongoNamespace, Decoder<T>, BsonDocument)	use FindAndReplaceOperation(MongoNamespace, WriteConcern, boolean, Decoder, BsonDocument) instead
com.mongodb.operation.FindAndUpdateOperation(MongoNamespace, Decoder<T>, BsonDocument)	use FindAndUpdateOperation(MongoNamespace, WriteConcern, boolean, Decoder, BsonDocument) instead
com.mongodb.operation.InsertOperation(MongoNamespace, boolean, WriteConcern, List<InsertRequest>)	use InsertOperation(MongoNamespace, boolean, WriteConcern, boolean, List) instead
com.mongodb.operation.MixedBulkWriteOperation(MongoNamespace, List<? extends WriteRequest>, boolean, WriteConcern)	use MixedBulkWriteOperation(MongoNamespace, List, boolean, WriteConcern, boolean) instead
com.mongodb.operation.RenameCollectionOperation(MongoNamespace, MongoNamespace)	Prefer RenameCollectionOperation(MongoNamespace, MongoNamespace, WriteConcern)
com.mongodb.operation.UpdateOperation(MongoNamespace, boolean, WriteConcern, List<UpdateRequest>)	use UpdateOperation(MongoNamespace, boolean, WriteConcern, boolean, List) instead
com.mongodb.WriteConcern()	Prefer WriteConcern.UNACKNOWLEDGED
org.bson.json.JsonWriter.Context(JsonWriter.Context, BsonContextType, String)
org.bson.json.JsonWriterSettings()	Prefer JsonWriterSettings.builder(), but note that the default output mode is different for that method
org.bson.types.ObjectId(Date, int, short, int)	Use ObjectId(Date, int) instead

Enum Constants

Enum Constant	Description
com.mongodb.AuthenticationMechanism.MONGODB_CR	This mechanism was replaced by AuthenticationMechanism.SCRAM_SHA_1 in MongoDB 3.0, and is now deprecated
org.bson.json.JsonMode.STRICT	The format generated with this mode is no longer considered standard for MongoDB tools. This value is not currently scheduled for removal.