🇧🇷 In Portuguese

🐬 MySQL/MariaDB (outdated) implementation

A complete user registry, with access permissions, JWT token, integration and unit tests, using the RESTful API pattern.

Live demo on heroku

• Features
• Requirements
• Entities
• Installation
• Running a specific test
• Swagger
• Database Migrations
• Docker
• Environment variables

• Postgres: ^13
• Java: ^17
• Maven: ^3.8.4

This project was started with Spring Initializr.

🚨 draw.io file here

# clone the repository and access the directory.
$ git clone [email protected]:Throyer/springboot-api-crud.git && cd springboot-api-crud

# download dependencies
$ mvn install -DskipTests

# run the application
$ mvn spring-boot:run

# run the tests
$ mvn test

# to build for production
$ mvn clean package

# to generate the coverage report after testing (available at: target/site/jacoco/index.html)
$ mvn jacoco:report

use the parameter -Dtest=<class>#<method>

for example the integration test. creating a user:

$ mvn test -Dtest=UsersControllerIntegrationTests#should_save_a_new_user

Once the application is up, it is available at: localhost:8080/documentation

example on heroku

Creating database migration files

🚨 make sure you have maven in your environment and that you are in the correct directory ./api

if you using docker-compose

.docker/scripts/mvn migration:generate -Dname=my-migration-name

• Java based migrations

  mvn migration:generate -Dname=my-migration-name

• SQL based migrations

  mvn migration:generate -Dname=my-migration-name -Dsql

🚨 create environment file and add permission to execute scripts

cp .docker/.env.example .docker/.env && chmod -R +x .docker/scripts

• docker-compose for development

  • starting containers

  .docker/scripts/develop up -d
  

  • removing contaiers

  .docker/scripts/develop down
  

  • show backend logs

  .docker/scripts/develop logs -f api
  

• docker-compose for production

  .docker/scripts/production up -d --build
  

  .docker/scripts/production down
  

these variables are defined in: application.properties

# to change the value of some environment variable at runtime
# on execution, just pass it as a parameter. (like --SERVER_PORT=80).
$ java -jar api-4.1.2.jar --SERVER_PORT=80

All options of aplication.properties here.

All features of Spring Boot.