Deprecated API

Contents

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

Deprecated Classes

Class and Description
org.apache.commons.codec.language.Caverphone 1.5 Replaced by Caverphone2, will be removed in 2.0.
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

Deprecated Fields

Field and Description
org.apache.commons.codec.net.URLCodec.charset TODO: This field will be changed to a private final Charset in 2.0.
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.Mongo.addOption(int) Add options instead on instances of DBCursor
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.LazyBSONObject.containsKey(String)
org.bson.BasicBSONObject.containsKey(String)
org.bson.BSONObject.containsKey(String) Please use BSONObject.containsField(String) instead
org.bson.types.BasicBSONList.containsKey(String)
com.mongodb.client.gridfs.GridFSBucket.downloadToStreamByName(String, OutputStream) use GridFSBucket.downloadToStream(String, OutputStream) instead.
com.mongodb.client.gridfs.GridFSBucket.downloadToStreamByName(String, OutputStream, GridFSDownloadByNameOptions) use GridFSBucket.downloadToStream(String, OutputStream, GridFSDownloadOptions) instead.
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.Mongo.getDatabaseNames() Replaced with MongoClient.listDatabaseNames()
com.mongodb.Mongo.getDB(String) use MongoClient.getDatabase(String)
org.apache.commons.codec.net.URLCodec.getEncoding() Use URLCodec.getDefaultCharset(), will be removed in 2.0.
com.mongodb.client.gridfs.GridFSUploadStream.getFileId() use GridFSUploadStream.getObjectId() instead.
org.apache.commons.codec.language.Soundex.getMaxLength() This feature is not needed since the encoding size must be constant. Will be removed in 2.0.
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
org.apache.commons.codec.digest.DigestUtils.getShaDigest() Use DigestUtils.getSha1Digest()
org.bson.EmptyBSONCallback.gotBinaryArray(String, byte[])
org.bson.BasicBSONCallback.gotBinaryArray(String, byte[])
org.bson.BSONCallback.gotBinaryArray(String, byte[])
org.apache.commons.codec.binary.Base64.isArrayByteBase64(byte[]) 1.5 Use Base64.isBase64(byte[]), will be removed in 2.0.
org.apache.commons.codec.language.bm.Rule.Phoneme.join(Rule.Phoneme) since 1.9
com.mongodb.client.gridfs.GridFSBucket.openDownloadStreamByName(String) use GridFSBucket.openDownloadStream(String) instead.
com.mongodb.client.gridfs.GridFSBucket.openDownloadStreamByName(String, GridFSDownloadByNameOptions) use GridFSBucket.openDownloadStream(String, GridFSDownloadOptions) instead.
com.mongodb.DB.removeUser(String) Use DB.command to call the dropUser command
com.mongodb.Mongo.resetOptions() Reset options instead on instances of DBCursor
org.apache.commons.codec.language.Soundex.setMaxLength(int) This feature is not needed since the encoding size must be constant. Will be removed in 2.0.
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
org.apache.commons.codec.digest.DigestUtils.sha(byte[]) Use DigestUtils.sha1(byte[])
org.apache.commons.codec.digest.DigestUtils.sha(InputStream) Use DigestUtils.sha1(InputStream)
org.apache.commons.codec.digest.DigestUtils.sha(String) Use DigestUtils.sha1(String)
org.apache.commons.codec.digest.DigestUtils.shaHex(byte[]) Use DigestUtils.sha1Hex(byte[])
org.apache.commons.codec.digest.DigestUtils.shaHex(InputStream) Use DigestUtils.sha1Hex(InputStream)
org.apache.commons.codec.digest.DigestUtils.shaHex(String) Use DigestUtils.sha1Hex(String)
com.mongodb.Mongo.slaveOk() Replaced with ReadPreference.secondaryPreferred()
com.mongodb.DBCursor.slaveOk() Replaced with ReadPreference.secondaryPreferred()
com.mongodb.DBCollection.slaveOk() Replaced with ReadPreference.secondaryPreferred()
com.mongodb.DB.slaveOk() Replaced with ReadPreference.secondaryPreferred()

Deprecated Constructors

Constructor and Description
com.mongodb.Mongo() Replaced by MongoClient.MongoClient())
com.mongodb.Mongo(List) Replaced by MongoClient.MongoClient(java.util.List)
com.mongodb.Mongo(List, 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)
org.apache.commons.codec.StringEncoderComparator() Creating an instance without a StringEncoder leads to a NullPointerException. Will be removed in 2.0.