net.ozwolf.mongo.migrations

Class MongoTrek

java.lang.Object

net.ozwolf.mongo.migrations.MongoTrek

public class MongoTrek
extends Object

Mongo Trek

The mongoTrek main class allows an application to provide it’s own MongoDatabase instance or MongoDB Connection string to then apply migrations to or report on the migration status of their database schema.

Example Usage

public class MyApplication {
     public void start(){
         try {
             MongoTrek trek = new MongoTrek("mongodb://root:password@localhost:27017/my_application");

             trek.setSchemaVersionCollection("_schema_version_my_application");
             MongoTrekState state = trek.migrate("mongodb/trek.yml");

             LOGGER.info("Completed migrations to version " + state.getCurrentVersion());
         } catch (MongoMigrationFailureException e) {
             LOGGER.error("Error migrating database, e);
         }
     }
}

Constructor Summary

Constructors

Constructor and Description
MongoTrek(com.mongodb.client.MongoDatabase database) Create a new MongoTrek instance using a provided MongoDatabase instance.
MongoTrek(String uri) Create a new MongoTrek instance that will connect to the provided connection string.

Method Summary

Modifier and Type	Method and Description
MongoTrekState	migrate(String migrationsFile) Migrate the Mongo database using the provided collection of commands.
void	setSchemaVersionCollection(String collectionName) Change the schema version collection from the default _schema_version
MongoTrekState	status(String migrationsFile) Report the status of the migrations and provided commands.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MongoTrek

public MongoTrek(String uri)

Create a new MongoTrek instance that will connect to the provided connection string.

Parameters:

uri - The Mongo instance connection string

See Also:

Connection String](https://docs.mongodb.com/manual/reference/connection-string/)

MongoTrek

public MongoTrek(com.mongodb.client.MongoDatabase database)

Create a new MongoTrek instance using a provided MongoDatabase instance. MongoTrek will not close this connection.

Parameters:

database - The MongoDatabase instance.

Method Detail

setSchemaVersionCollection

public void setSchemaVersionCollection(String collectionName)

Change the schema version collection from the default _schema_version

Parameters:

collectionName - The schema version collection name

migrate

public MongoTrekState migrate(String migrationsFile)
                       throws MongoTrekFailureException

Migrate the Mongo database using the provided collection of commands. Will not apply versions already applied successfully.

Parameters:

migrationsFile - The migrations file to apply (should be on the classpath)

Returns:

The trek state

Throws:

MongoTrekFailureException - If the migration fails for whatever reason.

status

public MongoTrekState status(String migrationsFile)
                      throws MongoTrekFailureException

Report the status of the migrations and provided commands. Does not apply the migrations.

Parameters:

migrationsFile - The migrations file to apply (should be on the classpath)

Returns:

The trek state

Throws:

MongoTrekFailureException - If the status report fails for whatever reason.