Repository to help getting started with MongoDB Java driver connecting to MongoDB Atlas.

This Quickstart project uses MongoDB Java driver version 3.11.1 by default. Although you can change the driver version, the provided code example was only tested against the default version of MongoDB driver. There is no guarantee that the code sample will work for all possible versions of the driver.

Have Docker running on your machine. You can download and install from: https://docs.docker.com/install/

In order to execute the code example, you need to specify MONGODB_URI environment variable to connect to a MongoDB cluster. If you don't have any you can create one by signing up MongoDB Atlas Free-tier M0.

1. Build Docker image with a tag name. Within this directory execute:

   • To use the default driver version and specify MONGODB_URI:

     docker build . -t start-java --build-arg MONGODB_URI="mongodb+srv://usr:pwd@example.mongodb.net/dbname?retryWrites=true" 

   • To use a different driver version and specify MONGODB_URI. For example:

     docker build . -t start-java --build-arg DRIVER_VERSION=3.10.2 --build-arg MONGODB_URI="mongodb+srv://usr:pwd@example.mongodb.net/dbname?retryWrites=true" 

   This will build a docker image with a tag name start-java. As a result of the build, the example code is compiled for the specified driver version and ready to be executed.

2. Run the Docker image by executing:

   docker run --tty --interactive --hostname java start-java 

   The command above will run a start-java tagged Docker image. Sets the hostname as java.

1. Run the compiled C# code example by following below steps:
   • cd ~/java
   • mvn package
   • java -cp ./target/start-1.0-SNAPSHOT.jar com.start.Quickstart

You can change the version of mongo-driver-sync before code compilation time by modifying the pom.xml: mongo-java-driver version.

From within the docker environment, you can also change the MONGODB_URI by changing the environment variable:

export MONGODB_URI="mongodb+srv://usr:pwd@new.mongodb.net/dbname?retryWrites=true"

• MongoDB Java driver QuickStart