diff --git a/.gitignore b/.gitignore new file mode 100644 index 00000000..549e00a2 --- /dev/null +++ b/.gitignore @@ -0,0 +1,33 @@ +HELP.md +target/ +!.mvn/wrapper/maven-wrapper.jar +!**/src/main/**/target/ +!**/src/test/**/target/ + +### STS ### +.apt_generated +.classpath +.factorypath +.project +.settings +.springBeans +.sts4-cache + +### IntelliJ IDEA ### +.idea +*.iws +*.iml +*.ipr + +### NetBeans ### +/nbproject/private/ +/nbbuild/ +/dist/ +/nbdist/ +/.nb-gradle/ +build/ +!**/src/main/**/build/ +!**/src/test/**/build/ + +### VS Code ### +.vscode/ diff --git a/mvnw b/mvnw new file mode 100644 index 00000000..66df2854 --- /dev/null +++ b/mvnw @@ -0,0 +1,308 @@ +#!/bin/sh +# ---------------------------------------------------------------------------- +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# https://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +# ---------------------------------------------------------------------------- + +# ---------------------------------------------------------------------------- +# Apache Maven Wrapper startup batch script, version 3.2.0 +# +# Required ENV vars: +# ------------------ +# JAVA_HOME - location of a JDK home dir +# +# Optional ENV vars +# ----------------- +# MAVEN_OPTS - parameters passed to the Java VM when running Maven +# e.g. to debug Maven itself, use +# set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000 +# MAVEN_SKIP_RC - flag to disable loading of mavenrc files +# ---------------------------------------------------------------------------- + +if [ -z "$MAVEN_SKIP_RC" ] ; then + + if [ -f /usr/local/etc/mavenrc ] ; then + . /usr/local/etc/mavenrc + fi + + if [ -f /etc/mavenrc ] ; then + . /etc/mavenrc + fi + + if [ -f "$HOME/.mavenrc" ] ; then + . "$HOME/.mavenrc" + fi + +fi + +# OS specific support. $var _must_ be set to either true or false. +cygwin=false; +darwin=false; +mingw=false +case "$(uname)" in + CYGWIN*) cygwin=true ;; + MINGW*) mingw=true;; + Darwin*) darwin=true + # Use /usr/libexec/java_home if available, otherwise fall back to /Library/Java/Home + # See https://developer.apple.com/library/mac/qa/qa1170/_index.html + if [ -z "$JAVA_HOME" ]; then + if [ -x "/usr/libexec/java_home" ]; then + JAVA_HOME="$(/usr/libexec/java_home)"; export JAVA_HOME + else + JAVA_HOME="/Library/Java/Home"; export JAVA_HOME + fi + fi + ;; +esac + +if [ -z "$JAVA_HOME" ] ; then + if [ -r /etc/gentoo-release ] ; then + JAVA_HOME=$(java-config --jre-home) + fi +fi + +# For Cygwin, ensure paths are in UNIX format before anything is touched +if $cygwin ; then + [ -n "$JAVA_HOME" ] && + JAVA_HOME=$(cygpath --unix "$JAVA_HOME") + [ -n "$CLASSPATH" ] && + CLASSPATH=$(cygpath --path --unix "$CLASSPATH") +fi + +# For Mingw, ensure paths are in UNIX format before anything is touched +if $mingw ; then + [ -n "$JAVA_HOME" ] && [ -d "$JAVA_HOME" ] && + JAVA_HOME="$(cd "$JAVA_HOME" || (echo "cannot cd into $JAVA_HOME."; exit 1); pwd)" +fi + +if [ -z "$JAVA_HOME" ]; then + javaExecutable="$(which javac)" + if [ -n "$javaExecutable" ] && ! [ "$(expr "\"$javaExecutable\"" : '\([^ ]*\)')" = "no" ]; then + # readlink(1) is not available as standard on Solaris 10. + readLink=$(which readlink) + if [ ! "$(expr "$readLink" : '\([^ ]*\)')" = "no" ]; then + if $darwin ; then + javaHome="$(dirname "\"$javaExecutable\"")" + javaExecutable="$(cd "\"$javaHome\"" && pwd -P)/javac" + else + javaExecutable="$(readlink -f "\"$javaExecutable\"")" + fi + javaHome="$(dirname "\"$javaExecutable\"")" + javaHome=$(expr "$javaHome" : '\(.*\)/bin') + JAVA_HOME="$javaHome" + export JAVA_HOME + fi + fi +fi + +if [ -z "$JAVACMD" ] ; then + if [ -n "$JAVA_HOME" ] ; then + if [ -x "$JAVA_HOME/jre/sh/java" ] ; then + # IBM's JDK on AIX uses strange locations for the executables + JAVACMD="$JAVA_HOME/jre/sh/java" + else + JAVACMD="$JAVA_HOME/bin/java" + fi + else + JAVACMD="$(\unset -f command 2>/dev/null; \command -v java)" + fi +fi + +if [ ! -x "$JAVACMD" ] ; then + echo "Error: JAVA_HOME is not defined correctly." >&2 + echo " We cannot execute $JAVACMD" >&2 + exit 1 +fi + +if [ -z "$JAVA_HOME" ] ; then + echo "Warning: JAVA_HOME environment variable is not set." +fi + +# traverses directory structure from process work directory to filesystem root +# first directory with .mvn subdirectory is considered project base directory +find_maven_basedir() { + if [ -z "$1" ] + then + echo "Path not specified to find_maven_basedir" + return 1 + fi + + basedir="$1" + wdir="$1" + while [ "$wdir" != '/' ] ; do + if [ -d "$wdir"/.mvn ] ; then + basedir=$wdir + break + fi + # workaround for JBEAP-8937 (on Solaris 10/Sparc) + if [ -d "${wdir}" ]; then + wdir=$(cd "$wdir/.." || exit 1; pwd) + fi + # end of workaround + done + printf '%s' "$(cd "$basedir" || exit 1; pwd)" +} + +# concatenates all lines of a file +concat_lines() { + if [ -f "$1" ]; then + # Remove \r in case we run on Windows within Git Bash + # and check out the repository with auto CRLF management + # enabled. Otherwise, we may read lines that are delimited with + # \r\n and produce $'-Xarg\r' rather than -Xarg due to word + # splitting rules. + tr -s '\r\n' ' ' < "$1" + fi +} + +log() { + if [ "$MVNW_VERBOSE" = true ]; then + printf '%s\n' "$1" + fi +} + +BASE_DIR=$(find_maven_basedir "$(dirname "$0")") +if [ -z "$BASE_DIR" ]; then + exit 1; +fi + +MAVEN_PROJECTBASEDIR=${MAVEN_BASEDIR:-"$BASE_DIR"}; export MAVEN_PROJECTBASEDIR +log "$MAVEN_PROJECTBASEDIR" + +########################################################################################## +# Extension to allow automatically downloading the maven-wrapper.jar from Maven-central +# This allows using the maven wrapper in projects that prohibit checking in binary data. +########################################################################################## +wrapperJarPath="$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar" +if [ -r "$wrapperJarPath" ]; then + log "Found $wrapperJarPath" +else + log "Couldn't find $wrapperJarPath, downloading it ..." + + if [ -n "$MVNW_REPOURL" ]; then + wrapperUrl="$MVNW_REPOURL/org/apache/maven/wrapper/maven-wrapper/3.2.0/maven-wrapper-3.2.0.jar" + else + wrapperUrl="https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.2.0/maven-wrapper-3.2.0.jar" + fi + while IFS="=" read -r key value; do + # Remove '\r' from value to allow usage on windows as IFS does not consider '\r' as a separator ( considers space, tab, new line ('\n'), and custom '=' ) + safeValue=$(echo "$value" | tr -d '\r') + case "$key" in (wrapperUrl) wrapperUrl="$safeValue"; break ;; + esac + done < "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.properties" + log "Downloading from: $wrapperUrl" + + if $cygwin; then + wrapperJarPath=$(cygpath --path --windows "$wrapperJarPath") + fi + + if command -v wget > /dev/null; then + log "Found wget ... using wget" + [ "$MVNW_VERBOSE" = true ] && QUIET="" || QUIET="--quiet" + if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then + wget $QUIET "$wrapperUrl" -O "$wrapperJarPath" || rm -f "$wrapperJarPath" + else + wget $QUIET --http-user="$MVNW_USERNAME" --http-password="$MVNW_PASSWORD" "$wrapperUrl" -O "$wrapperJarPath" || rm -f "$wrapperJarPath" + fi + elif command -v curl > /dev/null; then + log "Found curl ... using curl" + [ "$MVNW_VERBOSE" = true ] && QUIET="" || QUIET="--silent" + if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then + curl $QUIET -o "$wrapperJarPath" "$wrapperUrl" -f -L || rm -f "$wrapperJarPath" + else + curl $QUIET --user "$MVNW_USERNAME:$MVNW_PASSWORD" -o "$wrapperJarPath" "$wrapperUrl" -f -L || rm -f "$wrapperJarPath" + fi + else + log "Falling back to using Java to download" + javaSource="$MAVEN_PROJECTBASEDIR/.mvn/wrapper/MavenWrapperDownloader.java" + javaClass="$MAVEN_PROJECTBASEDIR/.mvn/wrapper/MavenWrapperDownloader.class" + # For Cygwin, switch paths to Windows format before running javac + if $cygwin; then + javaSource=$(cygpath --path --windows "$javaSource") + javaClass=$(cygpath --path --windows "$javaClass") + fi + if [ -e "$javaSource" ]; then + if [ ! -e "$javaClass" ]; then + log " - Compiling MavenWrapperDownloader.java ..." + ("$JAVA_HOME/bin/javac" "$javaSource") + fi + if [ -e "$javaClass" ]; then + log " - Running MavenWrapperDownloader.java ..." + ("$JAVA_HOME/bin/java" -cp .mvn/wrapper MavenWrapperDownloader "$wrapperUrl" "$wrapperJarPath") || rm -f "$wrapperJarPath" + fi + fi + fi +fi +########################################################################################## +# End of extension +########################################################################################## + +# If specified, validate the SHA-256 sum of the Maven wrapper jar file +wrapperSha256Sum="" +while IFS="=" read -r key value; do + case "$key" in (wrapperSha256Sum) wrapperSha256Sum=$value; break ;; + esac +done < "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.properties" +if [ -n "$wrapperSha256Sum" ]; then + wrapperSha256Result=false + if command -v sha256sum > /dev/null; then + if echo "$wrapperSha256Sum $wrapperJarPath" | sha256sum -c > /dev/null 2>&1; then + wrapperSha256Result=true + fi + elif command -v shasum > /dev/null; then + if echo "$wrapperSha256Sum $wrapperJarPath" | shasum -a 256 -c > /dev/null 2>&1; then + wrapperSha256Result=true + fi + else + echo "Checksum validation was requested but neither 'sha256sum' or 'shasum' are available." + echo "Please install either command, or disable validation by removing 'wrapperSha256Sum' from your maven-wrapper.properties." + exit 1 + fi + if [ $wrapperSha256Result = false ]; then + echo "Error: Failed to validate Maven wrapper SHA-256, your Maven wrapper might be compromised." >&2 + echo "Investigate or delete $wrapperJarPath to attempt a clean download." >&2 + echo "If you updated your Maven version, you need to update the specified wrapperSha256Sum property." >&2 + exit 1 + fi +fi + +MAVEN_OPTS="$(concat_lines "$MAVEN_PROJECTBASEDIR/.mvn/jvm.config") $MAVEN_OPTS" + +# For Cygwin, switch paths to Windows format before running java +if $cygwin; then + [ -n "$JAVA_HOME" ] && + JAVA_HOME=$(cygpath --path --windows "$JAVA_HOME") + [ -n "$CLASSPATH" ] && + CLASSPATH=$(cygpath --path --windows "$CLASSPATH") + [ -n "$MAVEN_PROJECTBASEDIR" ] && + MAVEN_PROJECTBASEDIR=$(cygpath --path --windows "$MAVEN_PROJECTBASEDIR") +fi + +# Provide a "standardized" way to retrieve the CLI args that will +# work with both Windows and non-Windows executions. +MAVEN_CMD_LINE_ARGS="$MAVEN_CONFIG $*" +export MAVEN_CMD_LINE_ARGS + +WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain + +# shellcheck disable=SC2086 # safe args +exec "$JAVACMD" \ + $MAVEN_OPTS \ + $MAVEN_DEBUG_OPTS \ + -classpath "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar" \ + "-Dmaven.multiModuleProjectDirectory=${MAVEN_PROJECTBASEDIR}" \ + ${WRAPPER_LAUNCHER} $MAVEN_CONFIG "$@" diff --git a/mvnw.cmd b/mvnw.cmd new file mode 100644 index 00000000..95ba6f54 --- /dev/null +++ b/mvnw.cmd @@ -0,0 +1,205 @@ +@REM ---------------------------------------------------------------------------- +@REM Licensed to the Apache Software Foundation (ASF) under one +@REM or more contributor license agreements. See the NOTICE file +@REM distributed with this work for additional information +@REM regarding copyright ownership. The ASF licenses this file +@REM to you under the Apache License, Version 2.0 (the +@REM "License"); you may not use this file except in compliance +@REM with the License. You may obtain a copy of the License at +@REM +@REM https://www.apache.org/licenses/LICENSE-2.0 +@REM +@REM Unless required by applicable law or agreed to in writing, +@REM software distributed under the License is distributed on an +@REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +@REM KIND, either express or implied. See the License for the +@REM specific language governing permissions and limitations +@REM under the License. +@REM ---------------------------------------------------------------------------- + +@REM ---------------------------------------------------------------------------- +@REM Apache Maven Wrapper startup batch script, version 3.2.0 +@REM +@REM Required ENV vars: +@REM JAVA_HOME - location of a JDK home dir +@REM +@REM Optional ENV vars +@REM MAVEN_BATCH_ECHO - set to 'on' to enable the echoing of the batch commands +@REM MAVEN_BATCH_PAUSE - set to 'on' to wait for a keystroke before ending +@REM MAVEN_OPTS - parameters passed to the Java VM when running Maven +@REM e.g. to debug Maven itself, use +@REM set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000 +@REM MAVEN_SKIP_RC - flag to disable loading of mavenrc files +@REM ---------------------------------------------------------------------------- + +@REM Begin all REM lines with '@' in case MAVEN_BATCH_ECHO is 'on' +@echo off +@REM set title of command window +title %0 +@REM enable echoing by setting MAVEN_BATCH_ECHO to 'on' +@if "%MAVEN_BATCH_ECHO%" == "on" echo %MAVEN_BATCH_ECHO% + +@REM set %HOME% to equivalent of $HOME +if "%HOME%" == "" (set "HOME=%HOMEDRIVE%%HOMEPATH%") + +@REM Execute a user defined script before this one +if not "%MAVEN_SKIP_RC%" == "" goto skipRcPre +@REM check for pre script, once with legacy .bat ending and once with .cmd ending +if exist "%USERPROFILE%\mavenrc_pre.bat" call "%USERPROFILE%\mavenrc_pre.bat" %* +if exist "%USERPROFILE%\mavenrc_pre.cmd" call "%USERPROFILE%\mavenrc_pre.cmd" %* +:skipRcPre + +@setlocal + +set ERROR_CODE=0 + +@REM To isolate internal variables from possible post scripts, we use another setlocal +@setlocal + +@REM ==== START VALIDATION ==== +if not "%JAVA_HOME%" == "" goto OkJHome + +echo. +echo Error: JAVA_HOME not found in your environment. >&2 +echo Please set the JAVA_HOME variable in your environment to match the >&2 +echo location of your Java installation. >&2 +echo. +goto error + +:OkJHome +if exist "%JAVA_HOME%\bin\java.exe" goto init + +echo. +echo Error: JAVA_HOME is set to an invalid directory. >&2 +echo JAVA_HOME = "%JAVA_HOME%" >&2 +echo Please set the JAVA_HOME variable in your environment to match the >&2 +echo location of your Java installation. >&2 +echo. +goto error + +@REM ==== END VALIDATION ==== + +:init + +@REM Find the project base dir, i.e. the directory that contains the folder ".mvn". +@REM Fallback to current working directory if not found. + +set MAVEN_PROJECTBASEDIR=%MAVEN_BASEDIR% +IF NOT "%MAVEN_PROJECTBASEDIR%"=="" goto endDetectBaseDir + +set EXEC_DIR=%CD% +set WDIR=%EXEC_DIR% +:findBaseDir +IF EXIST "%WDIR%"\.mvn goto baseDirFound +cd .. +IF "%WDIR%"=="%CD%" goto baseDirNotFound +set WDIR=%CD% +goto findBaseDir + +:baseDirFound +set MAVEN_PROJECTBASEDIR=%WDIR% +cd "%EXEC_DIR%" +goto endDetectBaseDir + +:baseDirNotFound +set MAVEN_PROJECTBASEDIR=%EXEC_DIR% +cd "%EXEC_DIR%" + +:endDetectBaseDir + +IF NOT EXIST "%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config" goto endReadAdditionalConfig + +@setlocal EnableExtensions EnableDelayedExpansion +for /F "usebackq delims=" %%a in ("%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config") do set JVM_CONFIG_MAVEN_PROPS=!JVM_CONFIG_MAVEN_PROPS! %%a +@endlocal & set JVM_CONFIG_MAVEN_PROPS=%JVM_CONFIG_MAVEN_PROPS% + +:endReadAdditionalConfig + +SET MAVEN_JAVA_EXE="%JAVA_HOME%\bin\java.exe" +set WRAPPER_JAR="%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.jar" +set WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain + +set WRAPPER_URL="https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.2.0/maven-wrapper-3.2.0.jar" + +FOR /F "usebackq tokens=1,2 delims==" %%A IN ("%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.properties") DO ( + IF "%%A"=="wrapperUrl" SET WRAPPER_URL=%%B +) + +@REM Extension to allow automatically downloading the maven-wrapper.jar from Maven-central +@REM This allows using the maven wrapper in projects that prohibit checking in binary data. +if exist %WRAPPER_JAR% ( + if "%MVNW_VERBOSE%" == "true" ( + echo Found %WRAPPER_JAR% + ) +) else ( + if not "%MVNW_REPOURL%" == "" ( + SET WRAPPER_URL="%MVNW_REPOURL%/org/apache/maven/wrapper/maven-wrapper/3.2.0/maven-wrapper-3.2.0.jar" + ) + if "%MVNW_VERBOSE%" == "true" ( + echo Couldn't find %WRAPPER_JAR%, downloading it ... + echo Downloading from: %WRAPPER_URL% + ) + + powershell -Command "&{"^ + "$webclient = new-object System.Net.WebClient;"^ + "if (-not ([string]::IsNullOrEmpty('%MVNW_USERNAME%') -and [string]::IsNullOrEmpty('%MVNW_PASSWORD%'))) {"^ + "$webclient.Credentials = new-object System.Net.NetworkCredential('%MVNW_USERNAME%', '%MVNW_PASSWORD%');"^ + "}"^ + "[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; $webclient.DownloadFile('%WRAPPER_URL%', '%WRAPPER_JAR%')"^ + "}" + if "%MVNW_VERBOSE%" == "true" ( + echo Finished downloading %WRAPPER_JAR% + ) +) +@REM End of extension + +@REM If specified, validate the SHA-256 sum of the Maven wrapper jar file +SET WRAPPER_SHA_256_SUM="" +FOR /F "usebackq tokens=1,2 delims==" %%A IN ("%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.properties") DO ( + IF "%%A"=="wrapperSha256Sum" SET WRAPPER_SHA_256_SUM=%%B +) +IF NOT %WRAPPER_SHA_256_SUM%=="" ( + powershell -Command "&{"^ + "$hash = (Get-FileHash \"%WRAPPER_JAR%\" -Algorithm SHA256).Hash.ToLower();"^ + "If('%WRAPPER_SHA_256_SUM%' -ne $hash){"^ + " Write-Output 'Error: Failed to validate Maven wrapper SHA-256, your Maven wrapper might be compromised.';"^ + " Write-Output 'Investigate or delete %WRAPPER_JAR% to attempt a clean download.';"^ + " Write-Output 'If you updated your Maven version, you need to update the specified wrapperSha256Sum property.';"^ + " exit 1;"^ + "}"^ + "}" + if ERRORLEVEL 1 goto error +) + +@REM Provide a "standardized" way to retrieve the CLI args that will +@REM work with both Windows and non-Windows executions. +set MAVEN_CMD_LINE_ARGS=%* + +%MAVEN_JAVA_EXE% ^ + %JVM_CONFIG_MAVEN_PROPS% ^ + %MAVEN_OPTS% ^ + %MAVEN_DEBUG_OPTS% ^ + -classpath %WRAPPER_JAR% ^ + "-Dmaven.multiModuleProjectDirectory=%MAVEN_PROJECTBASEDIR%" ^ + %WRAPPER_LAUNCHER% %MAVEN_CONFIG% %* +if ERRORLEVEL 1 goto error +goto end + +:error +set ERROR_CODE=1 + +:end +@endlocal & set ERROR_CODE=%ERROR_CODE% + +if not "%MAVEN_SKIP_RC%"=="" goto skipRcPost +@REM check for post script, once with legacy .bat ending and once with .cmd ending +if exist "%USERPROFILE%\mavenrc_post.bat" call "%USERPROFILE%\mavenrc_post.bat" +if exist "%USERPROFILE%\mavenrc_post.cmd" call "%USERPROFILE%\mavenrc_post.cmd" +:skipRcPost + +@REM pause the script if MAVEN_BATCH_PAUSE is set to 'on' +if "%MAVEN_BATCH_PAUSE%"=="on" pause + +if "%MAVEN_TERMINATE_CMD%"=="on" exit %ERROR_CODE% + +cmd /C exit /B %ERROR_CODE% diff --git a/pom.xml b/pom.xml new file mode 100644 index 00000000..9ac101d2 --- /dev/null +++ b/pom.xml @@ -0,0 +1,132 @@ + + + 4.0.0 + + org.springframework.boot + spring-boot-starter-parent + 3.1.4 + + + id.co.allobank.exchangerate + exchange-rate-service + 1.0.0 + exchange-rate-service + REST API service for aggregating and providing exchange rate data using Frankfurter API with caching and resilience support + + 17 + UTF-8 + UTF-8 + jacoco + ${project.build.directory}/jacoco/jacoco.xml + + **/common/**/*, + **/config/**/*, + **/dto/**/*, + **/exception/**/*, + **/model/**/* + + + + + org.springframework.boot + spring-boot-starter-actuator + + + org.springframework.boot + spring-boot-starter-validation + + + org.springframework.boot + spring-boot-starter-test + test + + + org.springframework.boot + spring-boot-starter-web + + + org.springdoc + springdoc-openapi-starter-webmvc-ui + 2.6.0 + + + org.springframework.boot + spring-boot-starter-data-redis + + + org.springframework.boot + spring-boot-devtools + runtime + true + + + org.projectlombok + lombok + true + + + org.modelmapper + modelmapper + 3.2.1 + + + + org.springframework.boot + spring-boot-starter-webflux + + + + io.github.resilience4j + resilience4j-spring-boot3 + 2.2.0 + + + + + + + org.springframework.boot + spring-boot-maven-plugin + + + + build-info + + + + + + org.jacoco + jacoco-maven-plugin + 0.8.5 + + + default-prepare-agent + + prepare-agent + + + + default-report + prepare-package + + report + + + ${project.build.directory}/jacoco.exec + + id/co/allobank/exchangerate/common/** + id/co/allobank/exchangerate/config/** + id/co/allobank/exchangerate/dto/** + id/co/allobank/exchangerate/exception/** + id/co/allobank/exchangerate/model/** + + + + + + + + diff --git a/src/main/java/id/co/allobank/exchangerate/ExchangeRateServiceApplication.java b/src/main/java/id/co/allobank/exchangerate/ExchangeRateServiceApplication.java new file mode 100644 index 00000000..631875bc --- /dev/null +++ b/src/main/java/id/co/allobank/exchangerate/ExchangeRateServiceApplication.java @@ -0,0 +1,15 @@ +package id.co.allobank.exchangerate; + +import org.springframework.boot.SpringApplication; +import org.springframework.boot.autoconfigure.EnableAutoConfiguration; +import org.springframework.boot.autoconfigure.SpringBootApplication; + +@SpringBootApplication +@EnableAutoConfiguration +public class ExchangeRateServiceApplication { + + public static void main(String[] args) { + SpringApplication.run(ExchangeRateServiceApplication.class, args); + } + +} diff --git a/src/main/java/id/co/allobank/exchangerate/client/FrankfurterClient.java b/src/main/java/id/co/allobank/exchangerate/client/FrankfurterClient.java new file mode 100644 index 00000000..bc05c8b8 --- /dev/null +++ b/src/main/java/id/co/allobank/exchangerate/client/FrankfurterClient.java @@ -0,0 +1,67 @@ +package id.co.allobank.exchangerate.client; + +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.stereotype.Component; +import org.springframework.web.reactive.function.client.WebClient; + +import lombok.extern.slf4j.Slf4j; + +import java.util.Map; + +@Slf4j +@Component +public class FrankfurterClient { + + @Autowired + private WebClient webClient; + + public Map getLatestRates() { + Map result = webClient.get() + .uri("/latest?base=IDR") + .retrieve() + .bodyToMono(Map.class) + .block(); + + return result; + } + + public Map getHistoricalRates() { + + try { + Map result = webClient.get() + .uri(uriBuilder -> uriBuilder + .path("/2024-01-01..2024-01-05") + .queryParam("from", "IDR") + .queryParam("to", "USD") + .build() + ) + .exchangeToMono(response -> { + log.info("STATUS CODE: {}", response.statusCode()); + log.info("HEADERS: {}", response.headers().asHttpHeaders()); + + return response.bodyToMono(Map.class) + .map(body -> { + log.info("RAW BODY: {}", body); + return body; + }); + }) + .block(); + + return result; + + } catch (Exception ex) { + log.error("Failed to fetch historical rates", ex); + throw new RuntimeException("Failed to fetch historical rates", ex); + } + } + + public Map getCurrencies() { + Map result = webClient.get() + .uri("/currencies") + .retrieve() + .bodyToMono(Map.class) + .block(); + + return result; + } +} \ No newline at end of file diff --git a/src/main/java/id/co/allobank/exchangerate/common/Constant.java b/src/main/java/id/co/allobank/exchangerate/common/Constant.java new file mode 100644 index 00000000..dc9c45a6 --- /dev/null +++ b/src/main/java/id/co/allobank/exchangerate/common/Constant.java @@ -0,0 +1,20 @@ +package id.co.allobank.exchangerate.common; + +public class Constant { + + public static final String SUCCESS_MESSAGE = "Success"; + public static final String GENERAL_ERROR_MESSAGE = "General Error"; + public static final String INVALID_REQUEST_MESSAGE = "Invalid Request"; + public static final String INVALID_CURRENCY_MESSAGE = "Invalid Currency"; + public static final String EXTERNAL_SERVICE_ERROR_MESSAGE = "External Service Error"; + + public static final String INVALID_RESOURCE_MESSAGE = "Resource type not supported"; + + public static final String SUCCESS_CODE = "00"; + public static final String GENERAL_ERROR = "06"; + public static final String INVALID_REQUEST = "12"; + public static final String INVALID_CURRENCY = "14"; + public static final String EXTERNAL_SERVICE_ERROR = "91"; + + public static final String GITHUB_USERNAME = "AdePutraGea28"; +} diff --git a/src/main/java/id/co/allobank/exchangerate/config/SwaggerConfig.java b/src/main/java/id/co/allobank/exchangerate/config/SwaggerConfig.java new file mode 100644 index 00000000..9c1ede34 --- /dev/null +++ b/src/main/java/id/co/allobank/exchangerate/config/SwaggerConfig.java @@ -0,0 +1,32 @@ +package id.co.allobank.exchangerate.config; + +import org.springframework.beans.factory.annotation.Value; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import io.swagger.v3.oas.models.OpenAPI; +import io.swagger.v3.oas.models.info.Info; + +@Configuration +public class SwaggerConfig { + + @Value("${open-api.title}") + private String openApiTitle; + + @Value("${open-api.description}") + private String openApiDescription; + + @Value("${open-api.version}") + private String openApiVersion; + + private static final String SECURITY_SCHEME_NAME = "bearerAuth"; + + @Bean + public OpenAPI openAPI() { + return new OpenAPI() + .info(new Info() + .title(openApiTitle) + .description(openApiDescription) + .version(openApiVersion)); + } +} \ No newline at end of file diff --git a/src/main/java/id/co/allobank/exchangerate/config/WebClientFactory.java b/src/main/java/id/co/allobank/exchangerate/config/WebClientFactory.java new file mode 100644 index 00000000..b437ab1e --- /dev/null +++ b/src/main/java/id/co/allobank/exchangerate/config/WebClientFactory.java @@ -0,0 +1,28 @@ +package id.co.allobank.exchangerate.config; + +import org.springframework.beans.factory.FactoryBean; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.stereotype.Component; +import org.springframework.web.reactive.function.client.WebClient; + +import lombok.extern.slf4j.Slf4j; + +@Slf4j +@Component +public class WebClientFactory implements FactoryBean { + + @Value("${frankfurter.base-url}") + private String baseUrl; + + @Override + public WebClient getObject() { + return WebClient.builder() + .baseUrl("https://api.frankfurter.dev/v1") + .build(); + } + + @Override + public Class getObjectType() { + return WebClient.class; + } +} \ No newline at end of file diff --git a/src/main/java/id/co/allobank/exchangerate/controller/FinanceController.java b/src/main/java/id/co/allobank/exchangerate/controller/FinanceController.java new file mode 100644 index 00000000..5975c9b4 --- /dev/null +++ b/src/main/java/id/co/allobank/exchangerate/controller/FinanceController.java @@ -0,0 +1,25 @@ +package id.co.allobank.exchangerate.controller; + +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PathVariable; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RestController; + +import id.co.allobank.exchangerate.dto.BaseResponseDTO; +import id.co.allobank.exchangerate.service.FinanceService; + +@RestController +@RequestMapping("/api/finance") +public class FinanceController { + + private final FinanceService service; + + public FinanceController(FinanceService service) { + this.service = service; + } + + @GetMapping("/data/{type}") + public BaseResponseDTO get(@PathVariable String type) { + return service.getData(type); + } +} diff --git a/src/main/java/id/co/allobank/exchangerate/dto/BaseResponseDTO.java b/src/main/java/id/co/allobank/exchangerate/dto/BaseResponseDTO.java new file mode 100644 index 00000000..468c9f67 --- /dev/null +++ b/src/main/java/id/co/allobank/exchangerate/dto/BaseResponseDTO.java @@ -0,0 +1,43 @@ +package id.co.allobank.exchangerate.dto; + +import java.time.LocalDateTime; +import java.time.format.DateTimeFormatter; + +import com.fasterxml.jackson.annotation.JsonProperty; + +import id.co.allobank.exchangerate.common.Constant; +import lombok.Getter; + +@Getter +public class BaseResponseDTO { + + private static final DateTimeFormatter FORMATTER = + DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"); + + @JsonProperty("responseCode") + private final String responseCode; + + @JsonProperty("message") + private final String message; + + @JsonProperty("dateTime") + private final String dateTime; + + @JsonProperty("data") + private final T data; + + public BaseResponseDTO(String responseCode, String message, T data) { + this.responseCode = responseCode; + this.message = message; + this.data = data; + this.dateTime = LocalDateTime.now().format(FORMATTER); + } + + public static BaseResponseDTO success(T data) { + return new BaseResponseDTO<>(Constant.SUCCESS_CODE, Constant.SUCCESS_MESSAGE, data); + } + + public static BaseResponseDTO error(String responseCode, String message) { + return new BaseResponseDTO<>(responseCode, message, null); + } +} \ No newline at end of file diff --git a/src/main/java/id/co/allobank/exchangerate/exception/CustomException.java b/src/main/java/id/co/allobank/exchangerate/exception/CustomException.java new file mode 100644 index 00000000..eb64e8e2 --- /dev/null +++ b/src/main/java/id/co/allobank/exchangerate/exception/CustomException.java @@ -0,0 +1,24 @@ +package id.co.allobank.exchangerate.exception; + +import org.springframework.http.HttpStatus; + +import lombok.Getter; + +@Getter +public class CustomException extends RuntimeException { + + private final HttpStatus httpStatus; + private final String responseCode; + + public CustomException(String message, HttpStatus httpStatus, String responseCode) { + super(message); + this.httpStatus = httpStatus; + this.responseCode = responseCode; + } + + public CustomException(String message, Throwable cause, HttpStatus httpStatus, String responseCode) { + super(message, cause); + this.httpStatus = httpStatus; + this.responseCode = responseCode; + } +} \ No newline at end of file diff --git a/src/main/java/id/co/allobank/exchangerate/exception/GlobalExceptionHandler.java b/src/main/java/id/co/allobank/exchangerate/exception/GlobalExceptionHandler.java new file mode 100644 index 00000000..0d59ac7c --- /dev/null +++ b/src/main/java/id/co/allobank/exchangerate/exception/GlobalExceptionHandler.java @@ -0,0 +1,41 @@ +package id.co.allobank.exchangerate.exception; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.http.ResponseEntity; +import org.springframework.web.bind.annotation.ExceptionHandler; +import org.springframework.web.bind.annotation.RestControllerAdvice; + +import id.co.allobank.exchangerate.common.Constant; +import id.co.allobank.exchangerate.dto.BaseResponseDTO; + +@RestControllerAdvice +public class GlobalExceptionHandler { + + private static final Logger log = LoggerFactory.getLogger(GlobalExceptionHandler.class); + + // Handle CustomException + @ExceptionHandler(CustomException.class) + public ResponseEntity> handleCustomException(CustomException ex) { + + log.error("CustomException occurred: {}", ex.getMessage(), ex); + + return ResponseEntity + .status(ex.getHttpStatus()) + .body(BaseResponseDTO.error(ex.getResponseCode(), ex.getMessage())); + } + + // Handle generic exception (fallback) + @ExceptionHandler(Exception.class) + public ResponseEntity> handleException(Exception ex) { + + log.error("Unhandled Exception: {}", ex.getMessage(), ex); + + return ResponseEntity + .internalServerError() + .body(BaseResponseDTO.error( + Constant.GENERAL_ERROR, + "Internal Server Error" + )); + } +} \ No newline at end of file diff --git a/src/main/java/id/co/allobank/exchangerate/runner/DataLoaderRunner.java b/src/main/java/id/co/allobank/exchangerate/runner/DataLoaderRunner.java new file mode 100644 index 00000000..7a3b0c88 --- /dev/null +++ b/src/main/java/id/co/allobank/exchangerate/runner/DataLoaderRunner.java @@ -0,0 +1,56 @@ +package id.co.allobank.exchangerate.runner; + +import java.util.List; +import java.util.Map; +import java.util.stream.Collectors; + +import org.springframework.boot.ApplicationArguments; +import org.springframework.boot.ApplicationRunner; +import org.springframework.stereotype.Component; + +import id.co.allobank.exchangerate.dto.BaseResponseDTO; +import id.co.allobank.exchangerate.store.InMemoryStore; +import id.co.allobank.exchangerate.strategy.FinanceDataStrategy; +import lombok.extern.slf4j.Slf4j; + +@Slf4j +@Component +public class DataLoaderRunner implements ApplicationRunner { + + private final Map strategyMap; + private final InMemoryStore store; + + public DataLoaderRunner(List strategies, + InMemoryStore store) { + + this.strategyMap = strategies.stream() + .collect(Collectors.toMap( + FinanceDataStrategy::getType, + s -> s + )); + + this.store = store; + } + + @Override + public void run(ApplicationArguments args) { + + log.info("=====> strategyMap : {}", this.strategyMap); + Map data = this.strategyMap.entrySet().stream() + .collect(Collectors.toMap( + Map.Entry::getKey, + e -> { + try { + BaseResponseDTO result = e.getValue().fetch(); + + return result.getData(); + } catch (Exception ex) { + log.error("Error on strategy {}", e.getKey(), ex); + return null; // atau fallback + } + } + )); + + store.init(data); + } +} \ No newline at end of file diff --git a/src/main/java/id/co/allobank/exchangerate/service/FinanceService.java b/src/main/java/id/co/allobank/exchangerate/service/FinanceService.java new file mode 100644 index 00000000..211aeb15 --- /dev/null +++ b/src/main/java/id/co/allobank/exchangerate/service/FinanceService.java @@ -0,0 +1,51 @@ +package id.co.allobank.exchangerate.service; + +import java.util.List; +import java.util.Map; +import java.util.stream.Collectors; + +import org.springframework.http.HttpStatus; +import org.springframework.stereotype.Service; + +import id.co.allobank.exchangerate.common.Constant; +import id.co.allobank.exchangerate.dto.BaseResponseDTO; +import id.co.allobank.exchangerate.exception.CustomException; +import id.co.allobank.exchangerate.store.InMemoryStore; +import id.co.allobank.exchangerate.strategy.FinanceDataStrategy; + +@Service +public class FinanceService { + + private final Map strategyMap; + private final InMemoryStore store; + + public FinanceService(List strategies, InMemoryStore store) { + this.strategyMap = strategies.stream() + .collect(Collectors.toMap( + FinanceDataStrategy::getType, + s -> s + )); + this.store = store; + } + + public BaseResponseDTO getData(String resourceType) { + + Object cached = store.get(resourceType); + + if (cached != null) { + return BaseResponseDTO.success(cached); + } + + FinanceDataStrategy strategy = this.strategyMap.get(resourceType); + + if (strategy == null) { + throw new CustomException( + "Invalid resource", + HttpStatus.BAD_REQUEST, + Constant.INVALID_REQUEST + ); + } + + return strategy.fetch(); + } +} \ No newline at end of file diff --git a/src/main/java/id/co/allobank/exchangerate/store/InMemoryStore.java b/src/main/java/id/co/allobank/exchangerate/store/InMemoryStore.java new file mode 100644 index 00000000..e2514fc9 --- /dev/null +++ b/src/main/java/id/co/allobank/exchangerate/store/InMemoryStore.java @@ -0,0 +1,20 @@ +package id.co.allobank.exchangerate.store; + +import org.springframework.stereotype.Component; + +import java.util.Map; + +@Component +public class InMemoryStore { + + private Map data; + + public void init(Map data) { + this.data = Map.copyOf(data); // immutable + } + + public Object get(String key) { + Object result = data.get(key); + return result; + } +} \ No newline at end of file diff --git a/src/main/java/id/co/allobank/exchangerate/strategy/CurrencyStrategy.java b/src/main/java/id/co/allobank/exchangerate/strategy/CurrencyStrategy.java new file mode 100644 index 00000000..0755f315 --- /dev/null +++ b/src/main/java/id/co/allobank/exchangerate/strategy/CurrencyStrategy.java @@ -0,0 +1,31 @@ +package id.co.allobank.exchangerate.strategy; + +import java.util.Map; + +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.stereotype.Component; + +import id.co.allobank.exchangerate.client.FrankfurterClient; +import id.co.allobank.exchangerate.dto.BaseResponseDTO; + +@Component +public class CurrencyStrategy implements FinanceDataStrategy { + + @Autowired + private FrankfurterClient client; + + // public CurrencyStrategy(FrankfurterClient client) { + // this.client = client; + // } + + @Override + public String getType() { + return "supported_currencies"; + } + + @Override + public BaseResponseDTO fetch() { + Map result = client.getCurrencies(); + return BaseResponseDTO.success(result); + } +} \ No newline at end of file diff --git a/src/main/java/id/co/allobank/exchangerate/strategy/FinanceDataStrategy.java b/src/main/java/id/co/allobank/exchangerate/strategy/FinanceDataStrategy.java new file mode 100644 index 00000000..ed14b1d2 --- /dev/null +++ b/src/main/java/id/co/allobank/exchangerate/strategy/FinanceDataStrategy.java @@ -0,0 +1,20 @@ +package id.co.allobank.exchangerate.strategy; + +import id.co.allobank.exchangerate.dto.BaseResponseDTO; + +public interface FinanceDataStrategy { + + /** + * Key mapping untuk resourceType dari endpoint + * contoh: + * latest_idr_rates + * historical_idr_usd + * supported_currencies + */ + String getType(); + + /** + * Execute logic untuk ambil + transform data + */ + BaseResponseDTO fetch(); +} diff --git a/src/main/java/id/co/allobank/exchangerate/strategy/HistoricalStrategy.java b/src/main/java/id/co/allobank/exchangerate/strategy/HistoricalStrategy.java new file mode 100644 index 00000000..2c3ced0f --- /dev/null +++ b/src/main/java/id/co/allobank/exchangerate/strategy/HistoricalStrategy.java @@ -0,0 +1,29 @@ +package id.co.allobank.exchangerate.strategy; + +import java.util.Map; + +import org.springframework.stereotype.Component; + +import id.co.allobank.exchangerate.client.FrankfurterClient; +import id.co.allobank.exchangerate.dto.BaseResponseDTO; + +@Component +public class HistoricalStrategy implements FinanceDataStrategy { + + private final FrankfurterClient client; + + public HistoricalStrategy(FrankfurterClient client) { + this.client = client; + } + + @Override + public String getType() { + return "historical_idr_usd"; + } + + @Override + public BaseResponseDTO fetch() { + Map result = client.getHistoricalRates(); + return BaseResponseDTO.success(result); + } +} \ No newline at end of file diff --git a/src/main/java/id/co/allobank/exchangerate/strategy/LatestIdrRatesStrategy.java b/src/main/java/id/co/allobank/exchangerate/strategy/LatestIdrRatesStrategy.java new file mode 100644 index 00000000..0407a029 --- /dev/null +++ b/src/main/java/id/co/allobank/exchangerate/strategy/LatestIdrRatesStrategy.java @@ -0,0 +1,91 @@ +package id.co.allobank.exchangerate.strategy; + +import java.util.Map; + +import org.springframework.http.HttpStatus; +import org.springframework.stereotype.Component; + +import id.co.allobank.exchangerate.client.FrankfurterClient; +import id.co.allobank.exchangerate.common.Constant; +import id.co.allobank.exchangerate.dto.BaseResponseDTO; +import id.co.allobank.exchangerate.exception.CustomException; +import lombok.extern.slf4j.Slf4j; + +@Slf4j +@Component +public class LatestIdrRatesStrategy implements FinanceDataStrategy { + + private final FrankfurterClient client; + + public LatestIdrRatesStrategy(FrankfurterClient client) { + this.client = client; + } + + @Override + public String getType() { + return "latest_idr_rates"; + } + + @Override + public BaseResponseDTO fetch() { + + log.info("CALLING API: latest_idr_rates"); + + Map response = client.getLatestRates(); + + log.info("RESPONSE: " + response); + + if (response == null) { + log.error("API response is null for latest_idr_rates"); + throw new CustomException( + "API latest_idr_rates returned null", + HttpStatus.INTERNAL_SERVER_ERROR, + Constant.EXTERNAL_SERVICE_ERROR + ); + } + + Map rates = (Map) response.get("rates"); + + if (rates == null) { + log.error("Rates data is null in API response"); + throw new CustomException( + "Rates is null from API", + HttpStatus.INTERNAL_SERVER_ERROR, + Constant.EXTERNAL_SERVICE_ERROR + ); + } + + if (!rates.containsKey("USD") || rates.get("USD") == null) { + log.error("USD rate is missing or null in API response"); + throw new CustomException( + "USD rate is missing or null from API response", + HttpStatus.INTERNAL_SERVER_ERROR, + Constant.EXTERNAL_SERVICE_ERROR + ); + } + + double usdRate = rates.get("USD"); + + if (usdRate <= 0) { + log.error("Invalid USD rate received: {}", usdRate); + throw new CustomException( + "Invalid USD rate received from API: " + usdRate, + HttpStatus.INTERNAL_SERVER_ERROR, + Constant.EXTERNAL_SERVICE_ERROR + ); + } + + double spread = calculateSpreadFactor(Constant.GITHUB_USERNAME); + + double result = (1 / usdRate) * (1 + spread); + + rates.put("USD_BuySpread_IDR", result); + + return BaseResponseDTO.success(response); + } + + private double calculateSpreadFactor(String username) { + int sum = username.toLowerCase().chars().sum(); + return (sum % 1000) / 100000.0; + } +} diff --git a/src/main/resources/.DS_Store b/src/main/resources/.DS_Store new file mode 100644 index 00000000..25ddf2b0 Binary files /dev/null and b/src/main/resources/.DS_Store differ diff --git a/src/main/resources/banner.txt b/src/main/resources/banner.txt new file mode 100644 index 00000000..09dfafdc --- /dev/null +++ b/src/main/resources/banner.txt @@ -0,0 +1,9 @@ + ___ _ ___ _ +( _`\ ( ) | _`\ ( )_ _ +| (_(_) ___ | |__ _ _ ___ __ __ | (_) ) _ _ | ,_) __ ___ __ _ __ _ _ (_) ___ __ +| _)_ (`\/') /'___)| _ `\ /'_` )/' _ `\ /'_ `\ /'__`\ | , / /'_` )| | /'__`\ /',__) /'__`\( '__)( ) ( )| | /'___) /'__`\ +| (_( ) > < ( (___ | | | |( (_| || ( ) |( (_) |( ___/ | |\ \ ( (_| || |_ ( ___/ \__, \( ___/| | | \_/ || |( (___ ( ___/ +(____/'(_/\_)`\____)(_) (_)`\__,_)(_) (_)`\__ |`\____) (_) (_)`\__,_)`\__)`\____) (____/`\____)(_) `\___/'(_)`\____)`\____) + ( )_) | + \___/' +${application.title} ${application.version} Powered by Spring Boot ${spring-boot.version} diff --git a/src/main/resources/config/application.properties b/src/main/resources/config/application.properties new file mode 100644 index 00000000..8316c626 --- /dev/null +++ b/src/main/resources/config/application.properties @@ -0,0 +1,27 @@ +server.port=8082 + +# =============================== +# LOG +# =============================== +logging.level.root=INFO +logging.level.id.co.allobank=DEBUG + +# =============================== +# SWAGGER +# =============================== +springdoc.swagger-ui.enabled=true +springdoc.swagger-ui.path=/swagger-ui.html +springdoc.api-docs.path=/api-docs +springdoc.api-docs.enabled=true + +springdoc.default-consumes-media-type=application/json +springdoc.default-produces-media-type=application/json + +open-api.title=exchangerate +open-api.description=REST API for currency exchange rate aggregation using Frankfurter API, supporting real-time conversion and standardized response format +open-api.version=v1.0.0 + +# =============================== +# EXTERNAL API +# =============================== +frankfurter.base-url=https://api.frankfurter.app/ \ No newline at end of file