/get-started-java

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

Primary LanguageJavaApache License 2.0Apache-2.0

Get-Started Java

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

Information

This Get-Started project uses MongoDB Java driver version 4.1.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.

Pre-requisites

Docker

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

MongoDB Atlas

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.

Build Steps

  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.11.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.

Execution Steps

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

Change driver version from within the Docker environment

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"

Tutorials

About

This project is part of the MongoDB Get-Started code examples. Please see get-started-readme for more information.