Spring Boot 3 - Buenas prácticas y protección: Aula 1

009_emprendimiento/emprendimiento.md

@@ -209,8 +209,8 @@ En una startup todos son emprendedores
 
 ### Escalabilidad e implementación
 
-[<img src="./viab_graph.png" width="400"/>](./viab_graph.png)
+[<img src="./imgs/viab_graph.png" width="400"/>](./imgs/viab_graph.png)
-[<img src="./esca_graph.png" width="400"/>](./esca_graph.png)
+[<img src="./imgs/esca_graph.png" width="400"/>](./imgs/esca_graph.png)
 
 ### Recurrencia
 
@@ -285,7 +285,7 @@ Humanos"]
 end
 ```
 
-Propiedad intelectual - ¿Hay algo que sea patentable?
+Propiedad intelectual ***¿Hay algo que sea patentable?***
 
 ```mermaid
 %%{init: {'theme': 'dark','themeVariables': {'clusterBkg': '#2b2f38'}, 'flowchart': {'curve': 'monotoneY'}}}%%
@@ -336,7 +336,7 @@ Recurrencia, subscripción
 
 ### Margen
 
-[<img src="./punto_muerto.png" width="400"/>](./punto_muerto.png)
+[<img src="./imgs/punto_muerto.png" width="400"/>](./imgs/punto_muerto.png)
 
 - Margen de ganancia
 - Costos fijos
@@ -352,15 +352,15 @@ Recurrencia, subscripción
 
 ## Business Model Canvas
 
-[<img src="./bmc_template.jpg" width="100%"/>](./bmc_template.jpg)
+[<img src="./imgs/bmc_template.jpg" width="100%"/>](./imgs/bmc_template.jpg)
 
 ### Ejms. BMC
 
-[<img src="./tesla_lcm.webp" width="100%"/>](./tesla_lcm.webp)
+[<img src="./imgs/tesla_lcm.webp" width="100%"/>](./imgs/tesla_lcm.webp)
-[<img src="./google_lcm.webp" width="100%"/>](./google_lcm.webp)
+[<img src="./imgs/google_lcm.webp" width="100%"/>](./imgs/google_lcm.webp)
-[<img src="./apple_lcm.webp" width="100%"/>](./apple_lcm.webp)
+[<img src="./imgs/apple_lcm.webp" width="100%"/>](./imgs/apple_lcm.webp)
-[<img src="./skype_lcm.webp" width="100%"/>](./skype_lcm.webp)
+[<img src="./imgs/skype_lcm.webp" width="100%"/>](./imgs/skype_lcm.webp)
-[<img src="./facebook_lcm.webp" width="100%"/>](./facebook_lcm.webp)
+[<img src="./imgs/facebook_lcm.webp" width="100%"/>](./imgs/facebook_lcm.webp)
 
 ## Plan de negocio
 

009_emprendimiento/lean_startup.md

@@ -115,7 +115,7 @@ los comentarios. A partir de ahí reconstruimos el negocio.
 
 *Producto Mínimo Viable*
 
-![img](./mvp_concepto.png)
+![img](./imgs/mvp_concepto.png)
 
 #### Enfoque
 

010_spring_boot/api_rest/api2/mvnw

@@ -0,0 +1,308 @@
+#!/bin/sh
+# ----------------------------------------------------------------------------
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#    https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+# ----------------------------------------------------------------------------
+
+# ----------------------------------------------------------------------------
+# Apache Maven Wrapper startup batch script, version 3.2.0
+#
+# Required ENV vars:
+# ------------------
+#   JAVA_HOME - location of a JDK home dir
+#
+# Optional ENV vars
+# -----------------
+#   MAVEN_OPTS - parameters passed to the Java VM when running Maven
+#     e.g. to debug Maven itself, use
+#       set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000
+#   MAVEN_SKIP_RC - flag to disable loading of mavenrc files
+# ----------------------------------------------------------------------------
+
+if [ -z "$MAVEN_SKIP_RC" ] ; then
+
+  if [ -f /usr/local/etc/mavenrc ] ; then
+    . /usr/local/etc/mavenrc
+  fi
+
+  if [ -f /etc/mavenrc ] ; then
+    . /etc/mavenrc
+  fi
+
+  if [ -f "$HOME/.mavenrc" ] ; then
+    . "$HOME/.mavenrc"
+  fi
+
+fi
+
+# OS specific support.  $var _must_ be set to either true or false.
+cygwin=false;
+darwin=false;
+mingw=false
+case "$(uname)" in
+  CYGWIN*) cygwin=true ;;
+  MINGW*) mingw=true;;
+  Darwin*) darwin=true
+    # Use /usr/libexec/java_home if available, otherwise fall back to /Library/Java/Home
+    # See https://developer.apple.com/library/mac/qa/qa1170/_index.html
+    if [ -z "$JAVA_HOME" ]; then
+      if [ -x "/usr/libexec/java_home" ]; then
+        JAVA_HOME="$(/usr/libexec/java_home)"; export JAVA_HOME
+      else
+        JAVA_HOME="/Library/Java/Home"; export JAVA_HOME
+      fi
+    fi
+    ;;
+esac
+
+if [ -z "$JAVA_HOME" ] ; then
+  if [ -r /etc/gentoo-release ] ; then
+    JAVA_HOME=$(java-config --jre-home)
+  fi
+fi
+
+# For Cygwin, ensure paths are in UNIX format before anything is touched
+if $cygwin ; then
+  [ -n "$JAVA_HOME" ] &&
+    JAVA_HOME=$(cygpath --unix "$JAVA_HOME")
+  [ -n "$CLASSPATH" ] &&
+    CLASSPATH=$(cygpath --path --unix "$CLASSPATH")
+fi
+
+# For Mingw, ensure paths are in UNIX format before anything is touched
+if $mingw ; then
+  [ -n "$JAVA_HOME" ] && [ -d "$JAVA_HOME" ] &&
+    JAVA_HOME="$(cd "$JAVA_HOME" || (echo "cannot cd into $JAVA_HOME."; exit 1); pwd)"
+fi
+
+if [ -z "$JAVA_HOME" ]; then
+  javaExecutable="$(which javac)"
+  if [ -n "$javaExecutable" ] && ! [ "$(expr "\"$javaExecutable\"" : '\([^ ]*\)')" = "no" ]; then
+    # readlink(1) is not available as standard on Solaris 10.
+    readLink=$(which readlink)
+    if [ ! "$(expr "$readLink" : '\([^ ]*\)')" = "no" ]; then
+      if $darwin ; then
+        javaHome="$(dirname "\"$javaExecutable\"")"
+        javaExecutable="$(cd "\"$javaHome\"" && pwd -P)/javac"
+      else
+        javaExecutable="$(readlink -f "\"$javaExecutable\"")"
+      fi
+      javaHome="$(dirname "\"$javaExecutable\"")"
+      javaHome=$(expr "$javaHome" : '\(.*\)/bin')
+      JAVA_HOME="$javaHome"
+      export JAVA_HOME
+    fi
+  fi
+fi
+
+if [ -z "$JAVACMD" ] ; then
+  if [ -n "$JAVA_HOME"  ] ; then
+    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+      # IBM's JDK on AIX uses strange locations for the executables
+      JAVACMD="$JAVA_HOME/jre/sh/java"
+    else
+      JAVACMD="$JAVA_HOME/bin/java"
+    fi
+  else
+    JAVACMD="$(\unset -f command 2>/dev/null; \command -v java)"
+  fi
+fi
+
+if [ ! -x "$JAVACMD" ] ; then
+  echo "Error: JAVA_HOME is not defined correctly." >&2
+  echo "  We cannot execute $JAVACMD" >&2
+  exit 1
+fi
+
+if [ -z "$JAVA_HOME" ] ; then
+  echo "Warning: JAVA_HOME environment variable is not set."
+fi
+
+# traverses directory structure from process work directory to filesystem root
+# first directory with .mvn subdirectory is considered project base directory
+find_maven_basedir() {
+  if [ -z "$1" ]
+  then
+    echo "Path not specified to find_maven_basedir"
+    return 1
+  fi
+
+  basedir="$1"
+  wdir="$1"
+  while [ "$wdir" != '/' ] ; do
+    if [ -d "$wdir"/.mvn ] ; then
+      basedir=$wdir
+      break
+    fi
+    # workaround for JBEAP-8937 (on Solaris 10/Sparc)
+    if [ -d "${wdir}" ]; then
+      wdir=$(cd "$wdir/.." || exit 1; pwd)
+    fi
+    # end of workaround
+  done
+  printf '%s' "$(cd "$basedir" || exit 1; pwd)"
+}
+
+# concatenates all lines of a file
+concat_lines() {
+  if [ -f "$1" ]; then
+    # Remove \r in case we run on Windows within Git Bash
+    # and check out the repository with auto CRLF management
+    # enabled. Otherwise, we may read lines that are delimited with
+    # \r\n and produce $'-Xarg\r' rather than -Xarg due to word
+    # splitting rules.
+    tr -s '\r\n' ' ' < "$1"
+  fi
+}
+
+log() {
+  if [ "$MVNW_VERBOSE" = true ]; then
+    printf '%s\n' "$1"
+  fi
+}
+
+BASE_DIR=$(find_maven_basedir "$(dirname "$0")")
+if [ -z "$BASE_DIR" ]; then
+  exit 1;
+fi
+
+MAVEN_PROJECTBASEDIR=${MAVEN_BASEDIR:-"$BASE_DIR"}; export MAVEN_PROJECTBASEDIR
+log "$MAVEN_PROJECTBASEDIR"
+
+##########################################################################################
+# Extension to allow automatically downloading the maven-wrapper.jar from Maven-central
+# This allows using the maven wrapper in projects that prohibit checking in binary data.
+##########################################################################################
+wrapperJarPath="$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar"
+if [ -r "$wrapperJarPath" ]; then
+    log "Found $wrapperJarPath"
+else
+    log "Couldn't find $wrapperJarPath, downloading it ..."
+
+    if [ -n "$MVNW_REPOURL" ]; then
+      wrapperUrl="$MVNW_REPOURL/org/apache/maven/wrapper/maven-wrapper/3.2.0/maven-wrapper-3.2.0.jar"
+    else
+      wrapperUrl="https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.2.0/maven-wrapper-3.2.0.jar"
+    fi
+    while IFS="=" read -r key value; do
+      # Remove '\r' from value to allow usage on windows as IFS does not consider '\r' as a separator ( considers space, tab, new line ('\n'), and custom '=' )
+      safeValue=$(echo "$value" | tr -d '\r')
+      case "$key" in (wrapperUrl) wrapperUrl="$safeValue"; break ;;
+      esac
+    done < "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.properties"
+    log "Downloading from: $wrapperUrl"
+
+    if $cygwin; then
+      wrapperJarPath=$(cygpath --path --windows "$wrapperJarPath")
+    fi
+
+    if command -v wget > /dev/null; then
+        log "Found wget ... using wget"
+        [ "$MVNW_VERBOSE" = true ] && QUIET="" || QUIET="--quiet"
+        if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then
+            wget $QUIET "$wrapperUrl" -O "$wrapperJarPath" || rm -f "$wrapperJarPath"
+        else
+            wget $QUIET --http-user="$MVNW_USERNAME" --http-password="$MVNW_PASSWORD" "$wrapperUrl" -O "$wrapperJarPath" || rm -f "$wrapperJarPath"
+        fi
+    elif command -v curl > /dev/null; then
+        log "Found curl ... using curl"
+        [ "$MVNW_VERBOSE" = true ] && QUIET="" || QUIET="--silent"
+        if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then
+            curl $QUIET -o "$wrapperJarPath" "$wrapperUrl" -f -L || rm -f "$wrapperJarPath"
+        else
+            curl $QUIET --user "$MVNW_USERNAME:$MVNW_PASSWORD" -o "$wrapperJarPath" "$wrapperUrl" -f -L || rm -f "$wrapperJarPath"
+        fi
+    else
+        log "Falling back to using Java to download"
+        javaSource="$MAVEN_PROJECTBASEDIR/.mvn/wrapper/MavenWrapperDownloader.java"
+        javaClass="$MAVEN_PROJECTBASEDIR/.mvn/wrapper/MavenWrapperDownloader.class"
+        # For Cygwin, switch paths to Windows format before running javac
+        if $cygwin; then
+          javaSource=$(cygpath --path --windows "$javaSource")
+          javaClass=$(cygpath --path --windows "$javaClass")
+        fi
+        if [ -e "$javaSource" ]; then
+            if [ ! -e "$javaClass" ]; then
+                log " - Compiling MavenWrapperDownloader.java ..."
+                ("$JAVA_HOME/bin/javac" "$javaSource")
+            fi
+            if [ -e "$javaClass" ]; then
+                log " - Running MavenWrapperDownloader.java ..."
+                ("$JAVA_HOME/bin/java" -cp .mvn/wrapper MavenWrapperDownloader "$wrapperUrl" "$wrapperJarPath") || rm -f "$wrapperJarPath"
+            fi
+        fi
+    fi
+fi
+##########################################################################################
+# End of extension
+##########################################################################################
+
+# If specified, validate the SHA-256 sum of the Maven wrapper jar file
+wrapperSha256Sum=""
+while IFS="=" read -r key value; do
+  case "$key" in (wrapperSha256Sum) wrapperSha256Sum=$value; break ;;
+  esac
+done < "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.properties"
+if [ -n "$wrapperSha256Sum" ]; then
+  wrapperSha256Result=false
+  if command -v sha256sum > /dev/null; then
+    if echo "$wrapperSha256Sum  $wrapperJarPath" | sha256sum -c > /dev/null 2>&1; then
+      wrapperSha256Result=true
+    fi
+  elif command -v shasum > /dev/null; then
+    if echo "$wrapperSha256Sum  $wrapperJarPath" | shasum -a 256 -c > /dev/null 2>&1; then
+      wrapperSha256Result=true
+    fi
+  else
+    echo "Checksum validation was requested but neither 'sha256sum' or 'shasum' are available."
+    echo "Please install either command, or disable validation by removing 'wrapperSha256Sum' from your maven-wrapper.properties."
+    exit 1
+  fi
+  if [ $wrapperSha256Result = false ]; then
+    echo "Error: Failed to validate Maven wrapper SHA-256, your Maven wrapper might be compromised." >&2
+    echo "Investigate or delete $wrapperJarPath to attempt a clean download." >&2
+    echo "If you updated your Maven version, you need to update the specified wrapperSha256Sum property." >&2
+    exit 1
+  fi
+fi
+
+MAVEN_OPTS="$(concat_lines "$MAVEN_PROJECTBASEDIR/.mvn/jvm.config") $MAVEN_OPTS"
+
+# For Cygwin, switch paths to Windows format before running java
+if $cygwin; then
+  [ -n "$JAVA_HOME" ] &&
+    JAVA_HOME=$(cygpath --path --windows "$JAVA_HOME")
+  [ -n "$CLASSPATH" ] &&
+    CLASSPATH=$(cygpath --path --windows "$CLASSPATH")
+  [ -n "$MAVEN_PROJECTBASEDIR" ] &&
+    MAVEN_PROJECTBASEDIR=$(cygpath --path --windows "$MAVEN_PROJECTBASEDIR")
+fi
+
+# Provide a "standardized" way to retrieve the CLI args that will
+# work with both Windows and non-Windows executions.
+MAVEN_CMD_LINE_ARGS="$MAVEN_CONFIG $*"
+export MAVEN_CMD_LINE_ARGS
+
+WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain
+
+# shellcheck disable=SC2086 # safe args
+exec "$JAVACMD" \
+  $MAVEN_OPTS \
+  $MAVEN_DEBUG_OPTS \
+  -classpath "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar" \
+  "-Dmaven.multiModuleProjectDirectory=${MAVEN_PROJECTBASEDIR}" \
+  ${WRAPPER_LAUNCHER} $MAVEN_CONFIG "$@"

010_spring_boot/api_rest/api2/mvnw.cmd

@@ -0,0 +1,205 @@
+@REM ----------------------------------------------------------------------------
+@REM Licensed to the Apache Software Foundation (ASF) under one
+@REM or more contributor license agreements.  See the NOTICE file
+@REM distributed with this work for additional information
+@REM regarding copyright ownership.  The ASF licenses this file
+@REM to you under the Apache License, Version 2.0 (the
+@REM "License"); you may not use this file except in compliance
+@REM with the License.  You may obtain a copy of the License at
+@REM
+@REM    https://www.apache.org/licenses/LICENSE-2.0
+@REM
+@REM Unless required by applicable law or agreed to in writing,
+@REM software distributed under the License is distributed on an
+@REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+@REM KIND, either express or implied.  See the License for the
+@REM specific language governing permissions and limitations
+@REM under the License.
+@REM ----------------------------------------------------------------------------
+
+@REM ----------------------------------------------------------------------------
+@REM Apache Maven Wrapper startup batch script, version 3.2.0
+@REM
+@REM Required ENV vars:
+@REM JAVA_HOME - location of a JDK home dir
+@REM
+@REM Optional ENV vars
+@REM MAVEN_BATCH_ECHO - set to 'on' to enable the echoing of the batch commands
+@REM MAVEN_BATCH_PAUSE - set to 'on' to wait for a keystroke before ending
+@REM MAVEN_OPTS - parameters passed to the Java VM when running Maven
+@REM     e.g. to debug Maven itself, use
+@REM set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000
+@REM MAVEN_SKIP_RC - flag to disable loading of mavenrc files
+@REM ----------------------------------------------------------------------------
+
+@REM Begin all REM lines with '@' in case MAVEN_BATCH_ECHO is 'on'
+@echo off
+@REM set title of command window
+title %0
+@REM enable echoing by setting MAVEN_BATCH_ECHO to 'on'
+@if "%MAVEN_BATCH_ECHO%" == "on"  echo %MAVEN_BATCH_ECHO%
+
+@REM set %HOME% to equivalent of $HOME
+if "%HOME%" == "" (set "HOME=%HOMEDRIVE%%HOMEPATH%")
+
+@REM Execute a user defined script before this one
+if not "%MAVEN_SKIP_RC%" == "" goto skipRcPre
+@REM check for pre script, once with legacy .bat ending and once with .cmd ending
+if exist "%USERPROFILE%\mavenrc_pre.bat" call "%USERPROFILE%\mavenrc_pre.bat" %*
+if exist "%USERPROFILE%\mavenrc_pre.cmd" call "%USERPROFILE%\mavenrc_pre.cmd" %*
+:skipRcPre
+
+@setlocal
+
+set ERROR_CODE=0
+
+@REM To isolate internal variables from possible post scripts, we use another setlocal
+@setlocal
+
+@REM ==== START VALIDATION ====
+if not "%JAVA_HOME%" == "" goto OkJHome
+
+echo.
+echo Error: JAVA_HOME not found in your environment. >&2
+echo Please set the JAVA_HOME variable in your environment to match the >&2
+echo location of your Java installation. >&2
+echo.
+goto error
+
+:OkJHome
+if exist "%JAVA_HOME%\bin\java.exe" goto init
+
+echo.
+echo Error: JAVA_HOME is set to an invalid directory. >&2
+echo JAVA_HOME = "%JAVA_HOME%" >&2
+echo Please set the JAVA_HOME variable in your environment to match the >&2
+echo location of your Java installation. >&2
+echo.
+goto error
+
+@REM ==== END VALIDATION ====
+
+:init
+
+@REM Find the project base dir, i.e. the directory that contains the folder ".mvn".
+@REM Fallback to current working directory if not found.
+
+set MAVEN_PROJECTBASEDIR=%MAVEN_BASEDIR%
+IF NOT "%MAVEN_PROJECTBASEDIR%"=="" goto endDetectBaseDir
+
+set EXEC_DIR=%CD%
+set WDIR=%EXEC_DIR%
+:findBaseDir
+IF EXIST "%WDIR%"\.mvn goto baseDirFound
+cd ..
+IF "%WDIR%"=="%CD%" goto baseDirNotFound
+set WDIR=%CD%
+goto findBaseDir
+
+:baseDirFound
+set MAVEN_PROJECTBASEDIR=%WDIR%
+cd "%EXEC_DIR%"
+goto endDetectBaseDir
+
+:baseDirNotFound
+set MAVEN_PROJECTBASEDIR=%EXEC_DIR%
+cd "%EXEC_DIR%"
+
+:endDetectBaseDir
+
+IF NOT EXIST "%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config" goto endReadAdditionalConfig
+
+@setlocal EnableExtensions EnableDelayedExpansion
+for /F "usebackq delims=" %%a in ("%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config") do set JVM_CONFIG_MAVEN_PROPS=!JVM_CONFIG_MAVEN_PROPS! %%a
+@endlocal & set JVM_CONFIG_MAVEN_PROPS=%JVM_CONFIG_MAVEN_PROPS%
+
+:endReadAdditionalConfig
+
+SET MAVEN_JAVA_EXE="%JAVA_HOME%\bin\java.exe"
+set WRAPPER_JAR="%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.jar"
+set WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain
+
+set WRAPPER_URL="https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.2.0/maven-wrapper-3.2.0.jar"
+
+FOR /F "usebackq tokens=1,2 delims==" %%A IN ("%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.properties") DO (
+    IF "%%A"=="wrapperUrl" SET WRAPPER_URL=%%B
+)
+
+@REM Extension to allow automatically downloading the maven-wrapper.jar from Maven-central
+@REM This allows using the maven wrapper in projects that prohibit checking in binary data.
+if exist %WRAPPER_JAR% (
+    if "%MVNW_VERBOSE%" == "true" (
+        echo Found %WRAPPER_JAR%
+    )
+) else (
+    if not "%MVNW_REPOURL%" == "" (
+        SET WRAPPER_URL="%MVNW_REPOURL%/org/apache/maven/wrapper/maven-wrapper/3.2.0/maven-wrapper-3.2.0.jar"
+    )
+    if "%MVNW_VERBOSE%" == "true" (
+        echo Couldn't find %WRAPPER_JAR%, downloading it ...
+        echo Downloading from: %WRAPPER_URL%
+    )
+
+    powershell -Command "&{"^
+		"$webclient = new-object System.Net.WebClient;"^
+		"if (-not ([string]::IsNullOrEmpty('%MVNW_USERNAME%') -and [string]::IsNullOrEmpty('%MVNW_PASSWORD%'))) {"^
+		"$webclient.Credentials = new-object System.Net.NetworkCredential('%MVNW_USERNAME%', '%MVNW_PASSWORD%');"^
+		"}"^
+		"[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; $webclient.DownloadFile('%WRAPPER_URL%', '%WRAPPER_JAR%')"^
+		"}"
+    if "%MVNW_VERBOSE%" == "true" (
+        echo Finished downloading %WRAPPER_JAR%
+    )
+)
+@REM End of extension
+
+@REM If specified, validate the SHA-256 sum of the Maven wrapper jar file
+SET WRAPPER_SHA_256_SUM=""
+FOR /F "usebackq tokens=1,2 delims==" %%A IN ("%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.properties") DO (
+    IF "%%A"=="wrapperSha256Sum" SET WRAPPER_SHA_256_SUM=%%B
+)
+IF NOT %WRAPPER_SHA_256_SUM%=="" (
+    powershell -Command "&{"^
+       "$hash = (Get-FileHash \"%WRAPPER_JAR%\" -Algorithm SHA256).Hash.ToLower();"^
+       "If('%WRAPPER_SHA_256_SUM%' -ne $hash){"^
+       "  Write-Output 'Error: Failed to validate Maven wrapper SHA-256, your Maven wrapper might be compromised.';"^
+       "  Write-Output 'Investigate or delete %WRAPPER_JAR% to attempt a clean download.';"^
+       "  Write-Output 'If you updated your Maven version, you need to update the specified wrapperSha256Sum property.';"^
+       "  exit 1;"^
+       "}"^
+       "}"
+    if ERRORLEVEL 1 goto error
+)
+
+@REM Provide a "standardized" way to retrieve the CLI args that will
+@REM work with both Windows and non-Windows executions.
+set MAVEN_CMD_LINE_ARGS=%*
+
+%MAVEN_JAVA_EXE% ^
+  %JVM_CONFIG_MAVEN_PROPS% ^
+  %MAVEN_OPTS% ^
+  %MAVEN_DEBUG_OPTS% ^
+  -classpath %WRAPPER_JAR% ^
+  "-Dmaven.multiModuleProjectDirectory=%MAVEN_PROJECTBASEDIR%" ^
+  %WRAPPER_LAUNCHER% %MAVEN_CONFIG% %*
+if ERRORLEVEL 1 goto error
+goto end
+
+:error
+set ERROR_CODE=1
+
+:end
+@endlocal & set ERROR_CODE=%ERROR_CODE%
+
+if not "%MAVEN_SKIP_RC%"=="" goto skipRcPost
+@REM check for post script, once with legacy .bat ending and once with .cmd ending
+if exist "%USERPROFILE%\mavenrc_post.bat" call "%USERPROFILE%\mavenrc_post.bat"
+if exist "%USERPROFILE%\mavenrc_post.cmd" call "%USERPROFILE%\mavenrc_post.cmd"
+:skipRcPost
+
+@REM pause the script if MAVEN_BATCH_PAUSE is set to 'on'
+if "%MAVEN_BATCH_PAUSE%"=="on" pause
+
+if "%MAVEN_TERMINATE_CMD%"=="on" exit %ERROR_CODE%
+
+cmd /C exit /B %ERROR_CODE%

010_spring_boot/api_rest/api2/pom.xml

@@ -0,0 +1,85 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+	<modelVersion>4.0.0</modelVersion>
+	<parent>
+		<groupId>org.springframework.boot</groupId>
+		<artifactId>spring-boot-starter-parent</artifactId>
+		<version>3.1.3</version>
+		<relativePath/> <!-- lookup parent from repository -->
+	</parent>
+	<groupId>med.voll</groupId>
+	<artifactId>api</artifactId>
+	<version>0.0.1-SNAPSHOT</version>
+	<name>api</name>
+	<description>API Rest para clínica Voll</description>
+	<properties>
+		<java.version>17</java.version>
+	</properties>
+	<dependencies>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-web</artifactId>
+		</dependency>
+
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-devtools</artifactId>
+			<scope>runtime</scope>
+			<optional>true</optional>
+		</dependency>
+		<dependency>
+			<groupId>org.projectlombok</groupId>
+			<artifactId>lombok</artifactId>
+			<optional>true</optional>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-test</artifactId>
+			<scope>test</scope>
+		</dependency>
+
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-data-jpa</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>org.flywaydb</groupId>
+			<artifactId>flyway-core</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>org.flywaydb</groupId>
+			<artifactId>flyway-mysql</artifactId>
+		</dependency>
+
+		<dependency>
+			<groupId>com.mysql</groupId>
+			<artifactId>mysql-connector-j</artifactId>
+			<scope>runtime</scope>
+		</dependency>
+
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-validation</artifactId>
+		</dependency>
+
+	</dependencies>
+
+	<build>
+		<plugins>
+			<plugin>
+				<groupId>org.springframework.boot</groupId>
+				<artifactId>spring-boot-maven-plugin</artifactId>
+				<configuration>
+					<excludes>
+						<exclude>
+							<groupId>org.projectlombok</groupId>
+							<artifactId>lombok</artifactId>
+						</exclude>
+					</excludes>
+				</configuration>
+			</plugin>
+		</plugins>
+	</build>
+
+</project>

010_spring_boot/api_rest/api2/src/main/java/med/voll/api/ApiApplication.java

@@ -0,0 +1,13 @@
+package med.voll.api;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+public class ApiApplication {
+
+	public static void main(String[] args) {
+		SpringApplication.run(ApiApplication.class, args);
+	}
+
+}

010_spring_boot/api_rest/api2/src/main/java/med/voll/api/controller/HelloController.java

@@ -0,0 +1,16 @@
+package med.voll.api.controller;
+
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequestMapping("/hello")
+public class HelloController {
+
+    @GetMapping
+    public String helloWorld() {
+        return "Hello World! Test AutoReload";
+    }
+
+}

010_spring_boot/api_rest/api2/src/main/java/med/voll/api/controller/MedicoController.java

@@ -0,0 +1,87 @@
+package med.voll.api.controller;
+
+import jakarta.transaction.Transactional;
+import jakarta.validation.Valid;
+import med.voll.api.direccion.DatosDireccion;
+import med.voll.api.medico.*;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.web.PageableDefault;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.web.util.UriComponentsBuilder;
+
+import java.net.URI;
+
+@RestController
+@RequestMapping("/medicos")
+public class MedicoController {
+
+    /* No es recomendable usar @Autowired a nivel de declaración pues genera
+     problemas al realizar pruebas unitarias */
+    @Autowired
+    private MedicoRepository medicoRepository;
+
+    @PostMapping
+    public ResponseEntity<DatosRespuestaMedico> registrarMedico(
+                                                           @RequestBody @Valid DatosRegistroMedico datosRegistroMedico,
+                                                           UriComponentsBuilder uriComponentsBuilder) {
+        Medico medico = medicoRepository.save(new Medico(datosRegistroMedico));
+        DatosRespuestaMedico  datosRespuestaMedico = new DatosRespuestaMedico(
+                medico.getId(), medico.getNombre(), medico.getEmail(), medico.getTelefono(), medico.getDocumento(),
+                new DatosDireccion(
+                        medico.getDireccion().getCalle(), medico.getDireccion().getDistrito(), medico.getDireccion().getCiudad(),
+                        medico.getDireccion().getNumero(), medico.getDireccion().getComplemento()
+                )
+        );
+        URI url = uriComponentsBuilder.path("/medicos/{id}") .buildAndExpand(medico.getId()).toUri();
+        return  ResponseEntity.created(url).body(datosRespuestaMedico);
+        // Debe retornar 201 Created
+        // Url donde encontrar al médico ej. http://127.0.0.1:8080/medicos/xx
+    }
+
+    @GetMapping
+    public ResponseEntity<Page<DatosListadoMedicos>> listadoMedicos(@PageableDefault(size = 5) Pageable paginacion) {
+        //return medicoRepository.findAll(paginacion).map(DatosListadoMedicos::new);
+        return ResponseEntity.ok(medicoRepository.findByActivoTrue(paginacion).map(DatosListadoMedicos::new));
+    }
+
+    @PutMapping
+    @Transactional
+    public ResponseEntity<DatosRespuestaMedico> actualizarMedico(
+                                            @RequestBody @Valid DatosActualizarMedico datosActualizarMedico) {
+        Medico medico = medicoRepository.getReferenceById(datosActualizarMedico.id());
+        medico.actualizarDatos(datosActualizarMedico);
+        return ResponseEntity.ok(new DatosRespuestaMedico(
+                medico.getId(), medico.getNombre(), medico.getEmail(), medico.getTelefono(), medico.getDocumento(),
+                new DatosDireccion(
+                        medico.getDireccion().getCalle(), medico.getDireccion().getDistrito(), medico.getDireccion().getCiudad(),
+                        medico.getDireccion().getNumero(), medico.getDireccion().getComplemento()
+                )
+        ));
+    }
+
+    // Desactivar Medico
+    @DeleteMapping("/{id}")
+    @Transactional
+    public ResponseEntity eliminarMedico(@PathVariable Long id) {
+        Medico medico = medicoRepository.getReferenceById(id);
+        medico.desactivarMedico();
+        return ResponseEntity.noContent().build();
+    }
+
+    @GetMapping("/{id}")
+    public ResponseEntity<DatosRespuestaMedico> retornaDatosMedico(@PathVariable Long id) {
+        Medico medico = medicoRepository.getReferenceById(id);
+        var datosMedico = new DatosRespuestaMedico(
+                medico.getId(), medico.getNombre(), medico.getEmail(), medico.getTelefono(), medico.getDocumento(),
+                new DatosDireccion(
+                        medico.getDireccion().getCalle(), medico.getDireccion().getDistrito(), medico.getDireccion().getCiudad(),
+                        medico.getDireccion().getNumero(), medico.getDireccion().getComplemento()
+                )
+        );
+        return ResponseEntity.ok(datosMedico);
+    }
+
+}

010_spring_boot/api_rest/api2/src/main/java/med/voll/api/controller/PacienteController.java

@@ -0,0 +1,85 @@
+package med.voll.api.controller;
+
+import jakarta.transaction.Transactional;
+import jakarta.validation.Valid;
+import med.voll.api.direccion.DatosDireccion;
+import med.voll.api.paciente.*;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.web.PageableDefault;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.web.util.UriComponentsBuilder;
+
+import java.net.URI;
+
+@RestController
+@RequestMapping("/pacientes")
+public class PacienteController {
+
+    /* No es recomendable usar @Autowired a nivel de declaración pues genera
+     problemas al realizar pruebas unitarias */
+    @Autowired
+    private PacienteRepository pacienteRepository;
+
+    @PostMapping
+    public ResponseEntity<DatosRespuestaPaciente> registrarPaciente(
+                                                            @RequestBody @Valid DatosRegistroPaciente datosRegistroPaciente,
+                                                            UriComponentsBuilder uriComponentsBuilder) {
+            Paciente paciente = pacienteRepository.save(new Paciente(datosRegistroPaciente));
+            DatosRespuestaPaciente  datosRespuestaPaciente = new DatosRespuestaPaciente(
+                    paciente.getId(), paciente.getNombre(), paciente.getEmail(), paciente.getTelefono(), paciente.getDocumento(),
+                    new DatosDireccion(
+                            paciente.getDireccion().getCalle(), paciente.getDireccion().getDistrito(), paciente.getDireccion().getCiudad(),
+                            paciente.getDireccion().getNumero(), paciente.getDireccion().getComplemento()
+                    )
+            );
+            URI url = uriComponentsBuilder.path("/pacientes/{id}") .buildAndExpand(paciente.getId()).toUri();
+            return  ResponseEntity.created(url).body(datosRespuestaPaciente);
+    }
+
+    @GetMapping
+    public ResponseEntity<Page<DatosListadoPacientes>> listadoPacientes(@PageableDefault(size = 5) Pageable paginacion) {
+        //return pacienteRepository.findAll(paginacion).map(DatosListadoPacientes::new);
+        return ResponseEntity.ok(pacienteRepository.findByActivoTrue(paginacion).map(DatosListadoPacientes::new));
+    }
+
+    @PutMapping
+    @Transactional
+    public ResponseEntity<DatosRespuestaPaciente> actualizarPaciente(@RequestBody @Valid DatosActualizarPaciente datosActualizarPaciente) {
+        Paciente paciente = pacienteRepository.getReferenceById(datosActualizarPaciente.id());
+        paciente.actualizarDatos(datosActualizarPaciente);
+        return ResponseEntity.ok(new DatosRespuestaPaciente(
+                paciente.getId(), paciente.getNombre(), paciente.getEmail(), paciente.getTelefono(), paciente.getDocumento(),
+                new DatosDireccion(
+                        paciente.getDireccion().getCalle(), paciente.getDireccion().getDistrito(),
+                        paciente.getDireccion().getCiudad(),paciente.getDireccion().getNumero(),
+                        paciente.getDireccion().getComplemento()
+                )
+        ));
+    }
+
+    // Desactivar Paciente
+    @DeleteMapping("/{id}")
+    @Transactional
+    public ResponseEntity eliminarPaciente(@PathVariable Long id) {
+        Paciente paciente = pacienteRepository.getReferenceById(id);
+        paciente.desactivarPaciente();
+        return ResponseEntity.noContent().build();
+    }
+
+    @GetMapping("/{id}")
+    public ResponseEntity<DatosRespuestaPaciente> retornaDatosPaciente(@PathVariable Long id) {
+        Paciente paciente = pacienteRepository.getReferenceById(id);
+        var datosPaciente = new DatosRespuestaPaciente(
+                paciente.getId(), paciente.getNombre(), paciente.getEmail(), paciente.getTelefono(), paciente.getDocumento(),
+                new DatosDireccion(
+                        paciente.getDireccion().getCalle(), paciente.getDireccion().getDistrito(), paciente.getDireccion().getCiudad(),
+                        paciente.getDireccion().getNumero(), paciente.getDireccion().getComplemento()
+                )
+        );
+        return ResponseEntity.ok(datosPaciente);
+    }
+
+}

010_spring_boot/api_rest/api2/src/main/java/med/voll/api/direccion/DatosDireccion.java

@@ -0,0 +1,11 @@
+package med.voll.api.direccion;
+
+import jakarta.validation.constraints.NotBlank;
+
+public record DatosDireccion(
+        @NotBlank String calle,
+        @NotBlank String distrito,
+        @NotBlank  String ciudad,
+        String numero,
+        String complemento) {
+}

010_spring_boot/api_rest/api2/src/main/java/med/voll/api/direccion/Direccion.java

@@ -0,0 +1,36 @@
+package med.voll.api.direccion;
+
+import jakarta.persistence.Embeddable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Embeddable
+@Getter
+@NoArgsConstructor
+@AllArgsConstructor
+public class Direccion {
+
+    private String calle;
+    private String numero;
+    private String complemento;
+    private String distrito;
+    private String ciudad;
+
+    public Direccion(DatosDireccion direccion) {
+        this.calle = direccion.calle();
+        this.numero = direccion.numero();
+        this.complemento = direccion.complemento();
+        this.distrito = direccion.distrito();
+        this.ciudad = direccion.ciudad();
+    }
+
+    public Direccion actualizarDatosDireccion(DatosDireccion direccion) {
+        this.calle = direccion.calle();
+        this.numero = direccion.numero();
+        this.complemento = direccion.complemento();
+        this.distrito = direccion.distrito();
+        this.ciudad = direccion.ciudad();
+        return this;
+    }
+}

010_spring_boot/api_rest/api2/src/main/java/med/voll/api/medico/DatosActualizarMedico.java

@@ -0,0 +1,8 @@
+package med.voll.api.medico;
+
+import jakarta.validation.constraints.NotNull;
+import med.voll.api.direccion.DatosDireccion;
+
+public record DatosActualizarMedico(@NotNull Long id, String nombre, String documento, DatosDireccion direccion) {
+
+}

010_spring_boot/api_rest/api2/src/main/java/med/voll/api/medico/DatosListadoMedicos.java

@@ -0,0 +1,17 @@
+package med.voll.api.medico;
+
+public record DatosListadoMedicos(
+                                  Long id,
+                                  String nombre,
+                                  String especialidad,
+                                  String documento, String email) {
+
+    public DatosListadoMedicos (Medico medico) {
+        this(medico.getId(),
+                medico.getNombre(),
+                medico.getEspecialidad().toString(),
+                medico.getDocumento(),
+                medico.getEmail());
+    }
+
+}

010_spring_boot/api_rest/api2/src/main/java/med/voll/api/medico/DatosRegistroMedico.java

@@ -0,0 +1,17 @@
+package med.voll.api.medico;
+
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.Email;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Pattern;
+import med.voll.api.direccion.DatosDireccion;
+
+public record DatosRegistroMedico(
+        @NotBlank String nombre,
+        @NotBlank @Email String email,
+        @NotBlank String telefono,
+        @NotBlank @Pattern(regexp = "\\d{4,6}") String documento,
+        @NotNull Especialidad especialidad,
+        @NotNull @Valid DatosDireccion direccion
+) {}

010_spring_boot/api_rest/api2/src/main/java/med/voll/api/medico/DatosRespuestaMedico.java

@@ -0,0 +1,9 @@
+package med.voll.api.medico;
+
+import jakarta.validation.constraints.NotNull;
+import med.voll.api.direccion.DatosDireccion;
+
+public record DatosRespuestaMedico(@NotNull Long id, String nombre,
+                                                                        String email, String telefono, String documento,
+                                                                        DatosDireccion direccion) {
+}

010_spring_boot/api_rest/api2/src/main/java/med/voll/api/medico/Especialidad.java

@@ -0,0 +1,8 @@
+package med.voll.api.medico;
+
+public enum Especialidad {
+    ORTOPEDIA,
+    CARDIOLOGIA,
+    GINECOLOGIA,
+    PEDIATRIA
+}

010_spring_boot/api_rest/api2/src/main/java/med/voll/api/medico/Medico.java

@@ -0,0 +1,57 @@
+package med.voll.api.medico;
+
+import jakarta.persistence.*;
+import lombok.AllArgsConstructor;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import med.voll.api.direccion.Direccion;
+
+@Table(name="medicos")
+@Entity(name="Medico")
+@Getter
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(of = "id")
+public class Medico {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+    private String nombre;
+    private String email;
+    private String telefono;
+    private String documento;
+    private Boolean activo;
+    @Enumerated(EnumType.STRING)
+    private Especialidad especialidad;
+    @Embedded
+    private Direccion direccion;
+
+    public Medico(DatosRegistroMedico datosRegistroMedico) {
+        this.activo = true;
+        this.nombre = datosRegistroMedico.nombre();
+        this.email = datosRegistroMedico.email();
+        this.documento = datosRegistroMedico.documento();
+        this.telefono = datosRegistroMedico.telefono();
+        this.especialidad = datosRegistroMedico.especialidad();
+        this.direccion = new Direccion(datosRegistroMedico.direccion());
+    }
+
+    public void actualizarDatos(DatosActualizarMedico datosActualizarMedico) {
+        if (datosActualizarMedico.nombre() != null) {
+            this.nombre = datosActualizarMedico.nombre();
+        }
+        if (datosActualizarMedico.documento() != null) {
+            this.documento = datosActualizarMedico.documento();
+        }
+        if (datosActualizarMedico.direccion() != null) {
+            this.direccion = direccion.actualizarDatosDireccion(datosActualizarMedico.direccion());
+        }
+    }
+
+    public void desactivarMedico() {
+        this.activo = false;
+    }
+
+}

010_spring_boot/api_rest/api2/src/main/java/med/voll/api/medico/MedicoRepository.java

@@ -0,0 +1,9 @@
+package med.voll.api.medico;
+
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface MedicoRepository extends JpaRepository<Medico, Long> {
+    Page<Medico> findByActivoTrue(Pageable paginacion);
+}

010_spring_boot/api_rest/api2/src/main/java/med/voll/api/paciente/DatosActualizarPaciente.java

@@ -0,0 +1,8 @@
+package med.voll.api.paciente;
+
+import jakarta.validation.constraints.NotNull;
+import med.voll.api.direccion.DatosDireccion;
+
+public record DatosActualizarPaciente(@NotNull Long id, String nombre, String documento, DatosDireccion direccion) {
+
+}

010_spring_boot/api_rest/api2/src/main/java/med/voll/api/paciente/DatosListadoPacientes.java

@@ -0,0 +1,12 @@
+package med.voll.api.paciente;
+
+public record DatosListadoPacientes(Long id, String nombre, String documento, String email) {
+
+    public DatosListadoPacientes(Paciente paciente) {
+        this(paciente.getId(),
+                paciente.getNombre(),
+                paciente.getDocumento(),
+                paciente.getEmail());
+    }
+
+}

010_spring_boot/api_rest/api2/src/main/java/med/voll/api/paciente/DatosRegistroPaciente.java

@@ -0,0 +1,16 @@
+package med.voll.api.paciente;
+
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.Email;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Pattern;
+import med.voll.api.direccion.DatosDireccion;
+
+public record DatosRegistroPaciente(
+        @NotBlank String nombre,
+        @NotBlank @Email String email,
+        @NotBlank String telefono,
+        @NotBlank @Pattern(regexp = "\\d{4,6}") String documento,
+        @NotNull @Valid DatosDireccion direccion
+) {}

010_spring_boot/api_rest/api2/src/main/java/med/voll/api/paciente/DatosRespuestaPaciente.java

@@ -0,0 +1,9 @@
+package med.voll.api.paciente;
+
+import jakarta.validation.constraints.NotNull;
+import med.voll.api.direccion.DatosDireccion;
+
+public record DatosRespuestaPaciente(@NotNull Long id, String nombre,
+                                     String email, String telefono, String documento,
+                                     DatosDireccion direccion) {
+}

010_spring_boot/api_rest/api2/src/main/java/med/voll/api/paciente/Paciente.java

@@ -0,0 +1,55 @@
+package med.voll.api.paciente;
+
+import jakarta.persistence.*;
+import lombok.AllArgsConstructor;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import med.voll.api.direccion.Direccion;
+import med.voll.api.medico.DatosActualizarMedico;
+
+@Table(name="pacientes")
+@Entity(name="Paciente")
+@Getter
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(of = "id")
+public class Paciente {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+    private String nombre;
+    private String email;
+    private String telefono;
+    private String documento;
+    private Boolean activo;
+    @Embedded
+    private Direccion direccion;
+
+    public Paciente(DatosRegistroPaciente datosRegistroPaciente) {
+        this.activo = true;
+        this.nombre = datosRegistroPaciente.nombre();
+        this.email = datosRegistroPaciente.email();
+        this.documento = datosRegistroPaciente.documento();
+        this.telefono = datosRegistroPaciente.telefono();
+        this.direccion = new Direccion(datosRegistroPaciente.direccion());
+    }
+
+    public void actualizarDatos(DatosActualizarPaciente datosActualizarPaciente) {
+        if (datosActualizarPaciente.nombre() != null) {
+            this.nombre = datosActualizarPaciente.nombre();
+        }
+        if (datosActualizarPaciente.documento() != null) {
+            this.documento = datosActualizarPaciente.documento();
+        }
+        if (datosActualizarPaciente.direccion() != null) {
+            this.direccion = direccion.actualizarDatosDireccion(datosActualizarPaciente.direccion());
+        }
+    }
+
+    public void desactivarPaciente() {
+        this.activo = false;
+    }
+
+}

010_spring_boot/api_rest/api2/src/main/java/med/voll/api/paciente/PacienteRepository.java

@@ -0,0 +1,9 @@
+package med.voll.api.paciente;
+
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface PacienteRepository extends JpaRepository<Paciente, Long> {
+    Page<Paciente> findByActivoTrue(Pageable paginacion);
+}

010_spring_boot/api_rest/api2/src/main/resources/application.properties

@@ -0,0 +1,7 @@
+# suppress inspection "SpellCheckingInspection" for whole file
+spring.datasource.url=jdbc:mysql://192.168.0.8/vollmed_api2
+spring.datasource.username=alura
+spring.datasource.password=alura
+
+spring.jpa.show-sql=true
+spring.jpa.properties.hibernate.format_sql=true

010_spring_boot/api_rest/api2/src/main/resources/db/migration/V1__create-table-medicos.sql

@@ -0,0 +1,17 @@
+create table medicos(
+
+    id bigint not null auto_increment,
+    nombre varchar(100) not null,
+    email varchar(100) not null unique,
+    documento varchar(6) not null unique,
+    especialidad varchar(100) not null,
+    telefono varchar(20) not null,
+    calle varchar(100) not null,
+    distrito varchar(100) not null,
+    complemento varchar(100),
+    numero varchar(20),
+    ciudad varchar(100) not null,
+
+    primary key(id)
+
+);

010_spring_boot/api_rest/api2/src/main/resources/db/migration/V2__create-table-pacientes.sql

@@ -0,0 +1,16 @@
+create table pacientes(
+
+    id bigint not null auto_increment,
+    nombre varchar(100) not null,
+    email varchar(100) not null unique,
+    documento varchar(6) not null unique,
+    telefono varchar(20) not null,
+    calle varchar(100) not null,
+    distrito varchar(100) not null,
+    complemento varchar(100),
+    numero varchar(20),
+    ciudad varchar(100) not null,
+
+    primary key(id)
+
+);

010_spring_boot/api_rest/api2/src/main/resources/db/migration/V3__alter-table-medicos-add-activo.sql

@@ -0,0 +1,2 @@
+alter table medicos add activo tinyint;
+update medicos set activo=1;

010_spring_boot/api_rest/api2/src/main/resources/db/migration/V4__alter-table-pacientes-add-activo.sql

@@ -0,0 +1,2 @@
+alter table pacientes add activo tinyint;
+update pacientes set activo=1;

010_spring_boot/api_rest/api2/src/test/java/med/voll/api/ApiApplicationTests.java

@@ -0,0 +1,13 @@
+package med.voll.api;
+
+import org.junit.jupiter.api.Test;
+import org.springframework.boot.test.context.SpringBootTest;
+
+@SpringBootTest
+class ApiApplicationTests {
+
+	@Test
+	void contextLoads() {
+	}
+
+}

010_spring_boot/populate_vollmed_db/populate_medicos.sql

@@ -1,5 +1,4 @@
-USE vollmed_api;
+INSERT INTO medicos(nombre, email, telefono, documento, especialidad, calle, distrito, complemento, ciudad, numero)
-INSERT INTO vollmed_api.medicos(nombre, email, telefono, documento, especialidad, calle, distrito, complemento, ciudad, numero)
  VALUES
     ('Cuarto Medico',        'dr_4@voll.med',  '44444', '444444', 'CARDIOLOGIA', 'calle 4',  'distrito 4',  'prueba', 'Santiago', '4'),
     ('Quinto Medico',        'dr_5@voll.med',  '55555', '555555', 'PEDIATRIA',   'calle 5',  'distrito 5',  'prueba', 'Santiago', '5'),

010_spring_boot/populate_vollmed_db/populate_pacientes.sql

@@ -1,5 +1,4 @@
-USE vollmed_api;
+INSERT INTO pacientes(nombre, email, telefono, documento, calle, distrito, complemento, ciudad, numero)
-INSERT INTO vollmed_api.pacientes(nombre, email, telefono, documento, calle, distrito, complemento, ciudad, numero)
  VALUES
     ('Cuarto Paciente',        'paciente_4@private.cl',  '44444', '444444', 'calle 4',  'distrito 4',  'prueba', 'Santiago', '4'),
     ('Quinto Paciente',        'paciente_5@private.cl',  '55555', '555555', 'calle 5',  'distrito 5',  'prueba', 'Santiago', '5'),

010_spring_boot/spring_boot_1.md

@@ -874,4 +874,174 @@ public record DatosActualizarMedico(
 
 ----
 
+<br>
+
+## Requests a la API
+
+Prueba inicial método **GET** a URL `http://127.0.0.1:8080/hello` según mapeo en
+[HelloController](./api_rest/api/src/main/java/med/voll/api/controller/HelloController.java)
+
+### POST
+
+<details>
+
+<summary markdown="span">Registrar médicos con método <b>POST</b> a URL
+<code>http://127.0.0.1:8080/medicos</code></summary>
+
+```json
+{
+    "nombre": "Primer Medico",
+    "email": "medico1@voll.med",
+    "telefono": "1111111",
+    "documento": "111111",
+    "especialidad": "PEDIATRIA",
+    "direccion": {
+        "calle": "calle 1",
+        "distrito": "distrito 1",
+        "complemento": "uno",
+        "ciudad": "Santiago",
+        "numero": "1"
+    }
+}
+```
+
+```json
+{
+    "nombre": "Segundo Medico",
+    "email": "medico2@voll.med",
+    "telefono": "222222",
+    "documento": "222222",
+    "especialidad": "ORTOPEDIA",
+    "direccion": {
+        "calle": "calle 2",
+        "distrito": "distrito 2",
+        "complemento": "dos",
+        "ciudad": "Santiago",
+        "numero": "2"
+    }
+}
+```
+
+```json
+{
+    "nombre": "Tercer Medico",
+    "email": "dr_3@voll.med",
+    "telefono": "33333",
+    "documento": "333333",
+    "especialidad": "GINECOLOGIA",
+    "direccion": {
+        "calle": "calle 3",
+        "distrito": "distrito 3",
+        "ciudad": "Santiago",
+        "numero": "3"
+    }
+}
+```
+
+</details>
+
+<br>
+
+<details>
+
+<summary markdown="span">Registrar pacientes con método <b>POST</b> a URL
+<code>http://127.0.0.1:8080/pacientes</code></summary>
+
+```json
+{
+    "nombre": "Primer Paciente",
+    "email": "paciente1@private.cl",
+    "telefono": "1111111",
+    "documento": "111111",
+    "direccion": {
+        "calle": "calle 1",
+        "distrito": "distrito 1",
+        "complemento": "uno",
+        "ciudad": "Santiago",
+        "numero": "1"
+    }
+}
+```
+
+```json
+{
+    "nombre": "Segundo Paciente",
+    "email": "paciente2@private.cl",
+    "telefono": "222222",
+    "documento": "222222",
+    "direccion": {
+        "calle": "calle 2",
+        "distrito": "distrito 2",
+        "complemento": "dos",
+        "ciudad": "Santiago",
+        "numero": "2"
+    }
+}
+```
+
+```json
+{
+    "nombre": "Tercer Paciente",
+    "email": "paciente3@private.cl",
+    "telefono": "33333",
+    "documento": "333333",
+    "direccion": {
+        "calle": "calle 3",
+        "distrito": "distrito 3",
+        "ciudad": "Santiago",
+        "numero": "3"
+    }
+}
+```
+
+</details>
+
+### GET
+
+Listar medicos con método **GET** a URL
+`http://127.0.0.1:8080/medicos?size=20&sort=id`
+
+Listar pacientres con método **GET** a URL
+`http://127.0.0.1:8080/pacientes?sort=id,desc`
+
+### PUT
+
+<details>
+
+<summary markdown="span">Modificar médico con método <b>PUT</b> a URL
+<code>http://127.0.0.1:8080/medicos</code></summary>
+
+```json
+{
+    "id": 3,
+    "nombre": "3er Medico"
+}
+```
+
+</details>
+
+<br>
+
+<details>
+
+<summary markdown="span">Modificar paciente con método <b>PUT</b> a URL
+<code>http://127.0.0.1:8080/paciente</code></summary>
+
+```json
+{
+    "id": 3,
+    "nombre": "3er Paciente"
+}
+```
+
+</details>
+
+### DELETE
+
+Borrar médico con método **DELETE** a URL `http://127.0.0.1:8080/medicos/3`
+
+Borrar paciente con método **DELETE** a URL `http://127.0.0.1:8080/pacientes/3`
+
+---
+
 Continua en [Buenas prácticas y protección de una API Rest](./spring_boot_2.md)

010_spring_boot/spring_boot_2.md

@@ -0,0 +1,167 @@
+# API Rest Java - Buenas prácticas y protección
+
+Continuación de [Desarrollo de una API Rest](./spring_boot_1.md) donde se vio:
+
+- Creación de un API Rest
+- Crud (Create, Read, Update, Delete)
+- Validaciones
+- Paginación y orden
+
+### Objetivos
+
+- Buenas prácticas al desarrollar un API
+- Tratamiento de errores
+- Autenticación y Autorización
+- Tokens JWT
+
+## Buenas prácticas
+
+Se modifican las respuestas de la API
+
+[DatosRespuestaMedico](./api_rest/api2/src/main/java/med/voll/api/medico/DatosRespuestaMedico.java)
+
+```java
+public record DatosRespuestaMedico(
+                        @NotNull Long id, String nombre,
+                        String email, String telefono, String documento,
+                        DatosDireccion direccion) {}
+```
+
+[MedicoController](./api_rest/api2/src/main/java/med/voll/api/controller/MedicoController.java)
+
+```java
+@RestController
+@RequestMapping("/medicos")
+public class MedicoController {
+
+    @Autowired
+    private MedicoRepository medicoRepository;
+
+    @PostMapping
+    public ResponseEntity<DatosRespuestaMedico> registrarMedico(
+                @RequestBody @Valid DatosRegistroMedico datosRegistroMedico,
+                UriComponentsBuilder uriComponentsBuilder) {
+        Medico medico = medicoRepository.save(new Medico(datosRegistroMedico));
+        DatosRespuestaMedico datosRespuestaMedico = new DatosRespuestaMedico(
+                medico.getId(),
+                medico.getNombre(),
+                medico.getEmail(),
+                medico.getTelefono(),
+                medico.getDocumento(),
+                new DatosDireccion(
+                        medico.getDireccion().getCalle(),
+                        medico.getDireccion().getDistrito(),
+                        medico.getDireccion().getCiudad(),
+                        medico.getDireccion().getNumero(),
+                        medico.getDireccion().getComplemento()
+                )
+        );
+        URI url = uriComponentsBuilder.path("/medicos/{id}")
+                    .buildAndExpand(medico.getId()).toUri();
+        return  ResponseEntity.created(url).body(datosRespuestaMedico);
+    }
+
+    @GetMapping
+    public Page<DatosListadoMedicos> listadoMedicos(@PageableDefault(size = 5)
+                Pageable paginacion) {
+        return medicoRepository.findByActivoTrue(paginacion)
+                .map(DatosListadoMedicos::new);
+    }
+
+    @PutMapping
+    @Transactional
+    public ResponseEntity actualizarMedico(@RequestBody @Valid DatosActualizarMedico
+        datosActualizarMedico) {
+        Medico medico = medicoRepository.getReferenceById(datosActualizarMedico.id());
+        medico.actualizarDatos(datosActualizarMedico);
+        return ResponseEntity.ok(
+            new DatosRespuestaMedico(
+                medico.getId(),
+                medico.getNombre(),
+                medico.getEmail(),
+                medico.getTelefono(),
+                medico.getDocumento(),
+                new DatosDireccion(
+                        medico.getDireccion().getCalle(),
+                        medico.getDireccion().getDistrito(),
+                        medico.getDireccion().getCiudad(),
+                        medico.getDireccion().getNumero(),
+                        medico.getDireccion().getComplemento()
+                )
+        ));
+    }
+
+    @DeleteMapping("/{id}")
+    @Transactional
+    public ResponseEntity eliminarMedico(@PathVariable Long id) {
+        Medico medico = medicoRepository.getReferenceById(id);
+        medico.desactivarMedico();
+        return ResponseEntity.noContent().build();
+    }
+}
+```
+
+## Codigos de respuesta del protocolo HTTP
+
+El protocolo HTTP (***Hypertext Transfer Protocol***, *RFC 2616*) es el protocolo
+encargado de realizar la comunicación entre el cliente, que suele ser un
+navegador, y el servidor. De esta forma, para cada *solicitud* realizada por el
+cliente, el servidor responde si tuvo éxito o no. Si no tiene éxito, la mayoría
+de las veces, la respuesta del servidor será una secuencia numérica acompañada
+de un mensaje.
+
+Categoría de código
+Los códigos **HTTP** (o **HTTPS**) tienen tres dígitos, y el primer dígito
+representa la clasificación dentro de las cinco categorías posibles.
+
+- **`1XX` Informativo:** la solicitud fue aceptada o el proceso aún está en curso
+- **`2XX` Confirmación:** la acción se completó o se comprendió
+- **`3XX` Redirección:** indica que se debe hacer o se debió hacer algo más para
+completar la solicitud
+- **`4XX` Error del cliente:** indica que la solicitud no se puede completar o
+contiene una sintaxis incorrecta
+- **`5XX` Error del servidor:** el servidor falló al concluir la solicitud.
+
+### Principales códigos de error
+
+Estos permiten comprender mejor la comunicación de su navegador con el servidor
+de la aplicación que se intenta acceder.
+
+#### Error 403
+
+El código 403 es el error **"Prohibido"**. Significa que el servidor entendió
+la solicitud del cliente, pero se niega a procesarla, ya que el cliente no está
+autorizado para hacerlo.
+
+#### Error 404
+
+Mensaje de Error 404, significa que la URL no lo llevó a ninguna parte.
+Puede ser que la aplicación ya no exista, que la URL haya cambiado o que haya
+ingresado una URL incorrecta.
+
+#### Error 500
+
+Es un error menos común, pero aparece de vez en cuando. Este error significa que
+hay un problema con una de las bases que hace que se ejecute una aplicación.
+Básicamente, este error puede estar en el servidor que mantiene la aplicación
+en línea o en la comunicación con el sistema de archivos, que proporciona la
+infraestructura para la aplicación.
+
+#### Error 503
+
+El error 503 significa que el servicio al que se accede no está disponible
+temporalmente. Las causas comunes son un servidor que está fuera de servicio
+por mantenimiento o sobrecargado. Los ataques maliciosos como ***DDoS***
+causan mucho este problema.
+
+
+Para consultar sobre algún código HTTP, se puede usar la sgte. página:
+
+[http cat](https://http.cat)
+
+ejm consulta por código `405 Method Not Allowed`
+
+```http
+https://http.cat/405
+```
+

README.md

@@ -44,7 +44,7 @@ primoridiales en programación con Javascript
   - [java.util](./008_java_oo/java_util.md)
 - Desafío Conversor [Gitea](https://gitea.kickto.net/devfzn/desafio_conversor) -
 [Github](https://github.com/DevFzn/Desafio_Conversor)
-- [Emprendimiento](./009_emprendimiento/)
+- [Emprendimiento](./009_emprendimiento/README.md)
 - [Spring Boot](./010_spring_boot/README.md)
   - [Base de datos](./010_spring_boot/base_de_datos.md)
   - [JDBC](./010_spring_boot/jdbc.md)