{"id":23514754,"url":"https://github.com/niweera/forex-converter","last_synced_at":"2025-07-07T18:32:47.541Z","repository":{"id":99711382,"uuid":"267628165","full_name":"Niweera/forex-converter","owner":"Niweera","description":"Example Repository for Forex Converter application based on Java Spring Boot Microservices","archived":false,"fork":false,"pushed_at":"2020-10-01T01:47:21.000Z","size":64,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-13T21:19:23.259Z","etag":null,"topics":["java","java-spring-boot","microservices"],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Niweera.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-05-28T15:35:36.000Z","updated_at":"2022-12-28T12:10:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"8f216db6-9553-4034-a543-db6ec8702a25","html_url":"https://github.com/Niweera/forex-converter","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Niweera/forex-converter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Niweera%2Fforex-converter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Niweera%2Fforex-converter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Niweera%2Fforex-converter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Niweera%2Fforex-converter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Niweera","download_url":"https://codeload.github.com/Niweera/forex-converter/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Niweera%2Fforex-converter/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264130498,"owners_count":23562038,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","java-spring-boot","microservices"],"created_at":"2024-12-25T14:10:22.640Z","updated_at":"2025-07-07T18:32:47.494Z","avatar_url":"https://github.com/Niweera.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Forex-Converter\n\nForex-Converter is a microservices based application build using Java Spring Boot.\n\n## How to run?\n\n1. git clone the repository.\n2. Each directory is a seperate (micro) service.\n3. Build each project using Maven (Use JDK14 or change the pom.xml according to the available JDK version).\n4. Start Eureka server.\n5. Start other services.\n6. Go to http://localhost:8761 to see the Eureka server dashboard.\n\n### Endpoints\n\n```json\n{\n  \"id\": 10001,\n  \"from\": \"USD\",\n  \"to\": \"LKR\",\n  \"conversionMultiple\": 186.18,\n  \"quantity\": 1000.0,\n  \"totalAmount\": 186180.0,\n  \"port\": 8100\n}\n```\n\n### Paths\n\n| Location  | Endpoint                 |\n| :-------- | :----------------------- |\n| Root path | `http://localhost:8080/` |\n\n### HTTP request and query methods\n\n| Method | Endpoint                                                     | Query | Description                                     | Examples                                                                                                                                           |\n| :----- | :----------------------------------------------------------- | :---- | :---------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `GET`  | `currency-converter/from/{FROM}/to/{TO}/quantity/{QUANTITY}` |       | Convert a quantity from one currency to another | [`http://localhost:8080/currency-converter/from/USD/to/LKR/quantity/3000`](http://localhost:8080/currency-converter/from/USD/to/LKR/quantity/3000) |\n\n## References\n\n1. [Microservices with Spring Boot and Java by In28Minutes](https://www.springboottutorial.com/creating-microservices-with-spring-boot-part-1-getting-started)\n2. https://docs.spring.io/spring-boot/docs/current/reference/html/appendix-application-properties.html#server-properties\n3. https://blog.marcnuri.com/field-injection-is-not-recommended/\n4. https://www.w3schools.com/java/java_hashmap.asp\n5. [Spring Boot Quick Start by Java Brains](https://www.youtube.com/playlist?list=PLqq-6Pq4lTTbx8p2oCgcAQGQyqN8XeA1x)\n6. https://start.spring.io/\n7. https://medium.com/better-programming/building-a-spring-boot-rest-api-a-php-developers-view-part-i-6add2e794646\n8. https://www.tutorialspoint.com/maven/index.htm\n9. http://tutorials.jenkov.com/maven/maven-tutorial.html\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fniweera%2Fforex-converter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fniweera%2Fforex-converter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fniweera%2Fforex-converter/lists"}