bglamadrid / three-it-music-poll-backend

Music taste poll monolithic backend application.

Music Poll Backend

Project generated using Spring Initializr.

This project is the backend for the application requested by 3IT as an exam/test to apply for a position as Fullstack Developer.

Overview

The main focus of this backend application is to provide persistence and server-side validation layers for the poll answers that will be received from an Angular application in the client-side.

It uses Maven v3.8 and Spring Boot v2.7 along with dependencies:

• Project Lombok
• Spring Web MVC
• Spring Data JPA
• Spring Validation
• H2 Database Driver

Features

• REST API
• Simple normalized data model with two entities:
  • Music Genre
  • Poll Answer

Requirements

• Java 19 or higher (Download from Oracle Releases)
• Maven 3.6 or higher (Download)

Getting started

There are two procedures I recommend to work with this project:

1. Compile & package into WAR file
   • Execute mvn clean install, then search for the resulting .war file in the /target directory.
   • Install the WAR file to an application server, or execute it right on by using java -jar *.war
   • Note that, unless explicitly skipped, this procedure will also run the project's unit tests before packaging it as WAR.
2. Run on-the-fly
   • Execute mvn spring-boot:run. No files will be produced.

By default the project runs in port 8080. This can be edited in application.properties before compilation, or in the command-line.