How wakelawn/currency-converter works
This Spring Boot API authenticates requests with an API key, validates conversion input, fetches live rates, returns conversions, and stores conversion history in H2. A separate rate-lookup endpoint and history retrieval/deletion are also documented capabilities. The graph follows shown controller/service calls and service/repository interactions; API authentication and external-rate relationships are supported by excerpts, while some configuration-wired relationships are omitted where their wiring was not shown.
Main entry points: CurrencyService.java Currency Service · CurrencyController.java Currency Endpoints · ConversionHistoryRepository.java History Repository · HistoryService.java History Service
Components 23
REST API
- Currency Endpoints
src/main/java/com/javaproj/currencyConverter/controller/CurrencyController.java - History Endpoints
src/main/java/com/javaproj/currencyConverter/controller/HistoryController.java - Validated Request
src/main/java/com/javaproj/currencyConverter/dto/ConversionRequest.java - Conversion Result
src/main/java/com/javaproj/currencyConverter/dto/ConversionResponse.java - Rate Data
src/main/java/com/javaproj/currencyConverter/dto/ExchangeRateResponse.java
Currency Conversion
- Currency Service
src/main/java/com/javaproj/currencyConverter/service/CurrencyService.java - ExchangeRate-API
History
- Conversion Record
src/main/java/com/javaproj/currencyConverter/model/ConversionHistory.java - History Service
src/main/java/com/javaproj/currencyConverter/service/HistoryService.java - History Repository
src/main/java/com/javaproj/currencyConverter/repository/ConversionHistoryRepository.java - H2 Database
API-Key Security
- API-Key Filter
src/main/java/com/javaproj/currencyConverter/config/ApiKeyAuthenticationFilter.java - User Service
src/main/java/com/javaproj/currencyConverter/service/UserService.java - User Repository
src/main/java/com/javaproj/currencyConverter/repository/UserRepository.java - User Account
src/main/java/com/javaproj/currencyConverter/model/User.java - Security Configuration
src/main/java/com/javaproj/currencyConverter/config/SecurityConfig.java - User Initialization
src/main/java/com/javaproj/currencyConverter/config/DataInitializer.java
Configuration and Errors
- Global Error Handler
src/main/java/com/javaproj/currencyConverter/exception/GlobalExceptionHandler.java - Unsupported Currency
src/main/java/com/javaproj/currencyConverter/exception/CurrencyNotFoundException.java - Missing History
src/main/java/com/javaproj/currencyConverter/exception/HistoryNotFoundException.java - WebClient Configuration
src/main/java/com/javaproj/currencyConverter/config/WebClientConfig.java - OpenAPI Configuration
src/main/java/com/javaproj/currencyConverter/config/OpenApiConfig.java
Other components
- API Client
Connections 24
- API Client → Currency Endpoints: calls
src/main/java/com/javaproj/currencyConverter/controller/CurrencyController.java - API Client → History Endpoints: calls
README.md - Currency Endpoints → Currency Service: delegates
src/main/java/com/javaproj/currencyConverter/controller/CurrencyController.java - Currency Endpoints → Validated Request: accepts
src/main/java/com/javaproj/currencyConverter/controller/CurrencyController.java - Currency Endpoints → Conversion Result: returns
src/main/java/com/javaproj/currencyConverter/controller/CurrencyController.java - Currency Endpoints → Rate Data: returns
src/main/java/com/javaproj/currencyConverter/controller/CurrencyController.java - Currency Service → ExchangeRate-API: requests rates
src/main/java/com/javaproj/currencyConverter/service/CurrencyService.java - Currency Service → History Repository: saves conversion
src/main/java/com/javaproj/currencyConverter/service/CurrencyService.java - Currency Service → Conversion Record: creates record
src/main/java/com/javaproj/currencyConverter/service/CurrencyService.java - History Endpoints → History Service: delegates
src/main/java/com/javaproj/currencyConverter/controller/HistoryController.java - History Service → History Repository: queries and deletes
src/main/java/com/javaproj/currencyConverter/service/HistoryService.java - History Repository → Conversion Record: manages
src/main/java/com/javaproj/currencyConverter/repository/ConversionHistoryRepository.java - History Repository → H2 Database: persists records
README.md - API-Key Filter → User Service: looks up key
src/main/java/com/javaproj/currencyConverter/config/ApiKeyAuthenticationFilter.java - User Service → User Repository: queries
src/main/java/com/javaproj/currencyConverter/service/UserService.java - User Repository → User Account: manages
src/main/java/com/javaproj/currencyConverter/repository/UserRepository.java - Security Configuration → API-Key Filter: registers filter
src/main/java/com/javaproj/currencyConverter/config/SecurityConfig.java - User Initialization → User Repository: initializes users
src/main/java/com/javaproj/currencyConverter/config/DataInitializer.java - Global Error Handler → Unsupported Currency: handles
src/main/java/com/javaproj/currencyConverter/exception/GlobalExceptionHandler.java - Global Error Handler → Missing History: handles
src/main/java/com/javaproj/currencyConverter/exception/GlobalExceptionHandler.java - Currency Service → Unsupported Currency: throws
src/main/java/com/javaproj/currencyConverter/service/CurrencyService.java - History Service → Missing History: throws
src/main/java/com/javaproj/currencyConverter/service/HistoryService.java - Currency Service → WebClient Configuration: uses client
- API Client → OpenAPI Configuration: explores API
README.md