conorheffron / ironoc-db

Sample Data Manager Service with UI

Sample Data Manager

================

Docker Hub

ironoc-db docker hub

Summary

This project is a sample data manager. It provides a basic template for Java/Spring developers. This project also includes form validation of controller model objects and request parameters. Users can view, add, delete person objects from the database via web UI.

Technologies Used

Java 21 (LTS Version), Spring Boot 3, Hibernate, MySQL, JSP, Gradle 8.5

Run

MySql

docker run -p 3306:3306 -d --name test-mysql -e "MYSQL_ROOT_PASSWORD=mypassword" mysql
docker logs test-mysql
docker inspect test-mysql

Create Network

docker network create my-network
docker inspect network my-network 

Link container to same network for access:

docker network connect my-network test-mysql

Inspect network configurations & update application properties with IPv4Address instead of localhost if mac user (IPv4Address for my-sql etc.)

• Get IP address from inspect cmd and test connection from MySql workbench with new host IP. Run StarterDb.sql.

docker inspect network my-network 

Build ironoc-db, run unit & integration tests, & generate war file.

gradle clean build

Run 'com.ironoc.db.App.java' directly from IntelliJ (can use localhost for spring.datasource.url) or via CLI (build & spin up docker image, use docker network IP address for test-mysql process):

docker image build -t ironoc-db .
docker compose up -d

Tear-down:

docker stop test-mysql
docker remove test-mysql

Alternatively, Docker Desktop is good if you prefer to not use the terminal/command line (CLI)

Can tail the logs by scrolling within the container logs:

Screenshot Home

Screenshot Form Validation Error for Add Person Call

Screenshot Form Validation Error for Delete Operation