Deprecated API

Contents

• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Classes

Class and Description
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.MongoOptions Please use MongoClientOptions instead.
com.mongodb.MongoURI Replaced by MongoClientURI
com.mongodb.client.model.ParallelCollectionScanOptions this is an unused class and there should be no reason to use it
com.mongodb.selector.PrimaryServerSelector Use either ReadPreferenceServerSelector or WritableServerSelector, depending on your requirements

Deprecated Fields

Field and 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).

Deprecated Methods

Method and Description
com.mongodb.DB.addUser(String, char[]) Use DB.command to call either the createUser or updateUser command
com.mongodb.DB.addUser(String, char[], boolean) Use DB.command to call either the createUser or updateUser command
com.mongodb.DBCollection.aggregate(DBObject, DBObject...) Use DBCollection.aggregate(java.util.List) instead
com.mongodb.Mongo.Holder.connect(MongoURI) Please use Mongo.Holder.connect(MongoClientURI) instead.
com.mongodb.ReflectionDBObject.containsKey(String)
com.mongodb.ReflectionDBObject.JavaWrapper.containsKey(String)
com.mongodb.gridfs.GridFSFile.containsKey(String)
org.bson.BasicBSONObject.containsKey(String)
org.bson.BSONObject.containsKey(String) Please use BSONObject.containsField(String) instead
org.bson.LazyBSONObject.containsKey(String)
org.bson.types.BasicBSONList.containsKey(String)
com.mongodb.client.gridfs.GridFSBucket.downloadToStream(BsonValue, OutputStream) using custom id values for with GridFS is no longer supported
com.mongodb.DBCollection.find(DBObject, DBObject, int, int) use DBCursor.skip(int) and DBCursor.batchSize(int) on the DBCursor returned from DBCollection.find(DBObject, DBObject)
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.client.gridfs.model.GridFSFile.getAliases() aliases should be stored in the metadata document.
com.mongodb.client.gridfs.model.GridFSFile.getContentType() content type information stored in the metadata document.
com.mongodb.Mongo.getDatabaseNames() Replaced with MongoClient.listDatabaseNames()
com.mongodb.Mongo.getDB(String) use MongoClient.getDatabase(String)
com.mongodb.client.gridfs.model.GridFSFile.getExtraElements() any extra information should be stored in the metadata document.
com.mongodb.Mongo.getMongoOptions() Please use MongoClient class to connect to server and corresponding MongoClient.getMongoClientOptions()
org.bson.types.ObjectId.getTime() Use #getDate instead
org.bson.types.ObjectId.getTimeSecond() Use #getTimestamp instead
com.mongodb.ConnectionString.getURI()
org.bson.BasicBSONCallback.gotBinaryArray(String, byte[])
org.bson.BSONCallback.gotBinaryArray(String, byte[])
org.bson.EmptyBSONCallback.gotBinaryArray(String, byte[])
com.mongodb.connection.Connection.killCursor(List<Long>) Replaced by Connection.killCursor(MongoNamespace, List)
com.mongodb.connection.AsyncConnection.killCursorAsync(List<Long>, SingleResultCallback<Void>) Replaced by AsyncConnection.killCursorAsync(MongoNamespace, List, SingleResultCallback)
com.mongodb.client.gridfs.GridFSBucket.openDownloadStream(BsonValue) using custom id values for with GridFS is no longer supported
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.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.DB.removeUser(String) Use DB.command to call the dropUser command
com.mongodb.DB.slaveOk() Replaced with ReadPreference.secondaryPreferred()
com.mongodb.DBCollection.slaveOk() Replaced with ReadPreference.secondaryPreferred()
com.mongodb.DBCursor.slaveOk() Replaced with ReadPreference.secondaryPreferred()
com.mongodb.Mongo.slaveOk() Replaced with ReadPreference.secondaryPreferred()
org.bson.types.ObjectId.toStringMongod() use ObjectId.toHexString()

Deprecated Constructors

Constructor and Description
com.mongodb.Mongo() Replaced by MongoClient.MongoClient())
com.mongodb.Mongo(List<ServerAddress>) Replaced by MongoClient.MongoClient(java.util.List)
com.mongodb.Mongo(List<ServerAddress>, MongoOptions) Replaced by MongoClient.MongoClient(java.util.List, MongoClientOptions)
com.mongodb.Mongo(MongoURI) Replaced by MongoClient.MongoClient(MongoClientURI)
com.mongodb.Mongo(ServerAddress) Replaced by MongoClient.MongoClient(ServerAddress)
com.mongodb.Mongo(ServerAddress, MongoOptions) Replaced by MongoClient.MongoClient(ServerAddress, MongoClientOptions)
com.mongodb.Mongo(ServerAddress, ServerAddress) Please use MongoClient.MongoClient(java.util.List) instead.
com.mongodb.Mongo(ServerAddress, ServerAddress, MongoOptions) Please use MongoClient.MongoClient(java.util.List, MongoClientOptions) instead.
com.mongodb.Mongo(String) Replaced by MongoClient.MongoClient(String)
com.mongodb.Mongo(String, int) Replaced by MongoClient.MongoClient(String, int)
com.mongodb.Mongo(String, MongoOptions) Replaced by MongoClient.MongoClient(String, MongoClientOptions)
com.mongodb.MongoOptions() use MongoClientOptions
com.mongodb.MongoOptions(MongoClientOptions) use MongoClientOptions
com.mongodb.MongoURI(MongoClientURI)
com.mongodb.MongoURI(String) Replaced by MongoClientURI.MongoClientURI(String)