https://github.com/leiberbertel/java-pizzeria-api

An API created with Java and Spring Boot, Spring Data JPA and Lombok to manage a pizzeria, with connection to MySQL databases. Includes unit tests with Junit5
https://github.com/leiberbertel/java-pizzeria-api

api-rest gradle java junit5 lombok spring-boot

Last synced: 10 months ago
JSON representation

An API created with Java and Spring Boot, Spring Data JPA and Lombok to manage a pizzeria, with connection to MySQL databases. Includes unit tests with Junit5

• Host: GitHub
• URL: https://github.com/leiberbertel/java-pizzeria-api
• Owner: leiberbertel
• License: mit
• Created: 2023-10-08T23:31:13.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-11-04T22:46:23.000Z (about 1 year ago)
• Last Synced: 2025-01-11T07:38:01.836Z (12 months ago)
• Topics: api-rest, gradle, java, junit5, lombok, spring-boot
• Language: Java
• Homepage:
• Size: 166 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# pizzeria API

### _This is an API for the basic operation of a pizzeria_:

![Static Badge](https://img.shields.io/badge/version-1.0-brightgreen)

![Static Badge](https://img.shields.io/badge/Java-17-brightgreen)

## Running the API with Docker

To run the API using Docker, follow these steps:

1. **Clone the Repository** (if you haven't already):

   ```bash

   git clone https://github.com/leiberbertel/java-pizzeria.git

   cd java-pizzeria

2. **Build the Docker Image**: 


Make sure Docker is installed on your machine. Build the Docker image with:

   ```bash

   docker build -t pizzeria-api

   ```

3. **Run the Docker Container**: 


After building the image, run the container with:

    ```bash

    docker run -p 8080:8080 pizzeria-api

    ```

4. **Access Swagger UI**: 


Once the container is running, you can view the Swagger UI documentation at http://localhost:8080/swagger-ui/index.html#/.

## Running the API Without Docker

To run the API, you will need JDK version 17 installed on your machine.

[Download it here:](https://adoptium.net/es/temurin/releases/?version=17)

1. **Clone the repository** (if you haven't already):

    ```bash

    git clone https://github.com/leiberbertel/java-pizzeria.git

    cd leiber-pizzeria

    ```

2. **Build and Run the Application:** 


    ```bash

    ./gradlew build

    ./gradlew bootRun

    ```

    **On OS windows**:

    ```bash

    gradlew.bat build

    gradlew.bat bootRun

    ```

The Spring Boot application will launch and be running on port 8080

All endpoints and schemas are documented using Swagger UI. You can view the documentation at http://localhost:8080/swagger-ui/index.html#/, which is the default endpoint for the Swagger UI.

## Built with 🛠

* Java version 17 - Language used

* Lombok - Tertiary dependency

* Mysql - Database Engine

* Spring Framework - Framework used

* Spring Data JPA - Dependency on data manipulation

* Springdoc - Dependency on API documentation