MongoDB BasicDBObject vs Document in java

Basic DBobject is not deprecated . The only deprecated part in the BasicDBobject is DBPointer class and few other methods like toString() and getId()

Document implements Map<String, Object> and there is less code to write compared to Basic DB object

DBObjectAlthough not recommended for new applications, those upgrading from the 2.x driver series may continue to use the DBObject interface to represent BSON documents. DBObject is similar to Document in that it represents BSON values as Object, but it has a few shortcomings that were impossible to overcome:

1. it is an interface rather than a class, so it’s API can not be extended without breaking binary compatibility.

2. It doesn’t actually implement Map.

3. Because it is an interface, a separate concrete class called BasicDBObject which implements that interface, is required

BsonTo tie these all together, the driver contains a small but powerful interface called Bson. Any class that represents a BSON document, whether included in the driver itself or from a third party, can implement this interface and can then be used any place in the high-level API where a BSON document is required.

MongoDB Java drivers in the 3.0 - 3.12.2 version range have an 'Uber' driver which contains both legacy client implementations as well as the newer client. When considering org.bson.Document compared to com.mongodb.BasicDBObject the class org.bson.Document is used with the newer client stack, whereas com.mongodb.DBobject or com.mongodb.BasicDBObject are used in the legacy client stack. It can be really confusing having both legacy and newer stuff in the same driver. If you are only interested in the newer client see the driver called 'mongodb-driver-sync' MVN repo at https://mvnrepository.com/artifact/org.mongodb/mongodb-driver-sync. If you only want legacy, see https://mvnrepository.com/artifact/org.mongodb/mongodb-driver-legacy. Some artifacts are universal, like com.mongodb.WriteConcern. As such they will exist in both legacy and sync. My understanding is that this 'Uber' driver will not exist in the version 4.0 or later. The legacy driver is lacking session support, transaction support, and change streams. Choose wisely.