https://github.com/roshan-rafeeq/currency_convertor_springboot
A Simple but strong and efficient Currency Converter Application build using Java and Spring boot with ExchangerateApi and with stunning swagger ui .
https://github.com/roshan-rafeeq/currency_convertor_springboot
java spingboot swagger-ui
Last synced: 11 months ago
JSON representation
A Simple but strong and efficient Currency Converter Application build using Java and Spring boot with ExchangerateApi and with stunning swagger ui .
- Host: GitHub
- URL: https://github.com/roshan-rafeeq/currency_convertor_springboot
- Owner: roshan-rafeeq
- Created: 2025-02-03T10:54:33.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-04T02:57:11.000Z (over 1 year ago)
- Last Synced: 2025-04-02T11:49:02.494Z (over 1 year ago)
- Topics: java, spingboot, swagger-ui
- Language: Java
- Homepage: https://currency-convertor-roshspringapps.vercel.app
- Size: 430 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Currency Converter API
A Spring Boot REST API for currency conversion using real-time exchange rates.
## Features
- Convert currency amounts between different currencies
- Swagger UI for API documentation
- Exception handling for invalid requests
- JUnit tests for service and controller layers
## Technologies Used
- **Spring Boot**
- **Spring Web**
- **Spring Boot Test & JUnit**
- **Lombok**
- **RestClient (Spring 6)**
- **Swagger OpenAPI**
## Prerequisites
- Java 17+
- Maven
- Internet connection for fetching live exchange rates
## Installation
### Clone the repository
```sh
git clone https://github.com/your-username/currency-converter-api.git
cd currency-converter-api
```
### Build & Run the Application
mvn clean install
mvn spring-boot:run
## Run in Debug Mode
```
mvn spring-boot:run -Ddebug
```
### API Documentation
Once the application is running, access Swagger UI at:
## http://localhost:8080/swagger-ui.html
### Example API Call
## GET http://localhost:8080/api/currency/convert?from=USD&to=EUR&amount=100
### Running Tests
Run all JUnit tests with:
## mvn test
## SCREENSHOTS
### Swagger UI
### API Response Example
### API Response Example
### License
MIT License. Free to use and modify.