├── .gitignore ├── .mvn └── wrapper │ ├── maven-wrapper.jar │ └── maven-wrapper.properties ├── README.md ├── mvnw ├── mvnw.cmd ├── pom.xml └── src ├── main ├── java │ └── com │ │ └── exagonal │ │ └── tasks │ │ ├── TasksApplication.java │ │ ├── application │ │ ├── services │ │ │ └── TaskService.java │ │ └── usecases │ │ │ ├── CreateTaskUseCaseImpl.java │ │ │ ├── DeleteTaskUseCaseImpl.java │ │ │ ├── GetAdditionalTaskInfoUseCaseImpl.java │ │ │ ├── RetrieveTaskUseCaseImpl.java │ │ │ └── UpdateTaskUseCaseImpl.java │ │ ├── domain │ │ ├── model │ │ │ ├── AdditionalTaskInfo.java │ │ │ └── Task.java │ │ └── ports │ │ │ ├── in │ │ │ ├── CreateTaskUseCase.java │ │ │ ├── DeleteTaskUseCase.java │ │ │ ├── GetAdditionalTaskInfoUseCase.java │ │ │ ├── RetrieveTaskUseCase.java │ │ │ └── UpdateTaskUseCase.java │ │ │ └── out │ │ │ ├── ExternalServicePort.java │ │ │ └── TaskRepositoryPort.java │ │ └── infrastructure │ │ ├── adapters │ │ └── ExternalServiceAdapter.java │ │ ├── config │ │ └── ApplicationConfig.java │ │ ├── controllers │ │ └── TaskController.java │ │ ├── entities │ │ └── TaskEntity.java │ │ └── repositories │ │ ├── JpaTaskRepository.java │ │ └── JpaTaskRepositoryAdapter.java └── resources │ └── application.properties └── test └── java └── com └── exagonal └── tasks └── TasksApplicationTests.java /.gitignore: -------------------------------------------------------------------------------- 1 | HELP.md 2 | target/ 3 | !.mvn/wrapper/maven-wrapper.jar 4 | !**/src/main/**/target/ 5 | !**/src/test/**/target/ 6 | 7 | ### STS ### 8 | .apt_generated 9 | .classpath 10 | .factorypath 11 | .project 12 | .settings 13 | .springBeans 14 | .sts4-cache 15 | 16 | ### IntelliJ IDEA ### 17 | .idea 18 | *.iws 19 | *.iml 20 | *.ipr 21 | 22 | ### NetBeans ### 23 | /nbproject/private/ 24 | /nbbuild/ 25 | /dist/ 26 | /nbdist/ 27 | /.nb-gradle/ 28 | build/ 29 | !**/src/main/**/build/ 30 | !**/src/test/**/build/ 31 | 32 | ### VS Code ### 33 | .vscode/ 34 | -------------------------------------------------------------------------------- /.mvn/wrapper/maven-wrapper.jar: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/DanielEspanadero/arquitectura-hexagonal-java/3b2cdc85e24c9a5743005db9a7d6500a32dcd9cd/.mvn/wrapper/maven-wrapper.jar -------------------------------------------------------------------------------- /.mvn/wrapper/maven-wrapper.properties: -------------------------------------------------------------------------------- 1 | # Licensed to the Apache Software Foundation (ASF) under one 2 | # or more contributor license agreements. See the NOTICE file 3 | # distributed with this work for additional information 4 | # regarding copyright ownership. The ASF licenses this file 5 | # to you under the Apache License, Version 2.0 (the 6 | # "License"); you may not use this file except in compliance 7 | # with the License. You may obtain a copy of the License at 8 | # 9 | # https://www.apache.org/licenses/LICENSE-2.0 10 | # 11 | # Unless required by applicable law or agreed to in writing, 12 | # software distributed under the License is distributed on an 13 | # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 14 | # KIND, either express or implied. See the License for the 15 | # specific language governing permissions and limitations 16 | # under the License. 17 | distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.8.7/apache-maven-3.8.7-bin.zip 18 | wrapperUrl=https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.1.1/maven-wrapper-3.1.1.jar 19 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Arquitectura hexaginal - Aplicación de gestión de tareas 2 | 3 | Esta aplicación es un ejemplo de un sistema de gestión de tareas que sigue la arquitectura hexagonal. La aplicación permite crear, leer, actualizar y eliminar tareas, así como obtener información adicional de una tarea a través de una API externa. 4 | 5 | ## Arquitectura hexagonal 6 | 7 | La arquitectura hexagonal, también conocida como Ports and Adapters, es un patrón de diseño que busca mantener una separación clara de las responsabilidades en una aplicación, facilitando la adaptabilidad, escalabilidad y mantenibilidad del software. La arquitectura se organiza en tres capas principales: 8 | 9 | Dominio: Esta capa contiene las entidades del dominio, que representan los conceptos clave del negocio y sus relaciones, así como la lógica de negocio asociada. Estas entidades son independientes de la infraestructura y la implementación, lo que permite centrarse en las reglas y restricciones del negocio. 10 | 11 | Aplicación: Esta capa contiene los casos de uso, que representan las acciones o funcionalidades que la aplicación puede realizar. Los casos de uso coordinan la comunicación entre los puertos de entrada (interfaces que representan las acciones que se pueden realizar desde el exterior) y los puertos de salida (interfaces que representan las acciones que la aplicación puede realizar hacia el exterior, como interactuar con bases de datos o servicios externos). 12 | 13 | Infraestructura: Esta capa contiene los adaptadores y la implementación de los puertos de salida, así como la configuración y la interacción con servicios externos. Los adaptadores son responsables de convertir las solicitudes externas en llamadas a los casos de uso y de convertir las respuestas de los casos de uso en respuestas comprensibles para los sistemas externos. 14 | 15 | La arquitectura hexagonal se adhiere a los principios SOLID: 16 | 17 | **Single Responsibility Principle (SRP):** Cada capa tiene una responsabilidad única y bien definida, lo que evita la mezcla de responsabilidades y facilita el mantenimiento del código. 18 | 19 | **Open/Closed Principle (OCP):** Las entidades y los casos de uso están abiertos a la extensión pero cerrados a la modificación. Si se necesita agregar una nueva funcionalidad, se puede hacer extendiendo los casos de uso o creando nuevos adaptadores sin modificar el código existente. 20 | 21 | **Liskov Substitution Principle (LSP):** Los adaptadores y las implementaciones de los puertos deben ser sustituibles sin afectar el comportamiento del sistema, lo que permite cambiar fácilmente entre diferentes implementaciones de infraestructura o servicios externos. 22 | 23 | **Interface Segregation Principle (ISP):** Los puertos de entrada y salida definen interfaces pequeñas y específicas para cada funcionalidad, lo que facilita la implementación de adaptadores y evita depender de interfaces innecesariamente grandes. 24 | 25 | **Dependency Inversion Principle (DIP):** Las dependencias entre las capas se invierten mediante la inyección de dependencias, lo que permite a las capas de dominio y aplicación depender de abstracciones en lugar de implementaciones concretas. 26 | 27 | ## Rutas de la API 28 | 29 | A continuación se enumeran las rutas de la API con sus métodos HTTP correspondientes y ejemplos de entrada: 30 | 31 | 1. Crear una tarea 32 | Método: POST 33 | Ruta: /api/tasks 34 | Input: JSON con la información de la tarea (title, description y completed) 35 | 36 | ``` 37 | { 38 | "title": "Ejemplo de título", 39 | "description": "Ejemplo de descripción", 40 | "completed": false 41 | } 42 | ``` 43 | 44 | 2. Obtener una tarea por ID 45 | Método: GET 46 | Ruta: /api/tasks/{taskId} 47 | Input: taskId en la ruta (reemplazar {taskId} con el ID de la tarea que deseas obtener) 48 | 49 | 3. Obtener todas las tareas 50 | Método: GET 51 | Ruta: /api/tasks 52 | 53 | 4. Actualizar una tarea 54 | Método: PUT 55 | Ruta: /api/tasks/{taskId} 56 | Input: taskId en la ruta (reemplazar {taskId} con el ID de la tarea que deseas actualizar) y JSON con la información actualizada de la tarea (title, description y completed) 57 | 58 | ``` 59 | { 60 | "title": "Nuevo título", 61 | "description": "Nueva descripción", 62 | "completed": true 63 | } 64 | ``` 65 | 66 | 5. Eliminar una tarea por ID 67 | Método: DELETE 68 | Ruta: /api/tasks/{taskId} 69 | Input: taskId en la ruta (reemplazar {taskId} con el ID de la tarea que deseas eliminar) 70 | 71 | 6. Obtener información adicional de una tarea 72 | Método: GET 73 | Ruta: /api/tasks/{taskId}/additional-info 74 | Input: taskId en la ruta (reemplazar {taskId} con el ID de la tarea para la que deseas obtener información adicional) 75 | Pruebas 76 | Puedes usar herramientas como Postman o curl para probar estas rutas. Asegúrate de que la aplicación esté en ejecución antes de realizar las pruebas. 77 | -------------------------------------------------------------------------------- /mvnw: -------------------------------------------------------------------------------- 1 | #!/bin/sh 2 | # ---------------------------------------------------------------------------- 3 | # Licensed to the Apache Software Foundation (ASF) under one 4 | # or more contributor license agreements. See the NOTICE file 5 | # distributed with this work for additional information 6 | # regarding copyright ownership. The ASF licenses this file 7 | # to you under the Apache License, Version 2.0 (the 8 | # "License"); you may not use this file except in compliance 9 | # with the License. You may obtain a copy of the License at 10 | # 11 | # https://www.apache.org/licenses/LICENSE-2.0 12 | # 13 | # Unless required by applicable law or agreed to in writing, 14 | # software distributed under the License is distributed on an 15 | # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 16 | # KIND, either express or implied. See the License for the 17 | # specific language governing permissions and limitations 18 | # under the License. 19 | # ---------------------------------------------------------------------------- 20 | 21 | # ---------------------------------------------------------------------------- 22 | # Maven Start Up Batch script 23 | # 24 | # Required ENV vars: 25 | # ------------------ 26 | # JAVA_HOME - location of a JDK home dir 27 | # 28 | # Optional ENV vars 29 | # ----------------- 30 | # M2_HOME - location of maven2's installed home dir 31 | # MAVEN_OPTS - parameters passed to the Java VM when running Maven 32 | # e.g. to debug Maven itself, use 33 | # set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000 34 | # MAVEN_SKIP_RC - flag to disable loading of mavenrc files 35 | # ---------------------------------------------------------------------------- 36 | 37 | if [ -z "$MAVEN_SKIP_RC" ] ; then 38 | 39 | if [ -f /usr/local/etc/mavenrc ] ; then 40 | . /usr/local/etc/mavenrc 41 | fi 42 | 43 | if [ -f /etc/mavenrc ] ; then 44 | . /etc/mavenrc 45 | fi 46 | 47 | if [ -f "$HOME/.mavenrc" ] ; then 48 | . "$HOME/.mavenrc" 49 | fi 50 | 51 | fi 52 | 53 | # OS specific support. $var _must_ be set to either true or false. 54 | cygwin=false; 55 | darwin=false; 56 | mingw=false 57 | case "`uname`" in 58 | CYGWIN*) cygwin=true ;; 59 | MINGW*) mingw=true;; 60 | Darwin*) darwin=true 61 | # Use /usr/libexec/java_home if available, otherwise fall back to /Library/Java/Home 62 | # See https://developer.apple.com/library/mac/qa/qa1170/_index.html 63 | if [ -z "$JAVA_HOME" ]; then 64 | if [ -x "/usr/libexec/java_home" ]; then 65 | export JAVA_HOME="`/usr/libexec/java_home`" 66 | else 67 | export JAVA_HOME="/Library/Java/Home" 68 | fi 69 | fi 70 | ;; 71 | esac 72 | 73 | if [ -z "$JAVA_HOME" ] ; then 74 | if [ -r /etc/gentoo-release ] ; then 75 | JAVA_HOME=`java-config --jre-home` 76 | fi 77 | fi 78 | 79 | if [ -z "$M2_HOME" ] ; then 80 | ## resolve links - $0 may be a link to maven's home 81 | PRG="$0" 82 | 83 | # need this for relative symlinks 84 | while [ -h "$PRG" ] ; do 85 | ls=`ls -ld "$PRG"` 86 | link=`expr "$ls" : '.*-> \(.*\)$'` 87 | if expr "$link" : '/.*' > /dev/null; then 88 | PRG="$link" 89 | else 90 | PRG="`dirname "$PRG"`/$link" 91 | fi 92 | done 93 | 94 | saveddir=`pwd` 95 | 96 | M2_HOME=`dirname "$PRG"`/.. 97 | 98 | # make it fully qualified 99 | M2_HOME=`cd "$M2_HOME" && pwd` 100 | 101 | cd "$saveddir" 102 | # echo Using m2 at $M2_HOME 103 | fi 104 | 105 | # For Cygwin, ensure paths are in UNIX format before anything is touched 106 | if $cygwin ; then 107 | [ -n "$M2_HOME" ] && 108 | M2_HOME=`cygpath --unix "$M2_HOME"` 109 | [ -n "$JAVA_HOME" ] && 110 | JAVA_HOME=`cygpath --unix "$JAVA_HOME"` 111 | [ -n "$CLASSPATH" ] && 112 | CLASSPATH=`cygpath --path --unix "$CLASSPATH"` 113 | fi 114 | 115 | # For Mingw, ensure paths are in UNIX format before anything is touched 116 | if $mingw ; then 117 | [ -n "$M2_HOME" ] && 118 | M2_HOME="`(cd "$M2_HOME"; pwd)`" 119 | [ -n "$JAVA_HOME" ] && 120 | JAVA_HOME="`(cd "$JAVA_HOME"; pwd)`" 121 | fi 122 | 123 | if [ -z "$JAVA_HOME" ]; then 124 | javaExecutable="`which javac`" 125 | if [ -n "$javaExecutable" ] && ! [ "`expr \"$javaExecutable\" : '\([^ ]*\)'`" = "no" ]; then 126 | # readlink(1) is not available as standard on Solaris 10. 127 | readLink=`which readlink` 128 | if [ ! `expr "$readLink" : '\([^ ]*\)'` = "no" ]; then 129 | if $darwin ; then 130 | javaHome="`dirname \"$javaExecutable\"`" 131 | javaExecutable="`cd \"$javaHome\" && pwd -P`/javac" 132 | else 133 | javaExecutable="`readlink -f \"$javaExecutable\"`" 134 | fi 135 | javaHome="`dirname \"$javaExecutable\"`" 136 | javaHome=`expr "$javaHome" : '\(.*\)/bin'` 137 | JAVA_HOME="$javaHome" 138 | export JAVA_HOME 139 | fi 140 | fi 141 | fi 142 | 143 | if [ -z "$JAVACMD" ] ; then 144 | if [ -n "$JAVA_HOME" ] ; then 145 | if [ -x "$JAVA_HOME/jre/sh/java" ] ; then 146 | # IBM's JDK on AIX uses strange locations for the executables 147 | JAVACMD="$JAVA_HOME/jre/sh/java" 148 | else 149 | JAVACMD="$JAVA_HOME/bin/java" 150 | fi 151 | else 152 | JAVACMD="`\\unset -f command; \\command -v java`" 153 | fi 154 | fi 155 | 156 | if [ ! -x "$JAVACMD" ] ; then 157 | echo "Error: JAVA_HOME is not defined correctly." >&2 158 | echo " We cannot execute $JAVACMD" >&2 159 | exit 1 160 | fi 161 | 162 | if [ -z "$JAVA_HOME" ] ; then 163 | echo "Warning: JAVA_HOME environment variable is not set." 164 | fi 165 | 166 | CLASSWORLDS_LAUNCHER=org.codehaus.plexus.classworlds.launcher.Launcher 167 | 168 | # traverses directory structure from process work directory to filesystem root 169 | # first directory with .mvn subdirectory is considered project base directory 170 | find_maven_basedir() { 171 | 172 | if [ -z "$1" ] 173 | then 174 | echo "Path not specified to find_maven_basedir" 175 | return 1 176 | fi 177 | 178 | basedir="$1" 179 | wdir="$1" 180 | while [ "$wdir" != '/' ] ; do 181 | if [ -d "$wdir"/.mvn ] ; then 182 | basedir=$wdir 183 | break 184 | fi 185 | # workaround for JBEAP-8937 (on Solaris 10/Sparc) 186 | if [ -d "${wdir}" ]; then 187 | wdir=`cd "$wdir/.."; pwd` 188 | fi 189 | # end of workaround 190 | done 191 | echo "${basedir}" 192 | } 193 | 194 | # concatenates all lines of a file 195 | concat_lines() { 196 | if [ -f "$1" ]; then 197 | echo "$(tr -s '\n' ' ' < "$1")" 198 | fi 199 | } 200 | 201 | BASE_DIR=`find_maven_basedir "$(pwd)"` 202 | if [ -z "$BASE_DIR" ]; then 203 | exit 1; 204 | fi 205 | 206 | ########################################################################################## 207 | # Extension to allow automatically downloading the maven-wrapper.jar from Maven-central 208 | # This allows using the maven wrapper in projects that prohibit checking in binary data. 209 | ########################################################################################## 210 | if [ -r "$BASE_DIR/.mvn/wrapper/maven-wrapper.jar" ]; then 211 | if [ "$MVNW_VERBOSE" = true ]; then 212 | echo "Found .mvn/wrapper/maven-wrapper.jar" 213 | fi 214 | else 215 | if [ "$MVNW_VERBOSE" = true ]; then 216 | echo "Couldn't find .mvn/wrapper/maven-wrapper.jar, downloading it ..." 217 | fi 218 | if [ -n "$MVNW_REPOURL" ]; then 219 | jarUrl="$MVNW_REPOURL/org/apache/maven/wrapper/maven-wrapper/3.1.0/maven-wrapper-3.1.0.jar" 220 | else 221 | jarUrl="https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.1.0/maven-wrapper-3.1.0.jar" 222 | fi 223 | while IFS="=" read key value; do 224 | case "$key" in (wrapperUrl) jarUrl="$value"; break ;; 225 | esac 226 | done < "$BASE_DIR/.mvn/wrapper/maven-wrapper.properties" 227 | if [ "$MVNW_VERBOSE" = true ]; then 228 | echo "Downloading from: $jarUrl" 229 | fi 230 | wrapperJarPath="$BASE_DIR/.mvn/wrapper/maven-wrapper.jar" 231 | if $cygwin; then 232 | wrapperJarPath=`cygpath --path --windows "$wrapperJarPath"` 233 | fi 234 | 235 | if command -v wget > /dev/null; then 236 | if [ "$MVNW_VERBOSE" = true ]; then 237 | echo "Found wget ... using wget" 238 | fi 239 | if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then 240 | wget "$jarUrl" -O "$wrapperJarPath" || rm -f "$wrapperJarPath" 241 | else 242 | wget --http-user=$MVNW_USERNAME --http-password=$MVNW_PASSWORD "$jarUrl" -O "$wrapperJarPath" || rm -f "$wrapperJarPath" 243 | fi 244 | elif command -v curl > /dev/null; then 245 | if [ "$MVNW_VERBOSE" = true ]; then 246 | echo "Found curl ... using curl" 247 | fi 248 | if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then 249 | curl -o "$wrapperJarPath" "$jarUrl" -f 250 | else 251 | curl --user $MVNW_USERNAME:$MVNW_PASSWORD -o "$wrapperJarPath" "$jarUrl" -f 252 | fi 253 | 254 | else 255 | if [ "$MVNW_VERBOSE" = true ]; then 256 | echo "Falling back to using Java to download" 257 | fi 258 | javaClass="$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.java" 259 | # For Cygwin, switch paths to Windows format before running javac 260 | if $cygwin; then 261 | javaClass=`cygpath --path --windows "$javaClass"` 262 | fi 263 | if [ -e "$javaClass" ]; then 264 | if [ ! -e "$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.class" ]; then 265 | if [ "$MVNW_VERBOSE" = true ]; then 266 | echo " - Compiling MavenWrapperDownloader.java ..." 267 | fi 268 | # Compiling the Java class 269 | ("$JAVA_HOME/bin/javac" "$javaClass") 270 | fi 271 | if [ -e "$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.class" ]; then 272 | # Running the downloader 273 | if [ "$MVNW_VERBOSE" = true ]; then 274 | echo " - Running MavenWrapperDownloader.java ..." 275 | fi 276 | ("$JAVA_HOME/bin/java" -cp .mvn/wrapper MavenWrapperDownloader "$MAVEN_PROJECTBASEDIR") 277 | fi 278 | fi 279 | fi 280 | fi 281 | ########################################################################################## 282 | # End of extension 283 | ########################################################################################## 284 | 285 | export MAVEN_PROJECTBASEDIR=${MAVEN_BASEDIR:-"$BASE_DIR"} 286 | if [ "$MVNW_VERBOSE" = true ]; then 287 | echo $MAVEN_PROJECTBASEDIR 288 | fi 289 | MAVEN_OPTS="$(concat_lines "$MAVEN_PROJECTBASEDIR/.mvn/jvm.config") $MAVEN_OPTS" 290 | 291 | # For Cygwin, switch paths to Windows format before running java 292 | if $cygwin; then 293 | [ -n "$M2_HOME" ] && 294 | M2_HOME=`cygpath --path --windows "$M2_HOME"` 295 | [ -n "$JAVA_HOME" ] && 296 | JAVA_HOME=`cygpath --path --windows "$JAVA_HOME"` 297 | [ -n "$CLASSPATH" ] && 298 | CLASSPATH=`cygpath --path --windows "$CLASSPATH"` 299 | [ -n "$MAVEN_PROJECTBASEDIR" ] && 300 | MAVEN_PROJECTBASEDIR=`cygpath --path --windows "$MAVEN_PROJECTBASEDIR"` 301 | fi 302 | 303 | # Provide a "standardized" way to retrieve the CLI args that will 304 | # work with both Windows and non-Windows executions. 305 | MAVEN_CMD_LINE_ARGS="$MAVEN_CONFIG $@" 306 | export MAVEN_CMD_LINE_ARGS 307 | 308 | WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain 309 | 310 | exec "$JAVACMD" \ 311 | $MAVEN_OPTS \ 312 | $MAVEN_DEBUG_OPTS \ 313 | -classpath "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar" \ 314 | "-Dmaven.home=${M2_HOME}" \ 315 | "-Dmaven.multiModuleProjectDirectory=${MAVEN_PROJECTBASEDIR}" \ 316 | ${WRAPPER_LAUNCHER} $MAVEN_CONFIG "$@" 317 | -------------------------------------------------------------------------------- /mvnw.cmd: -------------------------------------------------------------------------------- 1 | @REM ---------------------------------------------------------------------------- 2 | @REM Licensed to the Apache Software Foundation (ASF) under one 3 | @REM or more contributor license agreements. See the NOTICE file 4 | @REM distributed with this work for additional information 5 | @REM regarding copyright ownership. The ASF licenses this file 6 | @REM to you under the Apache License, Version 2.0 (the 7 | @REM "License"); you may not use this file except in compliance 8 | @REM with the License. You may obtain a copy of the License at 9 | @REM 10 | @REM https://www.apache.org/licenses/LICENSE-2.0 11 | @REM 12 | @REM Unless required by applicable law or agreed to in writing, 13 | @REM software distributed under the License is distributed on an 14 | @REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 15 | @REM KIND, either express or implied. See the License for the 16 | @REM specific language governing permissions and limitations 17 | @REM under the License. 18 | @REM ---------------------------------------------------------------------------- 19 | 20 | @REM ---------------------------------------------------------------------------- 21 | @REM Maven Start Up Batch script 22 | @REM 23 | @REM Required ENV vars: 24 | @REM JAVA_HOME - location of a JDK home dir 25 | @REM 26 | @REM Optional ENV vars 27 | @REM M2_HOME - location of maven2's installed home dir 28 | @REM MAVEN_BATCH_ECHO - set to 'on' to enable the echoing of the batch commands 29 | @REM MAVEN_BATCH_PAUSE - set to 'on' to wait for a keystroke before ending 30 | @REM MAVEN_OPTS - parameters passed to the Java VM when running Maven 31 | @REM e.g. to debug Maven itself, use 32 | @REM set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000 33 | @REM MAVEN_SKIP_RC - flag to disable loading of mavenrc files 34 | @REM ---------------------------------------------------------------------------- 35 | 36 | @REM Begin all REM lines with '@' in case MAVEN_BATCH_ECHO is 'on' 37 | @echo off 38 | @REM set title of command window 39 | title %0 40 | @REM enable echoing by setting MAVEN_BATCH_ECHO to 'on' 41 | @if "%MAVEN_BATCH_ECHO%" == "on" echo %MAVEN_BATCH_ECHO% 42 | 43 | @REM set %HOME% to equivalent of $HOME 44 | if "%HOME%" == "" (set "HOME=%HOMEDRIVE%%HOMEPATH%") 45 | 46 | @REM Execute a user defined script before this one 47 | if not "%MAVEN_SKIP_RC%" == "" goto skipRcPre 48 | @REM check for pre script, once with legacy .bat ending and once with .cmd ending 49 | if exist "%USERPROFILE%\mavenrc_pre.bat" call "%USERPROFILE%\mavenrc_pre.bat" %* 50 | if exist "%USERPROFILE%\mavenrc_pre.cmd" call "%USERPROFILE%\mavenrc_pre.cmd" %* 51 | :skipRcPre 52 | 53 | @setlocal 54 | 55 | set ERROR_CODE=0 56 | 57 | @REM To isolate internal variables from possible post scripts, we use another setlocal 58 | @setlocal 59 | 60 | @REM ==== START VALIDATION ==== 61 | if not "%JAVA_HOME%" == "" goto OkJHome 62 | 63 | echo. 64 | echo Error: JAVA_HOME not found in your environment. >&2 65 | echo Please set the JAVA_HOME variable in your environment to match the >&2 66 | echo location of your Java installation. >&2 67 | echo. 68 | goto error 69 | 70 | :OkJHome 71 | if exist "%JAVA_HOME%\bin\java.exe" goto init 72 | 73 | echo. 74 | echo Error: JAVA_HOME is set to an invalid directory. >&2 75 | echo JAVA_HOME = "%JAVA_HOME%" >&2 76 | echo Please set the JAVA_HOME variable in your environment to match the >&2 77 | echo location of your Java installation. >&2 78 | echo. 79 | goto error 80 | 81 | @REM ==== END VALIDATION ==== 82 | 83 | :init 84 | 85 | @REM Find the project base dir, i.e. the directory that contains the folder ".mvn". 86 | @REM Fallback to current working directory if not found. 87 | 88 | set MAVEN_PROJECTBASEDIR=%MAVEN_BASEDIR% 89 | IF NOT "%MAVEN_PROJECTBASEDIR%"=="" goto endDetectBaseDir 90 | 91 | set EXEC_DIR=%CD% 92 | set WDIR=%EXEC_DIR% 93 | :findBaseDir 94 | IF EXIST "%WDIR%"\.mvn goto baseDirFound 95 | cd .. 96 | IF "%WDIR%"=="%CD%" goto baseDirNotFound 97 | set WDIR=%CD% 98 | goto findBaseDir 99 | 100 | :baseDirFound 101 | set MAVEN_PROJECTBASEDIR=%WDIR% 102 | cd "%EXEC_DIR%" 103 | goto endDetectBaseDir 104 | 105 | :baseDirNotFound 106 | set MAVEN_PROJECTBASEDIR=%EXEC_DIR% 107 | cd "%EXEC_DIR%" 108 | 109 | :endDetectBaseDir 110 | 111 | IF NOT EXIST "%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config" goto endReadAdditionalConfig 112 | 113 | @setlocal EnableExtensions EnableDelayedExpansion 114 | for /F "usebackq delims=" %%a in ("%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config") do set JVM_CONFIG_MAVEN_PROPS=!JVM_CONFIG_MAVEN_PROPS! %%a 115 | @endlocal & set JVM_CONFIG_MAVEN_PROPS=%JVM_CONFIG_MAVEN_PROPS% 116 | 117 | :endReadAdditionalConfig 118 | 119 | SET MAVEN_JAVA_EXE="%JAVA_HOME%\bin\java.exe" 120 | set WRAPPER_JAR="%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.jar" 121 | set WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain 122 | 123 | set DOWNLOAD_URL="https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.1.0/maven-wrapper-3.1.0.jar" 124 | 125 | FOR /F "usebackq tokens=1,2 delims==" %%A IN ("%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.properties") DO ( 126 | IF "%%A"=="wrapperUrl" SET DOWNLOAD_URL=%%B 127 | ) 128 | 129 | @REM Extension to allow automatically downloading the maven-wrapper.jar from Maven-central 130 | @REM This allows using the maven wrapper in projects that prohibit checking in binary data. 131 | if exist %WRAPPER_JAR% ( 132 | if "%MVNW_VERBOSE%" == "true" ( 133 | echo Found %WRAPPER_JAR% 134 | ) 135 | ) else ( 136 | if not "%MVNW_REPOURL%" == "" ( 137 | SET DOWNLOAD_URL="%MVNW_REPOURL%/org/apache/maven/wrapper/maven-wrapper/3.1.0/maven-wrapper-3.1.0.jar" 138 | ) 139 | if "%MVNW_VERBOSE%" == "true" ( 140 | echo Couldn't find %WRAPPER_JAR%, downloading it ... 141 | echo Downloading from: %DOWNLOAD_URL% 142 | ) 143 | 144 | powershell -Command "&{"^ 145 | "$webclient = new-object System.Net.WebClient;"^ 146 | "if (-not ([string]::IsNullOrEmpty('%MVNW_USERNAME%') -and [string]::IsNullOrEmpty('%MVNW_PASSWORD%'))) {"^ 147 | "$webclient.Credentials = new-object System.Net.NetworkCredential('%MVNW_USERNAME%', '%MVNW_PASSWORD%');"^ 148 | "}"^ 149 | "[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; $webclient.DownloadFile('%DOWNLOAD_URL%', '%WRAPPER_JAR%')"^ 150 | "}" 151 | if "%MVNW_VERBOSE%" == "true" ( 152 | echo Finished downloading %WRAPPER_JAR% 153 | ) 154 | ) 155 | @REM End of extension 156 | 157 | @REM Provide a "standardized" way to retrieve the CLI args that will 158 | @REM work with both Windows and non-Windows executions. 159 | set MAVEN_CMD_LINE_ARGS=%* 160 | 161 | %MAVEN_JAVA_EXE% ^ 162 | %JVM_CONFIG_MAVEN_PROPS% ^ 163 | %MAVEN_OPTS% ^ 164 | %MAVEN_DEBUG_OPTS% ^ 165 | -classpath %WRAPPER_JAR% ^ 166 | "-Dmaven.multiModuleProjectDirectory=%MAVEN_PROJECTBASEDIR%" ^ 167 | %WRAPPER_LAUNCHER% %MAVEN_CONFIG% %* 168 | if ERRORLEVEL 1 goto error 169 | goto end 170 | 171 | :error 172 | set ERROR_CODE=1 173 | 174 | :end 175 | @endlocal & set ERROR_CODE=%ERROR_CODE% 176 | 177 | if not "%MAVEN_SKIP_RC%"=="" goto skipRcPost 178 | @REM check for post script, once with legacy .bat ending and once with .cmd ending 179 | if exist "%USERPROFILE%\mavenrc_post.bat" call "%USERPROFILE%\mavenrc_post.bat" 180 | if exist "%USERPROFILE%\mavenrc_post.cmd" call "%USERPROFILE%\mavenrc_post.cmd" 181 | :skipRcPost 182 | 183 | @REM pause the script if MAVEN_BATCH_PAUSE is set to 'on' 184 | if "%MAVEN_BATCH_PAUSE%"=="on" pause 185 | 186 | if "%MAVEN_TERMINATE_CMD%"=="on" exit %ERROR_CODE% 187 | 188 | cmd /C exit /B %ERROR_CODE% 189 | -------------------------------------------------------------------------------- /pom.xml: -------------------------------------------------------------------------------- 1 | 2 | 4 | 4.0.0 5 | 6 | org.springframework.boot 7 | spring-boot-starter-parent 8 | 2.7.9 9 | 10 | 11 | com.exagonal 12 | tasks 13 | 0.0.1-SNAPSHOT 14 | tasks 15 | Example of hexagonal architecture using Java 16 | 17 | 1.8 18 | 19 | 20 | 21 | org.springframework.boot 22 | spring-boot-starter-data-jpa 23 | 24 | 25 | org.springframework.boot 26 | spring-boot-starter-web 27 | 28 | 29 | 30 | com.mysql 31 | mysql-connector-j 32 | runtime 33 | 34 | 35 | org.springframework.boot 36 | spring-boot-starter-test 37 | test 38 | 39 | 40 | 41 | 42 | 43 | 44 | org.springframework.boot 45 | spring-boot-maven-plugin 46 | 47 | 48 | 49 | 50 | 51 | -------------------------------------------------------------------------------- /src/main/java/com/exagonal/tasks/TasksApplication.java: -------------------------------------------------------------------------------- 1 | package com.exagonal.tasks; 2 | 3 | import org.springframework.boot.SpringApplication; 4 | import org.springframework.boot.autoconfigure.SpringBootApplication; 5 | 6 | @SpringBootApplication 7 | public class TasksApplication { 8 | 9 | public static void main(String[] args) { 10 | SpringApplication.run(TasksApplication.class, args); 11 | } 12 | 13 | } 14 | -------------------------------------------------------------------------------- /src/main/java/com/exagonal/tasks/application/services/TaskService.java: -------------------------------------------------------------------------------- 1 | package com.exagonal.tasks.application.services; 2 | 3 | import com.exagonal.tasks.domain.model.AdditionalTaskInfo; 4 | import com.exagonal.tasks.domain.model.Task; 5 | import com.exagonal.tasks.domain.ports.in.CreateTaskUseCase; 6 | import com.exagonal.tasks.domain.ports.in.DeleteTaskUseCase; 7 | import com.exagonal.tasks.domain.ports.in.GetAdditionalTaskInfoUseCase; 8 | import com.exagonal.tasks.domain.ports.in.RetrieveTaskUseCase; 9 | import com.exagonal.tasks.domain.ports.in.UpdateTaskUseCase; 10 | 11 | import java.util.List; 12 | import java.util.Optional; 13 | 14 | public class TaskService implements CreateTaskUseCase, RetrieveTaskUseCase, UpdateTaskUseCase, DeleteTaskUseCase, GetAdditionalTaskInfoUseCase { 15 | 16 | private final CreateTaskUseCase createTaskUseCase; 17 | private final RetrieveTaskUseCase retrieveTaskUseCase; 18 | private final UpdateTaskUseCase updateTaskUseCase; 19 | private final DeleteTaskUseCase deleteTaskUseCase; 20 | private final GetAdditionalTaskInfoUseCase getAdditionalTaskInfoUseCase; 21 | 22 | public TaskService(CreateTaskUseCase createTaskUseCase, RetrieveTaskUseCase retrieveTaskUseCase, 23 | UpdateTaskUseCase updateTaskUseCase, DeleteTaskUseCase deleteTaskUseCase, 24 | GetAdditionalTaskInfoUseCase getAdditionalTaskInfoUseCase) { 25 | this.createTaskUseCase = createTaskUseCase; 26 | this.retrieveTaskUseCase = retrieveTaskUseCase; 27 | this.updateTaskUseCase = updateTaskUseCase; 28 | this.deleteTaskUseCase = deleteTaskUseCase; 29 | this.getAdditionalTaskInfoUseCase = getAdditionalTaskInfoUseCase; 30 | } 31 | 32 | @Override 33 | public Task createTask(Task task) { 34 | return createTaskUseCase.createTask(task); 35 | } 36 | 37 | @Override 38 | public Optional getTaskById(Long id) { 39 | return retrieveTaskUseCase.getTaskById(id); 40 | } 41 | 42 | @Override 43 | public List getAllTasks() { 44 | return retrieveTaskUseCase.getAllTasks(); 45 | } 46 | 47 | @Override 48 | public Optional updateTask(Long id, Task updatedTask) { 49 | return updateTaskUseCase.updateTask(id, updatedTask); 50 | } 51 | 52 | @Override 53 | public boolean deleteTask(Long id) { 54 | return deleteTaskUseCase.deleteTask(id); 55 | } 56 | 57 | @Override 58 | public AdditionalTaskInfo getAdditionalTaskInfo(Long taskId) { 59 | return getAdditionalTaskInfoUseCase.getAdditionalTaskInfo(taskId); 60 | } 61 | } 62 | -------------------------------------------------------------------------------- /src/main/java/com/exagonal/tasks/application/usecases/CreateTaskUseCaseImpl.java: -------------------------------------------------------------------------------- 1 | package com.exagonal.tasks.application.usecases; 2 | 3 | import com.exagonal.tasks.domain.model.Task; 4 | import com.exagonal.tasks.domain.ports.in.CreateTaskUseCase; 5 | import com.exagonal.tasks.domain.ports.out.TaskRepositoryPort; 6 | 7 | public class CreateTaskUseCaseImpl implements CreateTaskUseCase { 8 | 9 | private final TaskRepositoryPort taskRepositoryPort; 10 | 11 | public CreateTaskUseCaseImpl(TaskRepositoryPort taskRepositoryPort) { 12 | this.taskRepositoryPort = taskRepositoryPort; 13 | } 14 | 15 | @Override 16 | public Task createTask(Task task) { 17 | return taskRepositoryPort.save(task); 18 | } 19 | } 20 | -------------------------------------------------------------------------------- /src/main/java/com/exagonal/tasks/application/usecases/DeleteTaskUseCaseImpl.java: -------------------------------------------------------------------------------- 1 | package com.exagonal.tasks.application.usecases; 2 | 3 | import com.exagonal.tasks.domain.ports.in.DeleteTaskUseCase; 4 | import com.exagonal.tasks.domain.ports.out.TaskRepositoryPort; 5 | 6 | public class DeleteTaskUseCaseImpl implements DeleteTaskUseCase { 7 | 8 | private final TaskRepositoryPort taskRepositoryPort; 9 | 10 | public DeleteTaskUseCaseImpl(TaskRepositoryPort taskRepositoryPort) { 11 | this.taskRepositoryPort = taskRepositoryPort; 12 | } 13 | 14 | @Override 15 | public boolean deleteTask(Long id) { 16 | return taskRepositoryPort.deleteById(id); 17 | } 18 | } 19 | -------------------------------------------------------------------------------- /src/main/java/com/exagonal/tasks/application/usecases/GetAdditionalTaskInfoUseCaseImpl.java: -------------------------------------------------------------------------------- 1 | package com.exagonal.tasks.application.usecases; 2 | 3 | import com.exagonal.tasks.domain.model.AdditionalTaskInfo; 4 | import com.exagonal.tasks.domain.ports.in.GetAdditionalTaskInfoUseCase; 5 | import com.exagonal.tasks.domain.ports.out.ExternalServicePort; 6 | 7 | public class GetAdditionalTaskInfoUseCaseImpl implements GetAdditionalTaskInfoUseCase { 8 | 9 | private final ExternalServicePort externalServicePort; 10 | 11 | public GetAdditionalTaskInfoUseCaseImpl(ExternalServicePort externalServicePort) { 12 | this.externalServicePort = externalServicePort; 13 | } 14 | 15 | @Override 16 | public AdditionalTaskInfo getAdditionalTaskInfo(Long taskId) { 17 | return externalServicePort.getAdditionalTaskInfo(taskId); 18 | } 19 | } 20 | -------------------------------------------------------------------------------- /src/main/java/com/exagonal/tasks/application/usecases/RetrieveTaskUseCaseImpl.java: -------------------------------------------------------------------------------- 1 | package com.exagonal.tasks.application.usecases; 2 | 3 | import com.exagonal.tasks.domain.model.Task; 4 | import com.exagonal.tasks.domain.ports.in.RetrieveTaskUseCase; 5 | import com.exagonal.tasks.domain.ports.out.TaskRepositoryPort; 6 | 7 | import java.util.List; 8 | import java.util.Optional; 9 | 10 | public class RetrieveTaskUseCaseImpl implements RetrieveTaskUseCase { 11 | 12 | private final TaskRepositoryPort taskRepositoryPort; 13 | 14 | public RetrieveTaskUseCaseImpl(TaskRepositoryPort taskRepositoryPort) { 15 | this.taskRepositoryPort = taskRepositoryPort; 16 | } 17 | 18 | @Override 19 | public Optional getTaskById(Long id) { 20 | return taskRepositoryPort.findById(id); 21 | } 22 | 23 | @Override 24 | public List getAllTasks() { 25 | return taskRepositoryPort.findAll(); 26 | } 27 | } 28 | -------------------------------------------------------------------------------- /src/main/java/com/exagonal/tasks/application/usecases/UpdateTaskUseCaseImpl.java: -------------------------------------------------------------------------------- 1 | package com.exagonal.tasks.application.usecases; 2 | 3 | import com.exagonal.tasks.domain.model.Task; 4 | import com.exagonal.tasks.domain.ports.in.UpdateTaskUseCase; 5 | import com.exagonal.tasks.domain.ports.out.TaskRepositoryPort; 6 | 7 | import java.util.Optional; 8 | 9 | public class UpdateTaskUseCaseImpl implements UpdateTaskUseCase { 10 | 11 | private final TaskRepositoryPort taskRepositoryPort; 12 | 13 | public UpdateTaskUseCaseImpl(TaskRepositoryPort taskRepositoryPort) { 14 | this.taskRepositoryPort = taskRepositoryPort; 15 | } 16 | 17 | @Override 18 | public Optional updateTask(Long id, Task updatedTask) { 19 | return taskRepositoryPort.update(updatedTask); 20 | } 21 | } 22 | -------------------------------------------------------------------------------- /src/main/java/com/exagonal/tasks/domain/model/AdditionalTaskInfo.java: -------------------------------------------------------------------------------- 1 | package com.exagonal.tasks.domain.model; 2 | 3 | public class AdditionalTaskInfo { 4 | private final Long userId; 5 | private final String userName; 6 | private final String userEmail; 7 | 8 | public AdditionalTaskInfo(Long userId, String userName, String userEmail) { 9 | this.userId = userId; 10 | this.userName = userName; 11 | this.userEmail = userEmail; 12 | } 13 | 14 | public Long getUserId() { 15 | return userId; 16 | } 17 | 18 | public String getUserName() { 19 | return userName; 20 | } 21 | 22 | public String getUserEmail() { 23 | return userEmail; 24 | } 25 | } 26 | -------------------------------------------------------------------------------- /src/main/java/com/exagonal/tasks/domain/model/Task.java: -------------------------------------------------------------------------------- 1 | package com.exagonal.tasks.domain.model; 2 | 3 | import java.time.LocalDateTime; 4 | 5 | public class Task { 6 | 7 | private Long id; 8 | private String title; 9 | private String description; 10 | private LocalDateTime creationDate; 11 | private boolean completed; 12 | 13 | public Task(Long id, String title, String description, LocalDateTime creationDate, boolean completed) { 14 | this.id = id; 15 | this.title = title; 16 | this.description = description; 17 | this.creationDate = creationDate; 18 | this.completed = completed; 19 | } 20 | 21 | // Getters and setters 22 | 23 | public Long getId() { 24 | return id; 25 | } 26 | 27 | public void setId(Long id) { 28 | this.id = id; 29 | } 30 | 31 | public String getTitle() { 32 | return title; 33 | } 34 | 35 | public void setTitle(String title) { 36 | this.title = title; 37 | } 38 | 39 | public String getDescription() { 40 | return description; 41 | } 42 | 43 | public void setDescription(String description) { 44 | this.description = description; 45 | } 46 | 47 | public LocalDateTime getCreationDate() { 48 | return creationDate; 49 | } 50 | 51 | public void setCreationDate(LocalDateTime creationDate) { 52 | this.creationDate = creationDate; 53 | } 54 | 55 | public boolean isCompleted() { 56 | return completed; 57 | } 58 | 59 | public void setCompleted(boolean completed) { 60 | this.completed = completed; 61 | } 62 | } 63 | -------------------------------------------------------------------------------- /src/main/java/com/exagonal/tasks/domain/ports/in/CreateTaskUseCase.java: -------------------------------------------------------------------------------- 1 | package com.exagonal.tasks.domain.ports.in; 2 | 3 | import com.exagonal.tasks.domain.model.Task; 4 | 5 | public interface CreateTaskUseCase { 6 | Task createTask(Task task); 7 | } 8 | -------------------------------------------------------------------------------- /src/main/java/com/exagonal/tasks/domain/ports/in/DeleteTaskUseCase.java: -------------------------------------------------------------------------------- 1 | package com.exagonal.tasks.domain.ports.in; 2 | 3 | public interface DeleteTaskUseCase { 4 | boolean deleteTask(Long id); 5 | } 6 | -------------------------------------------------------------------------------- /src/main/java/com/exagonal/tasks/domain/ports/in/GetAdditionalTaskInfoUseCase.java: -------------------------------------------------------------------------------- 1 | package com.exagonal.tasks.domain.ports.in; 2 | 3 | import com.exagonal.tasks.domain.model.AdditionalTaskInfo; 4 | 5 | public interface GetAdditionalTaskInfoUseCase { 6 | AdditionalTaskInfo getAdditionalTaskInfo(Long taskId); 7 | } 8 | -------------------------------------------------------------------------------- /src/main/java/com/exagonal/tasks/domain/ports/in/RetrieveTaskUseCase.java: -------------------------------------------------------------------------------- 1 | package com.exagonal.tasks.domain.ports.in; 2 | 3 | import com.exagonal.tasks.domain.model.Task; 4 | 5 | import java.util.List; 6 | import java.util.Optional; 7 | 8 | public interface RetrieveTaskUseCase { 9 | Optional getTaskById(Long id); 10 | List getAllTasks(); 11 | } 12 | -------------------------------------------------------------------------------- /src/main/java/com/exagonal/tasks/domain/ports/in/UpdateTaskUseCase.java: -------------------------------------------------------------------------------- 1 | package com.exagonal.tasks.domain.ports.in; 2 | 3 | import com.exagonal.tasks.domain.model.Task; 4 | 5 | import java.util.Optional; 6 | 7 | public interface UpdateTaskUseCase { 8 | Optional updateTask(Long id, Task updatedTask); 9 | } 10 | -------------------------------------------------------------------------------- /src/main/java/com/exagonal/tasks/domain/ports/out/ExternalServicePort.java: -------------------------------------------------------------------------------- 1 | package com.exagonal.tasks.domain.ports.out; 2 | 3 | import com.exagonal.tasks.domain.model.AdditionalTaskInfo; 4 | 5 | public interface ExternalServicePort { 6 | AdditionalTaskInfo getAdditionalTaskInfo(Long taskId); 7 | } 8 | -------------------------------------------------------------------------------- /src/main/java/com/exagonal/tasks/domain/ports/out/TaskRepositoryPort.java: -------------------------------------------------------------------------------- 1 | package com.exagonal.tasks.domain.ports.out; 2 | 3 | import com.exagonal.tasks.domain.model.Task; 4 | 5 | import java.util.List; 6 | import java.util.Optional; 7 | 8 | public interface TaskRepositoryPort { 9 | Task save(Task task); 10 | Optional findById(Long id); 11 | List findAll(); 12 | Optional update(Task task); 13 | boolean deleteById(Long id); 14 | } 15 | -------------------------------------------------------------------------------- /src/main/java/com/exagonal/tasks/infrastructure/adapters/ExternalServiceAdapter.java: -------------------------------------------------------------------------------- 1 | package com.exagonal.tasks.infrastructure.adapters; 2 | 3 | import com.exagonal.tasks.domain.model.AdditionalTaskInfo; 4 | import com.exagonal.tasks.domain.ports.out.ExternalServicePort; 5 | import org.springframework.http.ResponseEntity; 6 | import org.springframework.stereotype.Component; 7 | import org.springframework.web.client.RestTemplate; 8 | 9 | @Component 10 | public class ExternalServiceAdapter implements ExternalServicePort { 11 | 12 | private final RestTemplate restTemplate; 13 | 14 | public ExternalServiceAdapter() { 15 | restTemplate = new RestTemplate(); 16 | } 17 | 18 | @Override 19 | public AdditionalTaskInfo getAdditionalTaskInfo(Long taskId) { 20 | String apiUrl = "https://jsonplaceholder.typicode.com/todos/" + taskId; 21 | ResponseEntity response = restTemplate.getForEntity(apiUrl, JsonPlaceholderTodo.class); 22 | JsonPlaceholderTodo todo = response.getBody(); 23 | 24 | if (todo == null) { 25 | return null; 26 | } 27 | 28 | apiUrl = "https://jsonplaceholder.typicode.com/users/" + todo.getUserId(); 29 | ResponseEntity userResponse = restTemplate.getForEntity(apiUrl, JsonPlaceholderUser.class); 30 | JsonPlaceholderUser user = userResponse.getBody(); 31 | 32 | if (user == null) { 33 | return null; 34 | } 35 | 36 | return new AdditionalTaskInfo(user.getId(), user.getName(), user.getEmail()); 37 | } 38 | 39 | private static class JsonPlaceholderTodo { 40 | private Long id; 41 | private Long userId; 42 | 43 | public Long getId() { 44 | return id; 45 | } 46 | 47 | public void setId(Long id) { 48 | this.id = id; 49 | } 50 | 51 | public Long getUserId() { 52 | return userId; 53 | } 54 | 55 | public void setUserId(Long userId) { 56 | this.userId = userId; 57 | } 58 | } 59 | 60 | private static class JsonPlaceholderUser { 61 | private Long id; 62 | private String name; 63 | private String email; 64 | 65 | public Long getId() { 66 | return id; 67 | } 68 | 69 | public void setId(Long id) { 70 | this.id = id; 71 | } 72 | 73 | public String getName() { 74 | return name; 75 | } 76 | 77 | public void setName(String name) { 78 | this.name = name; 79 | } 80 | 81 | public String getEmail() { 82 | return email; 83 | } 84 | 85 | public void setEmail(String email) { 86 | this.email = email; 87 | } 88 | } 89 | } 90 | -------------------------------------------------------------------------------- /src/main/java/com/exagonal/tasks/infrastructure/config/ApplicationConfig.java: -------------------------------------------------------------------------------- 1 | package com.exagonal.tasks.infrastructure.config; 2 | 3 | import com.exagonal.tasks.application.services.TaskService; 4 | import com.exagonal.tasks.application.usecases.*; 5 | import com.exagonal.tasks.domain.ports.in.GetAdditionalTaskInfoUseCase; 6 | import com.exagonal.tasks.domain.ports.out.TaskRepositoryPort; 7 | import com.exagonal.tasks.domain.ports.out.ExternalServicePort; 8 | import com.exagonal.tasks.infrastructure.adapters.ExternalServiceAdapter; 9 | import com.exagonal.tasks.infrastructure.repositories.JpaTaskRepositoryAdapter; 10 | import org.springframework.context.annotation.Bean; 11 | import org.springframework.context.annotation.Configuration; 12 | 13 | @Configuration 14 | public class ApplicationConfig { 15 | 16 | @Bean 17 | public TaskService taskService(TaskRepositoryPort taskRepositoryPort, GetAdditionalTaskInfoUseCase getAdditionalTaskInfoUseCase) { 18 | return new TaskService( 19 | new CreateTaskUseCaseImpl(taskRepositoryPort), 20 | new RetrieveTaskUseCaseImpl(taskRepositoryPort), 21 | new UpdateTaskUseCaseImpl(taskRepositoryPort), 22 | new DeleteTaskUseCaseImpl(taskRepositoryPort), 23 | getAdditionalTaskInfoUseCase 24 | ); 25 | } 26 | 27 | @Bean 28 | public TaskRepositoryPort taskRepositoryPort(JpaTaskRepositoryAdapter jpaTaskRepositoryAdapter) { 29 | return jpaTaskRepositoryAdapter; 30 | } 31 | 32 | @Bean 33 | public GetAdditionalTaskInfoUseCase getAdditionalTaskInfoUseCase(ExternalServicePort externalServicePort) { 34 | return new GetAdditionalTaskInfoUseCaseImpl(externalServicePort); 35 | } 36 | 37 | @Bean 38 | public ExternalServicePort externalServicePort() { 39 | return new ExternalServiceAdapter(); 40 | } 41 | } 42 | -------------------------------------------------------------------------------- /src/main/java/com/exagonal/tasks/infrastructure/controllers/TaskController.java: -------------------------------------------------------------------------------- 1 | package com.exagonal.tasks.infrastructure.controllers; 2 | 3 | import com.exagonal.tasks.application.services.TaskService; 4 | import com.exagonal.tasks.domain.model.AdditionalTaskInfo; 5 | import com.exagonal.tasks.domain.model.Task; 6 | import org.springframework.http.HttpStatus; 7 | import org.springframework.http.ResponseEntity; 8 | import org.springframework.web.bind.annotation.*; 9 | 10 | import java.util.List; 11 | 12 | @RestController 13 | @RequestMapping("/api/tasks") 14 | public class TaskController { 15 | 16 | private final TaskService taskService; 17 | 18 | public TaskController(TaskService taskService) { 19 | this.taskService = taskService; 20 | } 21 | 22 | @PostMapping 23 | public ResponseEntity createTask(@RequestBody Task task) { 24 | Task createdTask = taskService.createTask(task); 25 | return new ResponseEntity<>(createdTask, HttpStatus.CREATED); 26 | } 27 | 28 | @GetMapping("/{taskId}") 29 | public ResponseEntity getTaskById(@PathVariable Long taskId) { 30 | return taskService.getTaskById(taskId) 31 | .map(task -> new ResponseEntity<>(task, HttpStatus.OK)) 32 | .orElse(new ResponseEntity<>(HttpStatus.NOT_FOUND)); 33 | } 34 | 35 | @GetMapping 36 | public ResponseEntity> getAllTasks() { 37 | List tasks = taskService.getAllTasks(); 38 | return new ResponseEntity<>(tasks, HttpStatus.OK); 39 | } 40 | 41 | @PutMapping("/{taskId}") 42 | public ResponseEntity updateTask(@PathVariable Long taskId, @RequestBody Task updatedTask) { 43 | return taskService.updateTask(taskId, updatedTask) 44 | .map(task -> new ResponseEntity<>(task, HttpStatus.OK)) 45 | .orElse(new ResponseEntity<>(HttpStatus.NOT_FOUND)); 46 | } 47 | 48 | @DeleteMapping("/{taskId}") 49 | public ResponseEntity deleteTaskById(@PathVariable Long taskId) { 50 | if (taskService.deleteTask(taskId)) { 51 | return new ResponseEntity<>(HttpStatus.NO_CONTENT); 52 | } else { 53 | return new ResponseEntity<>(HttpStatus.NOT_FOUND); 54 | } 55 | } 56 | 57 | @GetMapping("/{taskId}/additional-info") 58 | public ResponseEntity getAdditionalTaskInfo(@PathVariable Long taskId) { 59 | AdditionalTaskInfo additionalTaskInfo = taskService.getAdditionalTaskInfo(taskId); 60 | return new ResponseEntity<>(additionalTaskInfo, HttpStatus.OK); 61 | } 62 | } 63 | -------------------------------------------------------------------------------- /src/main/java/com/exagonal/tasks/infrastructure/entities/TaskEntity.java: -------------------------------------------------------------------------------- 1 | package com.exagonal.tasks.infrastructure.entities; 2 | 3 | import com.exagonal.tasks.domain.model.Task; 4 | 5 | import javax.persistence.Entity; 6 | import javax.persistence.GeneratedValue; 7 | import javax.persistence.GenerationType; 8 | import javax.persistence.Id; 9 | import java.time.LocalDateTime; 10 | 11 | @Entity 12 | public class TaskEntity { 13 | 14 | @Id 15 | @GeneratedValue(strategy = GenerationType.IDENTITY) 16 | private Long id; 17 | private String title; 18 | private String description; 19 | private LocalDateTime creationDate; 20 | private boolean completed; 21 | 22 | public TaskEntity() { 23 | } 24 | 25 | public TaskEntity(Long id, String title, String description, LocalDateTime creationDate, boolean completed) { 26 | this.id = id; 27 | this.title = title; 28 | this.description = description; 29 | this.creationDate = creationDate; 30 | this.completed = completed; 31 | } 32 | 33 | public static TaskEntity fromDomainModel(Task task) { 34 | return new TaskEntity(task.getId(), task.getTitle(), task.getDescription(), task.getCreationDate(), task.isCompleted()); 35 | } 36 | 37 | public Task toDomainModel() { 38 | return new Task(id, title, description, creationDate, completed); 39 | } 40 | 41 | public Long getId() { 42 | return id; 43 | } 44 | 45 | public void setId(Long id) { 46 | this.id = id; 47 | } 48 | 49 | public String getTitle() { 50 | return title; 51 | } 52 | 53 | public void setTitle(String title) { 54 | this.title = title; 55 | } 56 | 57 | public String getDescription() { 58 | return description; 59 | } 60 | 61 | public void setDescription(String description) { 62 | this.description = description; 63 | } 64 | 65 | public LocalDateTime getCreationDate() { 66 | return creationDate; 67 | } 68 | 69 | public void setCreationDate(LocalDateTime creationDate) { 70 | this.creationDate = creationDate; 71 | } 72 | 73 | public boolean isCompleted() { 74 | return completed; 75 | } 76 | 77 | public void setCompleted(boolean completed) { 78 | this.completed = completed; 79 | } 80 | } 81 | -------------------------------------------------------------------------------- /src/main/java/com/exagonal/tasks/infrastructure/repositories/JpaTaskRepository.java: -------------------------------------------------------------------------------- 1 | package com.exagonal.tasks.infrastructure.repositories; 2 | 3 | import com.exagonal.tasks.infrastructure.entities.TaskEntity; 4 | import org.springframework.data.jpa.repository.JpaRepository; 5 | import org.springframework.stereotype.Repository; 6 | 7 | @Repository 8 | public interface JpaTaskRepository extends JpaRepository { 9 | } 10 | -------------------------------------------------------------------------------- /src/main/java/com/exagonal/tasks/infrastructure/repositories/JpaTaskRepositoryAdapter.java: -------------------------------------------------------------------------------- 1 | package com.exagonal.tasks.infrastructure.repositories; 2 | 3 | import com.exagonal.tasks.domain.model.Task; 4 | import com.exagonal.tasks.domain.ports.out.TaskRepositoryPort; 5 | import com.exagonal.tasks.infrastructure.entities.TaskEntity; 6 | import org.springframework.stereotype.Component; 7 | 8 | import java.util.List; 9 | import java.util.Optional; 10 | import java.util.stream.Collectors; 11 | 12 | @Component 13 | public class JpaTaskRepositoryAdapter implements TaskRepositoryPort { 14 | 15 | private final JpaTaskRepository jpaTaskRepository; 16 | 17 | public JpaTaskRepositoryAdapter(JpaTaskRepository jpaTaskRepository) { 18 | this.jpaTaskRepository = jpaTaskRepository; 19 | } 20 | 21 | @Override 22 | public Task save(Task task) { 23 | TaskEntity taskEntity = TaskEntity.fromDomainModel(task); 24 | TaskEntity savedTaskEntity = jpaTaskRepository.save(taskEntity); 25 | return savedTaskEntity.toDomainModel(); 26 | } 27 | 28 | @Override 29 | public Optional findById(Long id) { 30 | return jpaTaskRepository.findById(id).map(TaskEntity::toDomainModel); 31 | } 32 | 33 | @Override 34 | public List findAll() { 35 | return jpaTaskRepository.findAll().stream() 36 | .map(TaskEntity::toDomainModel) 37 | .collect(Collectors.toList()); 38 | } 39 | 40 | @Override 41 | public Optional update(Task task) { 42 | if (jpaTaskRepository.existsById(task.getId())) { 43 | TaskEntity taskEntity = TaskEntity.fromDomainModel(task); 44 | TaskEntity updatedTaskEntity = jpaTaskRepository.save(taskEntity); 45 | return Optional.of(updatedTaskEntity.toDomainModel()); 46 | } 47 | return Optional.empty(); 48 | } 49 | 50 | @Override 51 | public boolean deleteById(Long id) { 52 | if (jpaTaskRepository.existsById(id)) { 53 | jpaTaskRepository.deleteById(id); 54 | return true; 55 | } 56 | return false; 57 | } 58 | } 59 | -------------------------------------------------------------------------------- /src/main/resources/application.properties: -------------------------------------------------------------------------------- 1 | # DataSource settings 2 | spring.datasource.url=jdbc:mysql://localhost:3306/tasks?useSSL=false&serverTimezone=UTC 3 | spring.datasource.username=root 4 | spring.datasource.password=12345678 5 | spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver 6 | 7 | # Hibernate settings 8 | spring.jpa.hibernate.ddl-auto=update 9 | spring.jpa.show-sql=true 10 | spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect 11 | spring.jpa.properties.hibernate.format_sql=true 12 | 13 | # Logging settings 14 | logging.level.org.hibernate.SQL=DEBUG 15 | logging.level.org.hibernate.type.descriptor.sql.BasicBinder=TRACE 16 | -------------------------------------------------------------------------------- /src/test/java/com/exagonal/tasks/TasksApplicationTests.java: -------------------------------------------------------------------------------- 1 | package com.exagonal.tasks; 2 | 3 | import org.junit.jupiter.api.Test; 4 | import org.springframework.boot.test.context.SpringBootTest; 5 | 6 | @SpringBootTest 7 | class TasksApplicationTests { 8 | 9 | @Test 10 | void contextLoads() { 11 | } 12 | 13 | } 14 | --------------------------------------------------------------------------------