Conversion from mongodb-driver-legacy to mongodb-driver-sync

Steve_Faingold · 2021-09-24T16:16:45.917Z

Is there any documentation that discusses converting an existing application from the mongodb-driver-legacy to the mongodb-driver-sync driver? The 4.3 driver page mentions

“The MongoDB Legacy driver mongodb-driver-legacy is the legacy synchronous Java driver whose entry point is com.mongodb.MongoClient and central classes include com.mongodb.DB , com.mongodb.DBCollection , and com.mongodb.DBCursor .”

Would like to know how these classes can be replaced/removed from the application to be able to use the sync driver.

Jeffrey_Yemin · 2021-09-24T16:32:34.736Z

We don’t actually have much, if any, documentation on that. It’s a good idea to create some though. Until then, here’s a quick cheat sheet:

MongoClientOptions → MongoClientSettings
new MongoClient() → MongoClients.create()
MongoClient.getDB() → MongoClient.getDatabase()
DB → MongoDatabase
DBCollection → MongoCollection<>
DBCursor → MongoCursor
DBCollection.findOne() → MongoCollection.find().first()
DBCollection.insert() → MongoCollection.insertOne() or MongoCollection.insertMany()
DBCollection.update() → MongoCollection.updateOne() or MongoCollection.updateMany()
DBCollection.remove() → MongoCollection.deleteOne() or MongoCollection.deleteMany()
DBCollection.count() → MongoCollection.countDocuments() or MongoCollection.estimatedDocumentCount()
DBCollection.findAndModify() → MongoCollection.findOneAndUpdate() or MongoCollection.findOneAndReplace() or MongoCollection.findOneAndDelete()

Couple of other points as well:

In general the new API prefers either Options classes or method chaining to the copious use of method overloading in the legacy API.
The default generic type for MongoCollection is org.bson.Document, but you can use BasicDBObject as well if that makes the port to the new API easier for you.

Hope this helps, and we’ll consider creating a documentation page for this.

Regards,
Jeff

Steve_Faingold · 2021-09-27T20:49:45.457Z

Jeff,

Thanks so much for that cheat sheet. That should definitely help if we decide to do the conversion.

Steve

Steve_Faingold · 2021-10-01T19:21:16.984Z

Jeff going to post a few more questions regarding this next week. Positing now to keep thread alive.

Have a good weekend!

Steve_Faingold · 2021-10-04T16:44:23.093Z

I am trying to replace the existing application with minimal changes (but obviously some of these may call for more changes), but wanted to determine replacement classes and methods for the following:

Classes:
com.mongodb.AggregationOptions;
com.mongodb.CommandResult;
com.mongodb.MapReduceCommand;
com.mongodb.MapReduceOutput;

Previous methods:
com.mongodb.DB.collectionExists
com.mongodb.DB.createCollection(String collectionName, DBObject options)

com.mongodb.DBCollection.insert(DBObject[] documents, WriteConcern writeConcern)
com.mongodb.DBCollection.setWriteConcern
com.mongodb.DBCollection.findAndRemove
com.mongodb.DBCollection.getName
com.mongodb.DBCollection.getStats

com.mongodb.DBCursor.next

Thanks

system · 2021-10-12T13:07:35.374Z

This topic was automatically closed 5 days after the last reply. New replies are no longer allowed.

webchick · 2021-12-06T19:16:26.226Z

Peter_Newhook · 2021-12-24T15:40:28.935Z

I feel like there’s a lot more documentation needed to migrate from the legacy API to the new driver. Connecting to a server is quite different, and the QueryBuilder class appears removed.

Ilja.Fitisov · 2022-02-09T14:56:19.108Z

After migration from mongo-java-driver 3.7.1 to mongodb-driver-sync 4.4.1 I can’t find class com.mongodb.QueryBuilder. Can you please tell me what should I use instead?

Jeffrey_Yemin · 2022-02-09T15:19:15.390Z

The legacy API, which includes QueryBuilder as well as DBCollection, DBCursor, etc, is included in the mongodb-driver-legacy artifact.

http://mongodb.github.io/mongo-java-driver/4.4/apidocs/mongodb-driver-legacy/index.html

Regards,
Jeff