liberty-mongodb

MicroProfile Open Liberty with MongoDB sample

This project is intent to be a sample for MicroProfile with MongoDB integration by using Jakarta NoSQL implementation.

Setup MongoDB

MongoDB is a free and open-source cross-platform document-oriented database program. Classified as a NoSQL database program, MongoDB uses JSON-like documents with schemas.

To run this project a MongoDB instance is required, so you can use either a local installation or using Docker.

The project is configured to reach out a MongoDB instance with the following configuration:

host:       localhost
port:       27017
username:   root
password:   example
Auth db:    admin

PS:warning: Pay attention to that when you try to set up your own MongoDB instance.

Using Docker Compose

The easier way to execute this project is to use the provided docker-compose.yaml file in the root directory. You can run it by performing the following command:

docker-compose up -d

Local installation

Follow the instructions in: https://docs.mongodb.com/manual/installation/

Using Docker

1. Install docker: https://www.docker.com/

2. https://store.docker.com/images/mongo

3. Run docker command

4. Run MongoDB: verify MongoDB image name with the command docker images, it can be mongodb or mongo, and then execute this command

docker run -d --name mongodb-instance -e 'MONGO_INITDB_ROOT_USERNAME=root' -e 'MONGO_INITDB_ROOT_PASSWORD=example' -p 27017:27017 mongo

Run the code

The generation of the executable jar file can be performed by issuing the following command

mvn clean package

This will create an executable jar file liberty-mongodb.jar within the target maven folder. This can be started by executing the following command

java -jar target/liberty-mongodb.jar

Liberty Dev Mode

During development, you can use Liberty’s development mode (dev mode) to code while observing and testing your changes on the fly. With the dev mode, you can code along and watch the change reflected in the running server right away; unit and integration tests are run on pressing Enter in the command terminal; you can attach a debugger to the running server at any time to step through your code.

mvn liberty:dev

To launch the test page, open your browser at the following URL

http://localhost:9080/index.html

Specification examples

By default, there is always the creation of a JAX-RS application class to define the path on which the JAX-RS endpoints are available.

Also, a simple Hello world endpoint is created, have a look at the class HelloController.

More information on MicroProfile can be found [here](https://microprofile.io/)

Config

Configuration of your application parameters. Specification [here](https://microprofile.io/project/eclipse/microprofile-config)

The example class ConfigTestController shows you how to inject a configuration parameter and how you can retrieve it programmatically.