https://github.com/beemi/lat-long-spring-boot-service
Lat Long Spring boot service
https://github.com/beemi/lat-long-spring-boot-service
java
Last synced: 8 months ago
JSON representation
Lat Long Spring boot service
- Host: GitHub
- URL: https://github.com/beemi/lat-long-spring-boot-service
- Owner: beemi
- Created: 2022-04-02T20:35:43.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2024-02-26T02:46:03.000Z (over 2 years ago)
- Last Synced: 2025-08-03T23:20:24.338Z (10 months ago)
- Topics: java
- Language: Java
- Homepage:
- Size: 118 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Spring boot Lat long service
This is a simple Spring boot service that returns the latitude and longitude of a given postcode.
## 📋 Requirements
- ☕ Java 17
- 🏗️ Gradle
- 🐬 MySQL
- 🐘 Spring Boot
- 🐬Liquibase
- 🐳 Docker
- 🧩 Docker-compose
- 📬 Postman
# Project structure :file_folder:
```angular2html
.
├── build.gradle
├── gradle
│ └── wrapper
│ ├── gradle-wrapper.jar
│ └── gradle-wrapper.properties
├── gradlew
├── gradlew.bat
├── README.md
├── settings.gradle
src
├── main
│ ├── java
│ │ └── com
│ │ └── example
│ │ └── latlong
│ │ config
│ │ ├── LatLongConfig.java
│ │ ├── LatLongSwaggerConfig.java
│ │ ├── LatLongApplication.java
│ │ ├── controller
│ │ │ └── LatLongController.java
│ │ ├── model
│ │ │ ├── LatLong.java
│ │ │ └── Postcode.java
│ │ ├── service
│ │ │ ├── LatLongService.java
│ │ │ └── PostcodeService.java
│ │ └── util
│ │ └── LatLongUtil.java
│ └── resources
│ ├── application.properties
```
### 🐳 Run the Application with Docker-compose
This application uses MySQL as the backend database. To run the application along with MySQL in Docker containers, use
the following command:
### ▶️ Run the Application Locally
```shell
docker-compose up -d
```
```bash
gradle bootRun
```
Build with Gradle:
```bash
gradle clean build
```
Run test with Gradle:
```bash
gradle test
```
Run jar:
```bash
java -jar build/libs/latlong-spring-boot-service-1.0.0.jar
```
## Swagger UI :books:
http://localhost:80890/api-docs/
http://localhost:8090/swagger-ui/index.html
### Actuator info endpoint :thumbsup:
Actuator health endpoint
http://localhost:8090/actuator/health