MongoDB Module

The MongoDB module provides two Testcontainers for MongoDB unit testing:

• MongoDBContainer - the core MongoDB database
• MongoDBAtlasLocalContainer - the core MongoDB database combined with MongoDB Atlas Search + Atlas Vector Search

MongoDBContainer

Usage example

The following example shows how to create a MongoDBContainer:

Creating a MongoDB container inside_block:creatingMongoDBContainer

And how to start it:

Starting a MongoDB container inside_block:startingMongoDBContainer

Note To construct a multi-node MongoDB cluster, consider the mongodb-replica-set project

Motivation

Implement a reusable, cross-platform, simple to install solution that doesn't depend on fixed ports to test MongoDB transactions.

General info

MongoDB starting from version 4 supports multi-document transactions only for a replica set. For instance, to initialize a single node replica set on fixed ports via Docker, one has to do the following:

• Run a MongoDB container of version 4 and up specifying --replSet command
• Initialize a single replica set via executing a proper command
• Wait for the initialization to complete
• Provide a special url for a user to employ with a MongoDB driver without specifying replicaSet

As we can see, there is a lot of operations to execute and we even haven't touched a non-fixed port approach. That's where the MongoDBContainer might come in handy.

MongoDBAtlasLocalContainer

Usage example

The following example shows how to create a MongoDBAtlasLocalContainer:

Creating a MongoDB Atlas Local Container inside_block:creatingAtlasLocalContainer

And how to start it:

Start the Container inside_block:startingAtlasLocalContainer

The connection string provided by the MongoDBAtlasLocalContainer's getConnectionString() method includes the dynamically allocated port:

Get the Connection String inside_block:getConnectionStringAtlasLocalContainer

e.g. mongodb://localhost:12345/?directConnection=true

References

MongoDB Atlas Local combines the MongoDB database engine with MongoT, a sidecar process for advanced searching capabilities built by MongoDB and powered by Apache Lucene.

The container (mongodb/mongodb-atlas-local) documentation can be found here.

General information about Atlas Search can be found here.

Adding this module to your project dependencies

Add the following dependency to your pom.xml/build.gradle file:

Gradle

testImplementation "org.testcontainers:testcontainers-mongodb:{{latest_version}}"

Maven

<dependency>
    &lt;groupId&gt;org.testcontainers</groupId>
    &lt;artifactId&gt;testcontainers-mongodb</artifactId>
    &lt;version&gt;{{latest_version}}</version>
    &lt;scope&gt;test</scope>
</dependency>

Hint Adding this Testcontainers library JAR will not automatically add a database driver JAR to your project. You should ensure that your project also has a suitable database driver as a dependency

Copyright

Copyright (c) 2019 Konstantin Silaev silaev256@gmail.com