commit d85140a300bcadc7b2010adda61b408bc28e29f9 Author: Heril Muratovic Date: Sun Dec 5 18:41:41 2021 +0100 Initial commit diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..549e00a --- /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/.mvn/wrapper/MavenWrapperDownloader.java b/.mvn/wrapper/MavenWrapperDownloader.java new file mode 100644 index 0000000..a45eb6b --- /dev/null +++ b/.mvn/wrapper/MavenWrapperDownloader.java @@ -0,0 +1,118 @@ +/* + * Copyright 2007-present the original author or authors. + * + * Licensed 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. + */ + +import java.net.*; +import java.io.*; +import java.nio.channels.*; +import java.util.Properties; + +public class MavenWrapperDownloader { + + private static final String WRAPPER_VERSION = "0.5.6"; + /** + * Default URL to download the maven-wrapper.jar from, if no 'downloadUrl' is provided. + */ + private static final String DEFAULT_DOWNLOAD_URL = "https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/" + + WRAPPER_VERSION + "/maven-wrapper-" + WRAPPER_VERSION + ".jar"; + + /** + * Path to the maven-wrapper.properties file, which might contain a downloadUrl property to + * use instead of the default one. + */ + private static final String MAVEN_WRAPPER_PROPERTIES_PATH = + ".mvn/wrapper/maven-wrapper.properties"; + + /** + * Path where the maven-wrapper.jar will be saved to. + */ + private static final String MAVEN_WRAPPER_JAR_PATH = + ".mvn/wrapper/maven-wrapper.jar"; + + /** + * Name of the property which should be used to override the default download url for the wrapper. + */ + private static final String PROPERTY_NAME_WRAPPER_URL = "wrapperUrl"; + + public static void main(String args[]) { + System.out.println("- Downloader started"); + File baseDirectory = new File(args[0]); + System.out.println("- Using base directory: " + baseDirectory.getAbsolutePath()); + + // If the maven-wrapper.properties exists, read it and check if it contains a custom + // wrapperUrl parameter. + File mavenWrapperPropertyFile = new File(baseDirectory, MAVEN_WRAPPER_PROPERTIES_PATH); + String url = DEFAULT_DOWNLOAD_URL; + if (mavenWrapperPropertyFile.exists()) { + FileInputStream mavenWrapperPropertyFileInputStream = null; + try { + mavenWrapperPropertyFileInputStream = new FileInputStream(mavenWrapperPropertyFile); + Properties mavenWrapperProperties = new Properties(); + mavenWrapperProperties.load(mavenWrapperPropertyFileInputStream); + url = mavenWrapperProperties.getProperty(PROPERTY_NAME_WRAPPER_URL, url); + } catch (IOException e) { + System.out.println("- ERROR loading '" + MAVEN_WRAPPER_PROPERTIES_PATH + "'"); + } finally { + try { + if (mavenWrapperPropertyFileInputStream != null) { + mavenWrapperPropertyFileInputStream.close(); + } + } catch (IOException e) { + // Ignore ... + } + } + } + System.out.println("- Downloading from: " + url); + + File outputFile = new File(baseDirectory.getAbsolutePath(), MAVEN_WRAPPER_JAR_PATH); + if (!outputFile.getParentFile().exists()) { + if (!outputFile.getParentFile().mkdirs()) { + System.out.println( + "- ERROR creating output directory '" + outputFile.getParentFile().getAbsolutePath() + "'"); + } + } + System.out.println("- Downloading to: " + outputFile.getAbsolutePath()); + try { + downloadFileFromURL(url, outputFile); + System.out.println("Done"); + System.exit(0); + } catch (Throwable e) { + System.out.println("- Error downloading"); + e.printStackTrace(); + System.exit(1); + } + } + + private static void downloadFileFromURL(String urlString, File destination) throws Exception { + if (System.getenv("MVNW_USERNAME") != null && System.getenv("MVNW_PASSWORD") != null) { + String username = System.getenv("MVNW_USERNAME"); + char[] password = System.getenv("MVNW_PASSWORD").toCharArray(); + Authenticator.setDefault(new Authenticator() { + @Override + protected PasswordAuthentication getPasswordAuthentication() { + return new PasswordAuthentication(username, password); + } + }); + } + URL website = new URL(urlString); + ReadableByteChannel rbc; + rbc = Channels.newChannel(website.openStream()); + FileOutputStream fos = new FileOutputStream(destination); + fos.getChannel().transferFrom(rbc, 0, Long.MAX_VALUE); + fos.close(); + rbc.close(); + } + +} diff --git a/.mvn/wrapper/maven-wrapper.jar b/.mvn/wrapper/maven-wrapper.jar new file mode 100644 index 0000000..2cc7d4a Binary files /dev/null and b/.mvn/wrapper/maven-wrapper.jar differ diff --git a/.mvn/wrapper/maven-wrapper.properties b/.mvn/wrapper/maven-wrapper.properties new file mode 100644 index 0000000..a9f1ef8 --- /dev/null +++ b/.mvn/wrapper/maven-wrapper.properties @@ -0,0 +1,2 @@ +distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.8.3/apache-maven-3.8.3-bin.zip +wrapperUrl=https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar diff --git a/README.md b/README.md new file mode 100644 index 0000000..af655a4 --- /dev/null +++ b/README.md @@ -0,0 +1,60 @@ +## Spring Hexagonal Architecture +This project illustrates usage of Hexagonal Architecture in Spring Boot. + +The hexagonal architecture is based on three principles and techniques: + +- Explicitly separate User-Side, Business Logic, and Server-Side +- Dependencies are going from User-Side and Server-Side to the Business Logic +- We isolate the boundaries by using Ports and Adapters + +Outside the hexagon we have any real world thing that the application interacts with. +These things include humans, other applications, or any hardware/software device. They are the actors. +We could say that actors are the environment of the application. + +Actors are arranged around the hexagon depending on who triggers the interaction between the application and the actor. + +### Hexagonal architecture schema +![alt text](https://github.com/hedza06/hexagonal-spring/resources/data/hex-schema.png) + +### Ports +The interactions between actors and the application are organized at the hexagon boundary by the reason why they +are interacting with the application. Each group of interactions with a given purpose/intention is a port. + +Ports should be named according to what they are for, not according to any technology. +So, in order to name a port, we should use a verb ending with “ing” and we should say “this port is for …ing something”. +For example: + +- This driver port is for “adding products to the shopping cart”; +- This driven port (repository) is “for obtaining information about products”; +- This driven port (recipient) is for “sending notifications”. + +Ports are the application boundary, in the picture a port is an edge of the hexagon. From the outside world, actors +can only interact with the hexagon ports, they shouldn’t be able to access the inside of the hexagon. + +Ports are interfaces that the application offers to the outside world for allowing actors interact with the application. + +### Adapters +Actors interact with hexagon ports through adapters using a specific technology. An adapter is a software component +that allows a technology to interact with a port of the hexagon. Given a port, there may be an adapter for each desired +technology that we want to use. Adapters are outside the application. + +A driver adapter uses a driver port interface, converting a specific technology request into a technology +agnostic request to a driver port. + +A driven adapter implements a driven port interface, converting the technology agnostic methods of the port into +specific technology methods. + +### Contribution/Suggestions +If someone is interested for contribution or have some suggestions please contact me on e-mail `hedzaprog@gmail.com`. +There are more to come from hexagonal architecture and first I'm planing to write tests for given examples in project. + +### Author +Heril Muratović +Software Engineer +
+**Mobile**: +38269657962 +**E-mail**: hedzaprog@gmail.com +**Skype**: hedza06 +**Twitter**: hedzakirk +**LinkedIn**: https://www.linkedin.com/in/heril-muratovi%C4%87-021097132/ +**StackOverflow**: https://stackoverflow.com/users/4078505/heril-muratovic \ No newline at end of file diff --git a/mvnw b/mvnw new file mode 100755 index 0000000..a16b543 --- /dev/null +++ b/mvnw @@ -0,0 +1,310 @@ +#!/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. +# ---------------------------------------------------------------------------- + +# ---------------------------------------------------------------------------- +# Maven Start Up Batch script +# +# Required ENV vars: +# ------------------ +# JAVA_HOME - location of a JDK home dir +# +# Optional ENV vars +# ----------------- +# M2_HOME - location of maven2's installed home dir +# 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 /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 + export JAVA_HOME="`/usr/libexec/java_home`" + else + export JAVA_HOME="/Library/Java/Home" + fi + fi + ;; +esac + +if [ -z "$JAVA_HOME" ] ; then + if [ -r /etc/gentoo-release ] ; then + JAVA_HOME=`java-config --jre-home` + fi +fi + +if [ -z "$M2_HOME" ] ; then + ## resolve links - $0 may be a link to maven's home + PRG="$0" + + # need this for relative symlinks + while [ -h "$PRG" ] ; do + ls=`ls -ld "$PRG"` + link=`expr "$ls" : '.*-> \(.*\)$'` + if expr "$link" : '/.*' > /dev/null; then + PRG="$link" + else + PRG="`dirname "$PRG"`/$link" + fi + done + + saveddir=`pwd` + + M2_HOME=`dirname "$PRG"`/.. + + # make it fully qualified + M2_HOME=`cd "$M2_HOME" && pwd` + + cd "$saveddir" + # echo Using m2 at $M2_HOME +fi + +# For Cygwin, ensure paths are in UNIX format before anything is touched +if $cygwin ; then + [ -n "$M2_HOME" ] && + M2_HOME=`cygpath --unix "$M2_HOME"` + [ -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 "$M2_HOME" ] && + M2_HOME="`(cd "$M2_HOME"; pwd)`" + [ -n "$JAVA_HOME" ] && + JAVA_HOME="`(cd "$JAVA_HOME"; 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="`which 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 + +CLASSWORLDS_LAUNCHER=org.codehaus.plexus.classworlds.launcher.Launcher + +# 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/.."; pwd` + fi + # end of workaround + done + echo "${basedir}" +} + +# concatenates all lines of a file +concat_lines() { + if [ -f "$1" ]; then + echo "$(tr -s '\n' ' ' < "$1")" + fi +} + +BASE_DIR=`find_maven_basedir "$(pwd)"` +if [ -z "$BASE_DIR" ]; then + exit 1; +fi + +########################################################################################## +# 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. +########################################################################################## +if [ -r "$BASE_DIR/.mvn/wrapper/maven-wrapper.jar" ]; then + if [ "$MVNW_VERBOSE" = true ]; then + echo "Found .mvn/wrapper/maven-wrapper.jar" + fi +else + if [ "$MVNW_VERBOSE" = true ]; then + echo "Couldn't find .mvn/wrapper/maven-wrapper.jar, downloading it ..." + fi + if [ -n "$MVNW_REPOURL" ]; then + jarUrl="$MVNW_REPOURL/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar" + else + jarUrl="https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar" + fi + while IFS="=" read key value; do + case "$key" in (wrapperUrl) jarUrl="$value"; break ;; + esac + done < "$BASE_DIR/.mvn/wrapper/maven-wrapper.properties" + if [ "$MVNW_VERBOSE" = true ]; then + echo "Downloading from: $jarUrl" + fi + wrapperJarPath="$BASE_DIR/.mvn/wrapper/maven-wrapper.jar" + if $cygwin; then + wrapperJarPath=`cygpath --path --windows "$wrapperJarPath"` + fi + + if command -v wget > /dev/null; then + if [ "$MVNW_VERBOSE" = true ]; then + echo "Found wget ... using wget" + fi + if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then + wget "$jarUrl" -O "$wrapperJarPath" + else + wget --http-user=$MVNW_USERNAME --http-password=$MVNW_PASSWORD "$jarUrl" -O "$wrapperJarPath" + fi + elif command -v curl > /dev/null; then + if [ "$MVNW_VERBOSE" = true ]; then + echo "Found curl ... using curl" + fi + if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then + curl -o "$wrapperJarPath" "$jarUrl" -f + else + curl --user $MVNW_USERNAME:$MVNW_PASSWORD -o "$wrapperJarPath" "$jarUrl" -f + fi + + else + if [ "$MVNW_VERBOSE" = true ]; then + echo "Falling back to using Java to download" + fi + javaClass="$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.java" + # For Cygwin, switch paths to Windows format before running javac + if $cygwin; then + javaClass=`cygpath --path --windows "$javaClass"` + fi + if [ -e "$javaClass" ]; then + if [ ! -e "$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.class" ]; then + if [ "$MVNW_VERBOSE" = true ]; then + echo " - Compiling MavenWrapperDownloader.java ..." + fi + # Compiling the Java class + ("$JAVA_HOME/bin/javac" "$javaClass") + fi + if [ -e "$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.class" ]; then + # Running the downloader + if [ "$MVNW_VERBOSE" = true ]; then + echo " - Running MavenWrapperDownloader.java ..." + fi + ("$JAVA_HOME/bin/java" -cp .mvn/wrapper MavenWrapperDownloader "$MAVEN_PROJECTBASEDIR") + fi + fi + fi +fi +########################################################################################## +# End of extension +########################################################################################## + +export MAVEN_PROJECTBASEDIR=${MAVEN_BASEDIR:-"$BASE_DIR"} +if [ "$MVNW_VERBOSE" = true ]; then + echo $MAVEN_PROJECTBASEDIR +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 "$M2_HOME" ] && + M2_HOME=`cygpath --path --windows "$M2_HOME"` + [ -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 + +exec "$JAVACMD" \ + $MAVEN_OPTS \ + -classpath "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar" \ + "-Dmaven.home=${M2_HOME}" "-Dmaven.multiModuleProjectDirectory=${MAVEN_PROJECTBASEDIR}" \ + ${WRAPPER_LAUNCHER} $MAVEN_CONFIG "$@" diff --git a/mvnw.cmd b/mvnw.cmd new file mode 100644 index 0000000..c8d4337 --- /dev/null +++ b/mvnw.cmd @@ -0,0 +1,182 @@ +@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 Maven Start Up Batch script +@REM +@REM Required ENV vars: +@REM JAVA_HOME - location of a JDK home dir +@REM +@REM Optional ENV vars +@REM M2_HOME - location of maven2's installed home dir +@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 "%HOME%\mavenrc_pre.bat" call "%HOME%\mavenrc_pre.bat" +if exist "%HOME%\mavenrc_pre.cmd" call "%HOME%\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 DOWNLOAD_URL="https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar" + +FOR /F "tokens=1,2 delims==" %%A IN ("%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.properties") DO ( + IF "%%A"=="wrapperUrl" SET DOWNLOAD_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 DOWNLOAD_URL="%MVNW_REPOURL%/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar" + ) + if "%MVNW_VERBOSE%" == "true" ( + echo Couldn't find %WRAPPER_JAR%, downloading it ... + echo Downloading from: %DOWNLOAD_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('%DOWNLOAD_URL%', '%WRAPPER_JAR%')"^ + "}" + if "%MVNW_VERBOSE%" == "true" ( + echo Finished downloading %WRAPPER_JAR% + ) +) +@REM End of extension + +@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 "%HOME%\mavenrc_post.bat" call "%HOME%\mavenrc_post.bat" +if exist "%HOME%\mavenrc_post.cmd" call "%HOME%\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% + +exit /B %ERROR_CODE% diff --git a/pom.xml b/pom.xml new file mode 100644 index 0000000..1e9cd46 --- /dev/null +++ b/pom.xml @@ -0,0 +1,73 @@ + + + 4.0.0 + + org.springframework.boot + spring-boot-starter-parent + 2.6.1 + + + com.hedza06 + hexagonal-spring + 0.0.1-SNAPSHOT + hexagonal-spring + Hexagonal Architecture With Spring Boot + + 11 + + + + org.springframework.boot + spring-boot-starter-data-jpa + + + org.springframework.boot + spring-boot-starter-web + + + + mysql + mysql-connector-java + runtime + + + org.springframework.boot + spring-boot-configuration-processor + true + + + org.projectlombok + lombok + true + + + org.springframework.boot + spring-boot-starter-test + test + + + org.apache.httpcomponents + httpclient + 4.5.12 + + + + + + + org.springframework.boot + spring-boot-maven-plugin + + + + org.projectlombok + lombok + + + + + + + + diff --git a/src/main/java/com/hedza06/hexagonalspring/HexagonalSpringApplication.java b/src/main/java/com/hedza06/hexagonalspring/HexagonalSpringApplication.java new file mode 100644 index 0000000..96db198 --- /dev/null +++ b/src/main/java/com/hedza06/hexagonalspring/HexagonalSpringApplication.java @@ -0,0 +1,13 @@ +package com.hedza06.hexagonalspring; + +import org.springframework.boot.SpringApplication; +import org.springframework.boot.autoconfigure.SpringBootApplication; + +@SpringBootApplication +public class HexagonalSpringApplication { + + public static void main(String[] args) { + SpringApplication.run(HexagonalSpringApplication.class, args); + } + +} diff --git a/src/main/java/com/hedza06/hexagonalspring/config/RestTemplateConfiguration.java b/src/main/java/com/hedza06/hexagonalspring/config/RestTemplateConfiguration.java new file mode 100644 index 0000000..a15cdd8 --- /dev/null +++ b/src/main/java/com/hedza06/hexagonalspring/config/RestTemplateConfiguration.java @@ -0,0 +1,43 @@ +package com.hedza06.hexagonalspring.config; + +import org.apache.http.conn.ssl.SSLConnectionSocketFactory; +import org.apache.http.impl.client.CloseableHttpClient; +import org.apache.http.impl.client.HttpClients; +import org.apache.http.ssl.TrustStrategy; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.http.client.HttpComponentsClientHttpRequestFactory; +import org.springframework.web.client.RestTemplate; + +import javax.net.ssl.SSLContext; +import java.security.KeyManagementException; +import java.security.KeyStoreException; +import java.security.NoSuchAlgorithmException; +import java.security.cert.X509Certificate; + +@Configuration +public class RestTemplateConfiguration { + + public RestTemplate restTemplate() { + return new RestTemplate(); + } + + @Bean(name = "restHttpsTemplate") + public RestTemplate restHttpsTemplate() throws KeyStoreException, NoSuchAlgorithmException, KeyManagementException + { + TrustStrategy acceptingTrustStrategy = (X509Certificate[] chain, String authType) -> true; + SSLContext sslContext = org.apache.http.ssl.SSLContexts.custom() + .loadTrustMaterial(null, acceptingTrustStrategy) + .build(); + + SSLConnectionSocketFactory csf = new SSLConnectionSocketFactory(sslContext); + CloseableHttpClient httpClient = HttpClients.custom() + .setSSLSocketFactory(csf) + .build(); + + HttpComponentsClientHttpRequestFactory requestFactory = new HttpComponentsClientHttpRequestFactory(); + requestFactory.setHttpClient(httpClient); + + return new RestTemplate(requestFactory); + } +} diff --git a/src/main/java/com/hedza06/hexagonalspring/customer/adapter/persistence/CustomerAdapter.java b/src/main/java/com/hedza06/hexagonalspring/customer/adapter/persistence/CustomerAdapter.java new file mode 100644 index 0000000..ba39e8d --- /dev/null +++ b/src/main/java/com/hedza06/hexagonalspring/customer/adapter/persistence/CustomerAdapter.java @@ -0,0 +1,25 @@ +package com.hedza06.hexagonalspring.customer.adapter.persistence; + +import com.hedza06.hexagonalspring.customer.application.port.out.CustomerPort; +import com.hedza06.hexagonalspring.customer.domain.Customer; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Component; + +import java.util.List; + +@Component +@RequiredArgsConstructor +class CustomerAdapter implements CustomerPort { + + private final CustomerRepository customerRepository; + + @Override + public Customer save(Customer customer) { + return customerRepository.save(customer); + } + + @Override + public List findByFirstNameStartingWith(String pattern) { + return customerRepository.findByFirstNameStartingWith(pattern); + } +} diff --git a/src/main/java/com/hedza06/hexagonalspring/customer/adapter/persistence/CustomerRepository.java b/src/main/java/com/hedza06/hexagonalspring/customer/adapter/persistence/CustomerRepository.java new file mode 100644 index 0000000..dd9ac0e --- /dev/null +++ b/src/main/java/com/hedza06/hexagonalspring/customer/adapter/persistence/CustomerRepository.java @@ -0,0 +1,13 @@ +package com.hedza06.hexagonalspring.customer.adapter.persistence; + +import com.hedza06.hexagonalspring.customer.domain.Customer; +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.stereotype.Repository; + +import java.util.List; + +@Repository +public interface CustomerRepository extends JpaRepository +{ + List findByFirstNameStartingWith(String pattern); +} diff --git a/src/main/java/com/hedza06/hexagonalspring/customer/adapter/web/CustomerController.java b/src/main/java/com/hedza06/hexagonalspring/customer/adapter/web/CustomerController.java new file mode 100644 index 0000000..f5715ab --- /dev/null +++ b/src/main/java/com/hedza06/hexagonalspring/customer/adapter/web/CustomerController.java @@ -0,0 +1,37 @@ +package com.hedza06.hexagonalspring.customer.adapter.web; + +import com.hedza06.hexagonalspring.customer.application.port.in.CustomerUseCase; +import com.hedza06.hexagonalspring.customer.domain.Customer; +import lombok.RequiredArgsConstructor; +import org.springframework.http.HttpStatus; +import org.springframework.http.ResponseEntity; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PostMapping; +import org.springframework.web.bind.annotation.RequestBody; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RequestParam; +import org.springframework.web.bind.annotation.RestController; + +import java.util.List; + +@RestController +@RequiredArgsConstructor +@RequestMapping(value = "/customer") +class CustomerController { + + private final CustomerUseCase customerUseCase; + + @PostMapping + public ResponseEntity persist(@RequestBody Customer customer) + { + Customer persistedCustomer = customerUseCase.save(customer); + return new ResponseEntity<>(persistedCustomer, HttpStatus.CREATED); + } + + @GetMapping(value = "/by-first-name-starting-with") + public ResponseEntity> findByNameStartingWith(@RequestParam(value = "pattern") String pattern) + { + List customers = customerUseCase.findByFirstNameStartingWith(pattern); + return new ResponseEntity<>(customers, HttpStatus.OK); + } +} diff --git a/src/main/java/com/hedza06/hexagonalspring/customer/application/port/in/CustomerUseCase.java b/src/main/java/com/hedza06/hexagonalspring/customer/application/port/in/CustomerUseCase.java new file mode 100644 index 0000000..d4294cc --- /dev/null +++ b/src/main/java/com/hedza06/hexagonalspring/customer/application/port/in/CustomerUseCase.java @@ -0,0 +1,11 @@ +package com.hedza06.hexagonalspring.customer.application.port.in; + +import com.hedza06.hexagonalspring.customer.domain.Customer; + +import java.util.List; + +public interface CustomerUseCase +{ + Customer save(Customer customer); + List findByFirstNameStartingWith(String pattern); +} diff --git a/src/main/java/com/hedza06/hexagonalspring/customer/application/port/out/CustomerPort.java b/src/main/java/com/hedza06/hexagonalspring/customer/application/port/out/CustomerPort.java new file mode 100644 index 0000000..3f5354c --- /dev/null +++ b/src/main/java/com/hedza06/hexagonalspring/customer/application/port/out/CustomerPort.java @@ -0,0 +1,11 @@ +package com.hedza06.hexagonalspring.customer.application.port.out; + +import com.hedza06.hexagonalspring.customer.domain.Customer; + +import java.util.List; + +public interface CustomerPort +{ + Customer save(Customer customer); + List findByFirstNameStartingWith(String pattern); +} diff --git a/src/main/java/com/hedza06/hexagonalspring/customer/application/service/CustomerService.java b/src/main/java/com/hedza06/hexagonalspring/customer/application/service/CustomerService.java new file mode 100644 index 0000000..af8f022 --- /dev/null +++ b/src/main/java/com/hedza06/hexagonalspring/customer/application/service/CustomerService.java @@ -0,0 +1,28 @@ +package com.hedza06.hexagonalspring.customer.application.service; + +import com.hedza06.hexagonalspring.customer.application.port.in.CustomerUseCase; +import com.hedza06.hexagonalspring.customer.application.port.out.CustomerPort; +import com.hedza06.hexagonalspring.customer.domain.Customer; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.util.List; + +@Service +@Transactional +@RequiredArgsConstructor +public class CustomerService implements CustomerUseCase { + + private final CustomerPort customerPort; + + @Override + public Customer save(Customer customer) { + return customerPort.save(customer); + } + + @Override + public List findByFirstNameStartingWith(String pattern) { + return customerPort.findByFirstNameStartingWith(pattern); + } +} diff --git a/src/main/java/com/hedza06/hexagonalspring/customer/config/.gitkeep b/src/main/java/com/hedza06/hexagonalspring/customer/config/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/src/main/java/com/hedza06/hexagonalspring/customer/domain/Customer.java b/src/main/java/com/hedza06/hexagonalspring/customer/domain/Customer.java new file mode 100644 index 0000000..99fcab7 --- /dev/null +++ b/src/main/java/com/hedza06/hexagonalspring/customer/domain/Customer.java @@ -0,0 +1,39 @@ +package com.hedza06.hexagonalspring.customer.domain; + +import lombok.Data; +import lombok.NoArgsConstructor; + +import javax.persistence.Column; +import javax.persistence.Entity; +import javax.persistence.GeneratedValue; +import javax.persistence.GenerationType; +import javax.persistence.Id; +import javax.persistence.Table; +import javax.persistence.Temporal; +import javax.persistence.TemporalType; +import java.util.Date; + +@Data +@Entity +@NoArgsConstructor +@Table(name = "customer") +public class Customer { + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Integer id; + + @Column(name = "first_name") + private String firstName; + + @Column(name = "last_name") + private String lastName; + + @Column + private String address; + + @Column(name = "created_at") + @Temporal(TemporalType.TIMESTAMP) + private Date createdAt; + +} diff --git a/src/main/java/com/hedza06/hexagonalspring/customer/dto/.gitkeep b/src/main/java/com/hedza06/hexagonalspring/customer/dto/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/src/main/java/com/hedza06/hexagonalspring/customer/mapper/.gitkeep b/src/main/java/com/hedza06/hexagonalspring/customer/mapper/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/src/main/java/com/hedza06/hexagonalspring/customer/validator/.gitkeep b/src/main/java/com/hedza06/hexagonalspring/customer/validator/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/src/main/java/com/hedza06/hexagonalspring/product/adapter/api/ExternalProductAdapter.java b/src/main/java/com/hedza06/hexagonalspring/product/adapter/api/ExternalProductAdapter.java new file mode 100644 index 0000000..906a6c4 --- /dev/null +++ b/src/main/java/com/hedza06/hexagonalspring/product/adapter/api/ExternalProductAdapter.java @@ -0,0 +1,49 @@ +package com.hedza06.hexagonalspring.product.adapter.api; + +import com.hedza06.hexagonalspring.product.application.port.out.ExternalFakeProductPort; +import com.hedza06.hexagonalspring.product.dto.FakeProductDTO; +import lombok.RequiredArgsConstructor; +import lombok.extern.slf4j.Slf4j; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.core.ParameterizedTypeReference; +import org.springframework.http.HttpMethod; +import org.springframework.http.ResponseEntity; +import org.springframework.stereotype.Component; +import org.springframework.web.client.RestClientException; +import org.springframework.web.client.RestTemplate; + +import java.util.Collections; +import java.util.List; + +@Slf4j +@Component +@RequiredArgsConstructor +public class ExternalProductAdapter implements ExternalFakeProductPort { + + @Qualifier("restHttpsTemplate") + private final RestTemplate restTemplate; + + @Override + public List fetchAllFakeProducts() + { + log.info("Getting fake products from external API..."); + + String url = "https://fakestoreapi.com/products"; + try + { + ParameterizedTypeReference> typeReference = new ParameterizedTypeReference<>(){}; + ResponseEntity> responseEntity = restTemplate.exchange( + url, HttpMethod.GET, null, typeReference + ); + log.info("Http status code: {}", responseEntity.getStatusCodeValue()); + log.info("Sending back to client fetched fake products..."); + + return responseEntity.getBody(); + } + catch (RestClientException e) + { + log.error("Error occurred while fetching fake products. Error message: {}", e.getMessage()); + return Collections.emptyList(); + } + } +} diff --git a/src/main/java/com/hedza06/hexagonalspring/product/adapter/persistence/ProductAdapter.java b/src/main/java/com/hedza06/hexagonalspring/product/adapter/persistence/ProductAdapter.java new file mode 100644 index 0000000..ec942d7 --- /dev/null +++ b/src/main/java/com/hedza06/hexagonalspring/product/adapter/persistence/ProductAdapter.java @@ -0,0 +1,25 @@ +package com.hedza06.hexagonalspring.product.adapter.persistence; + +import com.hedza06.hexagonalspring.product.application.port.out.ProductPort; +import com.hedza06.hexagonalspring.product.domain.Product; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Component; + +import java.util.Optional; + +@Component +@RequiredArgsConstructor +public class ProductAdapter implements ProductPort { + + private final ProductRepository productRepository; + + @Override + public Product save(Product product) { + return productRepository.save(product); + } + + @Override + public Optional findById(Integer id) { + return productRepository.findById(id); + } +} diff --git a/src/main/java/com/hedza06/hexagonalspring/product/adapter/persistence/ProductRepository.java b/src/main/java/com/hedza06/hexagonalspring/product/adapter/persistence/ProductRepository.java new file mode 100644 index 0000000..d0e87fe --- /dev/null +++ b/src/main/java/com/hedza06/hexagonalspring/product/adapter/persistence/ProductRepository.java @@ -0,0 +1,8 @@ +package com.hedza06.hexagonalspring.product.adapter.persistence; + +import com.hedza06.hexagonalspring.product.domain.Product; +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.stereotype.Repository; + +@Repository +public interface ProductRepository extends JpaRepository { } diff --git a/src/main/java/com/hedza06/hexagonalspring/product/adapter/web/ProductController.java b/src/main/java/com/hedza06/hexagonalspring/product/adapter/web/ProductController.java new file mode 100644 index 0000000..1a00ba7 --- /dev/null +++ b/src/main/java/com/hedza06/hexagonalspring/product/adapter/web/ProductController.java @@ -0,0 +1,50 @@ +package com.hedza06.hexagonalspring.product.adapter.web; + +import com.hedza06.hexagonalspring.product.application.port.in.ExternalFakeProductUseCase; +import com.hedza06.hexagonalspring.product.application.port.in.ProductUseCase; +import com.hedza06.hexagonalspring.product.domain.Product; +import com.hedza06.hexagonalspring.product.dto.FakeProductDTO; +import lombok.RequiredArgsConstructor; +import org.springframework.http.HttpStatus; +import org.springframework.http.ResponseEntity; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PathVariable; +import org.springframework.web.bind.annotation.PostMapping; +import org.springframework.web.bind.annotation.RequestBody; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RestController; + +import java.util.List; +import java.util.Optional; + +@RestController +@RequiredArgsConstructor +@RequestMapping(value = "/product") +public class ProductController { + + private final ProductUseCase productUseCase; + private final ExternalFakeProductUseCase fakeProductUseCase; + + @PostMapping + public ResponseEntity persist(@RequestBody Product product) + { + Product persistedProduct = productUseCase.save(product); + return new ResponseEntity<>(persistedProduct, HttpStatus.CREATED); + } + + @GetMapping(value = "/{id}") + public ResponseEntity findOne(@PathVariable Integer id) + { + Optional optionalProduct = productUseCase.findById(id); + return optionalProduct + .map(product -> new ResponseEntity<>(product, HttpStatus.OK)) + .orElse(new ResponseEntity<>(HttpStatus.NOT_FOUND)); + } + + @GetMapping(value = "/fake") + public ResponseEntity> getFakeProducts() + { + List fakeProducts = fakeProductUseCase.fetchAllFakeProducts(); + return new ResponseEntity<>(fakeProducts, HttpStatus.OK); + } +} diff --git a/src/main/java/com/hedza06/hexagonalspring/product/application/port/in/ExternalFakeProductUseCase.java b/src/main/java/com/hedza06/hexagonalspring/product/application/port/in/ExternalFakeProductUseCase.java new file mode 100644 index 0000000..aff9067 --- /dev/null +++ b/src/main/java/com/hedza06/hexagonalspring/product/application/port/in/ExternalFakeProductUseCase.java @@ -0,0 +1,10 @@ +package com.hedza06.hexagonalspring.product.application.port.in; + +import com.hedza06.hexagonalspring.product.dto.FakeProductDTO; + +import java.util.List; + +public interface ExternalFakeProductUseCase +{ + List fetchAllFakeProducts(); +} diff --git a/src/main/java/com/hedza06/hexagonalspring/product/application/port/in/ProductUseCase.java b/src/main/java/com/hedza06/hexagonalspring/product/application/port/in/ProductUseCase.java new file mode 100644 index 0000000..56527a8 --- /dev/null +++ b/src/main/java/com/hedza06/hexagonalspring/product/application/port/in/ProductUseCase.java @@ -0,0 +1,11 @@ +package com.hedza06.hexagonalspring.product.application.port.in; + +import com.hedza06.hexagonalspring.product.domain.Product; + +import java.util.Optional; + +public interface ProductUseCase +{ + Product save(Product product); + Optional findById(Integer id); +} diff --git a/src/main/java/com/hedza06/hexagonalspring/product/application/port/out/ExternalFakeProductPort.java b/src/main/java/com/hedza06/hexagonalspring/product/application/port/out/ExternalFakeProductPort.java new file mode 100644 index 0000000..92d706b --- /dev/null +++ b/src/main/java/com/hedza06/hexagonalspring/product/application/port/out/ExternalFakeProductPort.java @@ -0,0 +1,10 @@ +package com.hedza06.hexagonalspring.product.application.port.out; + +import com.hedza06.hexagonalspring.product.dto.FakeProductDTO; + +import java.util.List; + +public interface ExternalFakeProductPort +{ + List fetchAllFakeProducts(); +} diff --git a/src/main/java/com/hedza06/hexagonalspring/product/application/port/out/ProductPort.java b/src/main/java/com/hedza06/hexagonalspring/product/application/port/out/ProductPort.java new file mode 100644 index 0000000..23d12fb --- /dev/null +++ b/src/main/java/com/hedza06/hexagonalspring/product/application/port/out/ProductPort.java @@ -0,0 +1,11 @@ +package com.hedza06.hexagonalspring.product.application.port.out; + +import com.hedza06.hexagonalspring.product.domain.Product; + +import java.util.Optional; + +public interface ProductPort +{ + Product save(Product product); + Optional findById(Integer id); +} diff --git a/src/main/java/com/hedza06/hexagonalspring/product/application/service/ProductService.java b/src/main/java/com/hedza06/hexagonalspring/product/application/service/ProductService.java new file mode 100644 index 0000000..1395d85 --- /dev/null +++ b/src/main/java/com/hedza06/hexagonalspring/product/application/service/ProductService.java @@ -0,0 +1,38 @@ +package com.hedza06.hexagonalspring.product.application.service; + +import com.hedza06.hexagonalspring.product.application.port.in.ExternalFakeProductUseCase; +import com.hedza06.hexagonalspring.product.application.port.in.ProductUseCase; +import com.hedza06.hexagonalspring.product.application.port.out.ExternalFakeProductPort; +import com.hedza06.hexagonalspring.product.application.port.out.ProductPort; +import com.hedza06.hexagonalspring.product.domain.Product; +import com.hedza06.hexagonalspring.product.dto.FakeProductDTO; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.util.List; +import java.util.Optional; + +@Service +@Transactional +@RequiredArgsConstructor +public class ProductService implements ProductUseCase, ExternalFakeProductUseCase { + + private final ProductPort productPort; + private final ExternalFakeProductPort fakeProductPort; + + @Override + public Product save(Product product) { + return productPort.save(product); + } + + @Override + public Optional findById(Integer id) { + return productPort.findById(id); + } + + @Override + public List fetchAllFakeProducts() { + return fakeProductPort.fetchAllFakeProducts(); + } +} diff --git a/src/main/java/com/hedza06/hexagonalspring/product/config/.gitkeep b/src/main/java/com/hedza06/hexagonalspring/product/config/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/src/main/java/com/hedza06/hexagonalspring/product/domain/Product.java b/src/main/java/com/hedza06/hexagonalspring/product/domain/Product.java new file mode 100644 index 0000000..509369f --- /dev/null +++ b/src/main/java/com/hedza06/hexagonalspring/product/domain/Product.java @@ -0,0 +1,44 @@ +package com.hedza06.hexagonalspring.product.domain; + +import com.hedza06.hexagonalspring.customer.domain.Customer; +import lombok.Data; +import lombok.NoArgsConstructor; + +import javax.persistence.Column; +import javax.persistence.Entity; +import javax.persistence.GeneratedValue; +import javax.persistence.GenerationType; +import javax.persistence.Id; +import javax.persistence.JoinColumn; +import javax.persistence.ManyToOne; +import javax.persistence.Table; +import javax.persistence.Temporal; +import javax.persistence.TemporalType; +import java.math.BigDecimal; +import java.util.Date; + +@Data +@Entity +@NoArgsConstructor +@Table(name = "product") +public class Product { + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Integer id; + + @Column(name = "catalog_name") + private String catalogName; + + @Column + private BigDecimal price; + + @Temporal(TemporalType.DATE) + @Column(name = "created_at") + private Date createdAt; + + @ManyToOne + @JoinColumn(name = "customer_id") + private Customer customer; + +} diff --git a/src/main/java/com/hedza06/hexagonalspring/product/dto/FakeProductDTO.java b/src/main/java/com/hedza06/hexagonalspring/product/dto/FakeProductDTO.java new file mode 100644 index 0000000..296f366 --- /dev/null +++ b/src/main/java/com/hedza06/hexagonalspring/product/dto/FakeProductDTO.java @@ -0,0 +1,18 @@ +package com.hedza06.hexagonalspring.product.dto; + +import lombok.Data; +import lombok.NoArgsConstructor; + +import java.math.BigDecimal; + +@Data +@NoArgsConstructor +public class FakeProductDTO { + + private Integer id; + private String title; + private BigDecimal price; + private String description; + private String category; + +} diff --git a/src/main/java/com/hedza06/hexagonalspring/product/dto/ProductDTO.java b/src/main/java/com/hedza06/hexagonalspring/product/dto/ProductDTO.java new file mode 100644 index 0000000..7af6d00 --- /dev/null +++ b/src/main/java/com/hedza06/hexagonalspring/product/dto/ProductDTO.java @@ -0,0 +1,18 @@ +package com.hedza06.hexagonalspring.product.dto; + +import lombok.Data; +import lombok.NoArgsConstructor; + +import java.math.BigDecimal; +import java.util.Date; + +@Data +@NoArgsConstructor +public class ProductDTO { + + private Integer id; + private String catalogName; + private BigDecimal price; + private Date createdAt; + +} diff --git a/src/main/java/com/hedza06/hexagonalspring/product/mapper/.gitkeep b/src/main/java/com/hedza06/hexagonalspring/product/mapper/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/src/main/java/com/hedza06/hexagonalspring/product/validator/.gitkeep b/src/main/java/com/hedza06/hexagonalspring/product/validator/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/src/main/resources/application.yml b/src/main/resources/application.yml new file mode 100644 index 0000000..1d15c66 --- /dev/null +++ b/src/main/resources/application.yml @@ -0,0 +1,43 @@ +spring: + # Jackson Configuration + jackson: + serialization.indent_output: true + # Datasource Configuration + datasource: + name: MySQL RDBMS Database Connection + driver-class-name: com.mysql.jdbc.Driver + # driver-class-name: com.mysql.cj.jdbc.Driver + url: jdbc:mysql://localhost:3306/hex_db?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=CET&allowPublicKeyRetrieval=true + username: root + password: root + # Hikari CP Configuration + hikari: + data-source-properties: + cachePrepStmts: true + prepStmtCacheSize: 250 + prepStmtCacheSqlLimit: 2048 + useServerPrepStmts: true + # Java Persistence API Configuration + jpa: + database-platform: org.hibernate.dialect.MySQLInnoDBDialect + database: MYSQL + show-sql: true + open-in-view: false + # Hibernate Properties + properties: + hibernate.cache.use_second_level_cache: false + hibernate.cache.use_query_cache: false + hibernate.generate_statistics: false + hibernate.show_sql: true + hibernate.SQL: true +# API context path configuration +server: + servlet: + context-path: /api + +# Logging configuration +logging: + level: + com.hedza06.hexagonalspring: DEBUG + +debug: false \ No newline at end of file diff --git a/src/main/resources/data/hex-schema.png b/src/main/resources/data/hex-schema.png new file mode 100644 index 0000000..5ffcb9f Binary files /dev/null and b/src/main/resources/data/hex-schema.png differ diff --git a/src/main/resources/data/hexagonal-apis.postman_collection.json b/src/main/resources/data/hexagonal-apis.postman_collection.json new file mode 100644 index 0000000..c4a4a5f --- /dev/null +++ b/src/main/resources/data/hexagonal-apis.postman_collection.json @@ -0,0 +1,136 @@ +{ + "info": { + "_postman_id": "169461dd-f7db-45e9-a9a7-9fe1fbaf3bd3", + "name": "hexagonal-apis", + "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" + }, + "item": [ + { + "name": "Get customers by first name term", + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "http://localhost:8080/api/customer/by-first-name-starting-with?pattern=John", + "protocol": "http", + "host": [ + "localhost" + ], + "port": "8080", + "path": [ + "api", + "customer", + "by-first-name-starting-with" + ], + "query": [ + { + "key": "pattern", + "value": "John" + } + ] + } + }, + "response": [] + }, + { + "name": "Persist Customer", + "request": { + "method": "POST", + "header": [], + "body": { + "mode": "raw", + "raw": "{\n \"firstName\": \"Marc\",\n \"lastName\": \"Anothony\",\n \"address\": \"Test address\",\n \"createdAt\": \"2021-01-01T12:12:47.105+01:00\"\n}", + "options": { + "raw": { + "language": "json" + } + } + }, + "url": { + "raw": "http://localhost:8080/api/customer", + "protocol": "http", + "host": [ + "localhost" + ], + "port": "8080", + "path": [ + "api", + "customer" + ] + } + }, + "response": [] + }, + { + "name": "Find product by id", + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "http://localhost:8080/api/product/1", + "protocol": "http", + "host": [ + "localhost" + ], + "port": "8080", + "path": [ + "api", + "product", + "1" + ] + } + }, + "response": [] + }, + { + "name": "Persist Product", + "request": { + "method": "POST", + "header": [], + "body": { + "mode": "raw", + "raw": "{\n \"catalogName\": \"Test catalog name 1\",\n \"price\": 100.00,\n \"createdAt\": \"2021-02-02T10:12:00.97+02:00\",\n \"customer\": {\n \"id\": 1\n }\n}", + "options": { + "raw": { + "language": "json" + } + } + }, + "url": { + "raw": "http://localhost:8080/api/product", + "protocol": "http", + "host": [ + "localhost" + ], + "port": "8080", + "path": [ + "api", + "product" + ] + } + }, + "response": [] + }, + { + "name": "Get fake products", + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "http://localhost:8080/api/product/fake", + "protocol": "http", + "host": [ + "localhost" + ], + "port": "8080", + "path": [ + "api", + "product", + "fake" + ] + } + }, + "response": [] + } + ] +} \ No newline at end of file diff --git a/src/main/resources/data/schema_and_data.sql b/src/main/resources/data/schema_and_data.sql new file mode 100644 index 0000000..a80154c --- /dev/null +++ b/src/main/resources/data/schema_and_data.sql @@ -0,0 +1,35 @@ +-- DATABASE +CREATE DATABASE IF NOT EXISTS hex_db; +USE hex_db; + +-- TABLES +CREATE TABLE `customer` ( + `id` INT UNSIGNED NOT NULL AUTO_INCREMENT, + `first_name` VARCHAR(32) NOT NULL, + `last_name` VARCHAR(64) NOT NULL, + `address` VARCHAR(255) NULL, + `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + PRIMARY KEY (`id`)); + +CREATE TABLE `product` ( + `id` INT UNSIGNED NOT NULL AUTO_INCREMENT, + `customer_id` INT UNSIGNED NOT NULL, + `catalog_name` VARCHAR(255) NOT NULL, + `price` DECIMAL(15,2) NOT NULL, + `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + PRIMARY KEY (`id`), + INDEX `fk_product_customer_id_key_idx` (`customer_id` ASC), + CONSTRAINT `fk_product_customer_id_key` + FOREIGN KEY (`customer_id`) + REFERENCES `hex_db`.`customer` (`id`) + ON DELETE NO ACTION + ON UPDATE NO ACTION); + +-- SEEDS +INSERT INTO `customer` (first_name, last_name, address) VALUES +('Heril', 'Muratovic', 'Test address 01'), +('John', 'Wick', '121 Mill Neck in Long Island, NY'); + +INSERT INTO `product` (customer_id, catalog_name, price) VALUES +((SELECT id FROM customer WHERE first_name = 'Heril' AND last_name = 'Muratovic' LIMIT 1), 'SIG-Sauer P320', 1560.12), +((SELECT id FROM customer WHERE first_name = 'John' AND last_name = 'Wick' LIMIT 1), 'Coharie Arms CA-415', 3500.00); \ No newline at end of file diff --git a/src/test/java/com/hedza06/hexagonalspring/HexagonalSpringApplicationTests.java b/src/test/java/com/hedza06/hexagonalspring/HexagonalSpringApplicationTests.java new file mode 100644 index 0000000..a1c8efd --- /dev/null +++ b/src/test/java/com/hedza06/hexagonalspring/HexagonalSpringApplicationTests.java @@ -0,0 +1,13 @@ +package com.hedza06.hexagonalspring; + +import org.junit.jupiter.api.Test; +import org.springframework.boot.test.context.SpringBootTest; + +@SpringBootTest +class HexagonalSpringApplicationTests { + + @Test + void contextLoads() { + } + +}