├── .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 |
--------------------------------------------------------------------------------