feat(h2): database

- add configuration
- add dependency

Author: dbacilio88

CHANGELOG.md

@@ -25,12 +25,15 @@
 - Implementación de CRUD para la entidad `Application` ejemplo básico.
 - Implementación de excepciones global para capturar y manejar excepciones personalizadas.
 - Gestion de dependencias con **Maven** y **Gradle**
+---
 
 
-### Cambiado
-- No cambios.
+### Cambiado 2024-11-11
+- Entorno de Desarrollo y Pruebas: Velocidad, Simplicidad, Reseteo Rápido
+- Cambio archivos de configuración: application.yml
+- Cambio de dependencia base de datos H2
 
-### Corregido
-- No correcciones
+### Corregido 2024-11-11
+- Nombre de paquete exceptions
 
----
+---

README.md

@@ -24,21 +24,21 @@
 # 🧩 Descripción general
 
 Este arquetipo proporciona una estructura básica para iniciar proyectos en Java utilizando el framework Spring. Está
-diseñado para facilitar el desarrollo rápido y eficiente de aplicaciones web.
+diseñado para facilitar el desarrollo rápido y eficiente de aplicaciones rest.
 
 # 🔖 Características
 
 ## 📋 Requisitos
 
 Asegúrate de tener instalado:
 
-- Java OpenJDK 11
+- Java OpenJDK 21
 - Maven 3.6 o superior
 - Git
 
 | Herramienta  | Version | Recurso                                                                                                                           |
 |--------------|:-------:|-----------------------------------------------------------------------------------------------------------------------------------|
-| Java OpenJDK |   11    | [resources](https://jdk.java.net/java-se-ri/11-MR3)                                                                               |
+| Java OpenJDK |   21    | [resources](https://jdk.java.net/java-se-ri/21)                                                                                   |
 | Maven        |  3.6.2  | [resources](https://archive.apache.org/dist/maven/maven-3/3.6.2/)                                                                 |
 | Git          | latest  | [win](https://git-scm.com/downloads/win),  [mac](https://git-scm.com/downloads/mac), [linux](https://git-scm.com/downloads/linux) |
 
@@ -73,7 +73,7 @@ mvn archetype:generate \
 -DartifactId=archetype-example \
 -Dversion=1.0.0 \
 -Dversion=1.0.0 \
--DpackageName=microservice/application \
+-DpackageName=microservice \
 -Dpackage=com.example \
 -DinteractiveMode=false
 ```
@@ -88,7 +88,7 @@ mvn archetype:generate ^
 -DgroupId=com.example ^
 -DartifactId=archetype-example ^
 -Dversion=1.0.0 ^
--DpackageName=microservice/application ^
+-DpackageName=microservice ^
 -Dpackage=com.example ^
 -DinteractiveMode=false
 ```
@@ -136,17 +136,17 @@ Disk:
 
 ## 🔧 Tecnologías Usadas
 
-|  java  | Spring Boot |   Gradle   | Maven          | Branch      |
-|:------:|:-----------:|:----------:|----------------|-------------|
-| jdk-11 |     2.*     | gradle-8.5 | 3.6 o superior | [console]() |
+|    java    | Spring Boot |   Gradle   | Maven          | Branch                                                                                         |
+|:----------:|:-----------:|:----------:|----------------|------------------------------------------------------------------------------------------------|
+| openJDK-21 |     3.*     | gradle-8.5 | 3.6 o superior | [console](https://github.com/dbacilio88/archetype-api-microservices/tree/spring-boot-3-jdk-21) |
 
 ## ⚙️ Configuración rápida
 
 Incluye configuraciones predeterminadas para Spring Boot.
 
 ## 🧰 Integración de dependencias
 
-Configuración básica de Maven para gestionar dependencias.
+Configuración básica de Maven o Gradle para gestionar dependencias.
 
 ## 📦 Ejemplo de código
 
@@ -159,6 +159,8 @@ Incluye ejemplos de controladores, servicios y repositorios.
 Puedes agregar tus propios controladores, servicios y repositorios en las carpetas correspondientes. Modifica
 `application.properties` o  `application.yml` para configurar tu aplicación según sea necesario.
 
+Nota: ejecutar el componente o aplicación en perfil **`dev`**
+
 # 👨🏻‍💻 Contribuciones
 
 ¿Cómo puedes ayudar?

src/main/resources/application.yml

@@ -71,7 +71,7 @@ dependencies {
 
     // dependencies app build
     implementation group: 'org.springframework.boot', name: 'spring-boot-starter', version: '3.3.0'
-    implementation group: 'org.springframework.boot', name: 'spring-boot-starter-webflux', version: '3.3.0'
+    implementation group: 'org.springframework.boot', name: 'spring-boot-starter-web', version: '3.3.0'
     implementation group: 'org.springframework.boot', name: 'spring-boot-starter-actuator', version: '3.3.0'
     implementation group: 'org.springframework.boot', name: 'spring-boot-starter-validation', version: '3.3.0'
     implementation group: 'org.springframework.boot', name: 'spring-boot-starter-data-jpa', version: '3.3.0'
@@ -82,11 +82,11 @@ dependencies {
     implementation group: 'org.apache.logging.log4j', name: 'log4j-core', version: '2.23.1'
 
     // dependencies app database
-    implementation group: 'org.postgresql', name: 'postgresql', version: '42.7.2'
+    implementation group: 'com.h2database', name: 'h2', version: '2.2.224'
 
     // dependencies app documentation swagger
-    implementation group: 'org.springdoc', name: 'springdoc-openapi-starter-webflux-ui', version: '2.6.0'
-    implementation group: 'org.springdoc', name: 'springdoc-openapi-starter-webflux-api', version: '2.6.0'
+    implementation group: 'org.springdoc', name: 'springdoc-openapi-starter-webmvc-ui', version: '2.6.0'
+    implementation group: 'org.springdoc', name: 'springdoc-openapi-starter-webmvc-api', version: '2.6.0'
 
     //compiled annotation processor
     annotationProcessor group: 'org.springframework.boot', name: 'spring-boot-configuration-processor', version: '3.3.0'

src/main/resources/archetype-resources/build.gradle

@@ -79,9 +79,9 @@
 
         <!--dependencies app database-->
         <dependency>
-            <groupId>org.postgresql</groupId>
-            <artifactId>postgresql</artifactId>
-            <version>42.7.4</version>
+            <groupId>com.h2database</groupId>
+            <artifactId>h2</artifactId>
+            <scope>runtime</scope>
         </dependency>
 
         <!--dependencies app documentation swagger-->
@@ -133,11 +133,6 @@
             <artifactId>spring-boot-starter-test</artifactId>
         </dependency>
 
-        <dependency>
-            <groupId>com.h2database</groupId>
-            <artifactId>h2</artifactId>
-        </dependency>
-
     </dependencies>
 
     <build>

src/main/resources/archetype-resources/pom.xml

@@ -1,6 +1,6 @@
 package ${package}.${packageName.replace('/','.')}.components.exceptions.handler;
 
-import com.example.microservice.application.components.exceptions.CommonException;
+import ${package}.${packageName.replace('/','.')}.components.exceptions.CommonException;
 import org.springframework.http.HttpStatus;
 import org.springframework.http.MediaType;
 import org.springframework.http.ResponseEntity;

src/main/resources/archetype-resources/src/main/java/__packageName__/components/exceptions/handler/GlobalExceptionHandler.java

@@ -3,12 +3,10 @@ spring:
   jpa:
     open-in-view: false
     show-sql: false
-    #database: postgresql # Postgres SQLDialect does not need to be specified explicitly using 'hibernate.dialect' (remove the property setting, and it will be selected by default)
     hibernate:
-      ddl-auto: none
+      ddl-auto: create # Creates the database schema from scratch every time the application starts. This means all existing tables are dropped and recreated, which is useful in development environments where data is not critical.
     properties:
       hibernate:
-        #dialect: org.hibernate.dialect.PostgreSQLDialect # Postgres SQLDialect does not need to be specified explicitly using 'hibernate.dialect' (remove the property setting, and it will be selected by default)
         show_sql: true
         format_sql: true
 
@@ -26,7 +24,13 @@ spring:
       maximum-pool-size: 20               # This property controls the maximum size that the pool is allowed to reach, including both idle and in-use connections. Basically this value will determine the maximum number of actual connections to the database backend, default: 10
       validation-timeout: 5000            # This property controls the maximum amount of time that a connection will be tested for aliveness. This value must be less than the :connection-timeout. The lowest accepted validation timeout is 1000ms (1 second)
 
-    url: jdbc:postgresql://localhost:5432/postgres?currentSchema=public
-    username: postgres
-    password: postgres
-    driver-class-name: org.postgresql.Driver
+    url: jdbc:h2:mem:testdb;DB_CLOSE_ON_EXIT=FALSE
+    username: sa
+    password: password
+    driver-class-name: org.h2.Driver
+
+  h2:
+    console:
+      enabled: true
+      settings:
+        trace: true

src/main/resources/archetype-resources/src/main/resources/application-dev.yml

@@ -11,12 +11,12 @@ server:
     idle-timeout: 5000
     connection-timeout: 6000
   servlet:
-    context-path: /archetype-example/v1
+    context-path: /api/v1
 
 # app spring configuration:
 spring:
   application:
-    name: archetype-example
+    name: ${artifactId}
   banner:
     location: 'classpath:/banner.txt'
   main: