817 upgrade to spring boot 40x

CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## Version `4.0.0-SNAPSHOT` (unreleased)
+
+⚠️ **Breaking Change** ⚠️
+
+### 🌟 Features
+
+- **Spring Boot 4**
+    - changed from `org.hibernate:hibernate-jpamodelgen` to `hibernate-processor`
+    - changed from `org.springframework.boot:spring-boot-starter-aop` to `spring-boot-starter-aspectj`
+
+### 🐞 Bug Fixes
+
+### 🔨 Dependency Upgrades
+
+- upgraded org.springframework.boot:spring-boot-starter-parent from 3.5.14 to 4.1.0
+- upgraded org.springdoc:springdoc-openapi-starter-webmvc-ui from 2.8.17 to 3.0.3
+- upgraded net.kaczmarzyk:specification-arg-resolver from 3.4.0 to 4.1.0
+- upgraded io.sentry:sentry-spring-boot-starter-jakarta from 8.43.0 to 8.43.2
+
 ## Version `3.4.2-SNAPSHOT`
 
 ### 🌟 Features
@@ -67,7 +86,6 @@
     - The previous endpoint `POST /sentry/feedback` now only supports the new format.
     - Until the in-house implementation is completely removed, the old format will still be accepted at the endpoint `POST /sentry/feedback`.
 
-
 ### 🐞 Bug Fixes
 
 - Prevent validation error handling from crashing when a validation error has no arguments.

MIGRATION.md

@@ -1,5 +1,48 @@
 # Migration Guide
 
+## Version `4.0.0-SNAPSHOT` (unreleased)
+
+### Hibernate 7: Remove `globally_quoted_identifiers`
+
+Spring Boot 4 upgrades to Hibernate 7, which replaces the deprecated `CamelCaseToUnderscoresNamingStrategy` with `PhysicalNamingStrategySnakeCaseImpl`.
+
+**The key behavioral difference:** the new `PhysicalNamingStrategySnakeCaseImpl` skips the camelCase→snake_case conversion for **quoted** identifiers and returns them unchanged. The old `CamelCaseToUnderscoresNamingStrategy` always applied the conversion regardless of quoting status.
+
+`hibernate.globally_quoted_identifiers=true` marks **all** identifiers as quoted — including those derived internally from class and field names (e.g. `SessionToken`, `issuedAt`). The combination of both settings causes:
+
+- `SessionToken` → `SESSIONTOKEN` instead of `SESSION_TOKEN` (no underscore)
+- `issuedAt` → `issuedAt` instead of `issued_at` (no conversion)
+
+resulting in `SchemaManagementException` or incorrect table and column names.
+
+**Action required:** Remove `hibernate.globally_quoted_identifiers=true` to avoid disabling Hibernate 7 snake_case conversion for quoted identifiers.
+
+For H2-based profiles that need quoting for reserved keywords (for example columns named `key` or `value`), use targeted keyword quoting instead of global quoting:
+
+```yaml
+# Before (remove)
+spring:
+  jpa:
+    properties:
+      hibernate:
+        globally_quoted_identifiers: true
+
+# After (H2-friendly replacement)
+spring:
+  jpa:
+    properties:
+      hibernate:
+        auto_quote_keyword: true
+```
+
+This keeps reserved-word handling intact while preserving Hibernate 7 camelCase to snake_case conversion for regular identifiers.
+
+`auto_quote_keyword` quotes only identifiers that are SQL keywords for the active dialect (for example `key`, `value`) instead of forcing quotes for every table/column name.
+
+### Hibernate 7: Physical naming strategy for table names
+
+The internal implementation of `DataNamingConfig` has been updated: `PhysicalNamingStrategySnakeCaseImpl` (the replacement for the deprecated `CamelCaseToUnderscoresNamingStrategy`) skips snake_case conversion for quoted identifiers. In the current `DataNamingConfig` implementation, `toPhysicalTableName` still delegates to the superclass strategy, so custom naming strategies must not assume quoted identifiers will be unquoted automatically before conversion. Applications that override `DataNamingConfig` or configure the naming strategy directly and require snake_case conversion for quoted table identifiers must handle that explicitly.
+
 ## Version `3.4.0`
 
 ### JWT Token Verification Changes

docs/pages/devguide/started/configuration/variables.mdx

@@ -31,7 +31,7 @@ spring:
       ddl-auto: update  # Auto update DDL
     properties:
       hibernate:
-        globally_quoted_identifiers: true  # Quote all identifiers
+        auto_quote_keyword: true  # Quote only SQL keywords
   freemarker:
     enabled: false  # disable web mvc template rendering
   mvc:

essencium-backend-development-uuid/pom.xml

@@ -6,16 +6,17 @@
     <parent>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-starter-parent</artifactId>
-        <version>3.5.15</version>
+        <version>4.1.0</version>
     </parent>
 
     <groupId>de.frachtwerk</groupId>
     <artifactId>essencium-backend-development-uuid</artifactId>
-    <version>3.4.2-SNAPSHOT</version>
+    <version>4.0.0-SNAPSHOT</version>
 
     <name>${project.groupId}:${project.artifactId}</name>
-    <description>Essencium-backend-development-UUID represents a sample project for development purposes based on
-        Essencium Backend. It uses UUID as ID type for entities.
+    <description>
+        Essencium-backend-development-UUID represents a sample project for development purposes based on Essencium
+        Backend. It uses UUID as ID type for entities.
     </description>
     <url>https://www.frachtwerk.de</url>
 
@@ -161,7 +162,7 @@
             <plugin>
                 <groupId>com.cosium.code</groupId>
                 <artifactId>git-code-format-maven-plugin</artifactId>
-                <version>5.6</version>
+                <version>6.0</version>
                 <executions>
                     <execution>
                         <id>install-formatter-hook</id>
@@ -180,7 +181,7 @@
                     <dependency>
                         <groupId>com.cosium.code</groupId>
                         <artifactId>google-java-format</artifactId>
-                        <version>5.6</version>
+                        <version>6.0</version>
                     </dependency>
                 </dependencies>
             </plugin>

essencium-backend-development-uuid/src/main/java/de/frachtwerk/essencium/backend/SpringBootApp.java

@@ -25,8 +25,8 @@
 import io.swagger.v3.oas.annotations.servers.Server;
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
-import org.springframework.boot.autoconfigure.domain.EntityScan;
 import org.springframework.boot.context.properties.ConfigurationPropertiesScan;
+import org.springframework.boot.persistence.autoconfigure.EntityScan;
 import org.springframework.context.annotation.EnableAspectJAutoProxy;
 import org.springframework.data.jpa.repository.config.EnableJpaRepositories;
 

essencium-backend-development-uuid/src/main/resources/application-development.yaml

@@ -25,15 +25,24 @@ logging:
 
 server:
   port: 8098
-  error:
-    include-stacktrace: always
 
 spring:
   h2:
     console:
       enabled: true
       settings:
         trace: false
+  web:
+    error:
+      include-stacktrace: always
+  mvc:
+    log-request-details: true
+
+springdoc:
+  api-docs:
+    enabled: true
+  swagger-ui:
+    enabled: true
 
 mail:
   # See https://ethereal.email

essencium-backend-development-uuid/src/main/resources/application-h2.yaml

@@ -21,6 +21,7 @@ spring:
     driver-class-name: org.h2.Driver
     username: sa
     password: password
+    properties.hibernate.auto_quote_keyword: true
 
   jpa:
     database-platform: org.hibernate.dialect.H2Dialect

essencium-backend-development-uuid/src/main/resources/application.yaml

@@ -24,9 +24,6 @@ logging:
 
 server:
   port: 8098
-  error:
-    include-message: always
-    include-stacktrace: never
 
 spring:
   profiles:
@@ -41,15 +38,12 @@ spring:
     generate-ddl: true
     hibernate:
       ddl-auto: update
-    properties:
-      hibernate:
-        globally_quoted_identifiers: true
-  freemarker:
-    enabled: false  # disable web mvc template rendering
+
   mvc:
     pathmatch:
       matching-strategy: ant_path_matcher
     dispatch-trace-request: true
+    log-request-details: false
 
   flyway:
     enabled: false
@@ -58,6 +52,16 @@ spring:
     url: ${spring.datasource.url}
     baselineOnMigrate: true
     validate-on-migrate: true
+  web:
+    error:
+      include-message: always
+      include-stacktrace: never
+
+springdoc:
+  api-docs:
+    enabled: false
+  swagger-ui:
+    enabled: false
 
 mail:
   host: localhost

essencium-backend-development/pom.xml

@@ -6,15 +6,16 @@
     <parent>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-starter-parent</artifactId>
-        <version>3.5.15</version>
+        <version>4.1.0</version>
     </parent>
 
     <groupId>de.frachtwerk</groupId>
     <artifactId>essencium-backend-development</artifactId>
-    <version>3.4.2-SNAPSHOT</version>
+    <version>4.0.0-SNAPSHOT</version>
 
     <name>${project.groupId}:${project.artifactId}</name>
-    <description>Essencium-backend-development represents a sample project for development purposes based on Essencium
+    <description>
+        Essencium-backend-development represents a sample project for development purposes based on Essencium
         Backend. It uses Long as ID type for entities.
     </description>
     <url>https://www.frachtwerk.de</url>
@@ -161,7 +162,7 @@
             <plugin>
                 <groupId>com.cosium.code</groupId>
                 <artifactId>git-code-format-maven-plugin</artifactId>
-                <version>5.6</version>
+                <version>6.0</version>
                 <executions>
                     <execution>
                         <id>install-formatter-hook</id>
@@ -180,7 +181,7 @@
                     <dependency>
                         <groupId>com.cosium.code</groupId>
                         <artifactId>google-java-format</artifactId>
-                        <version>5.6</version>
+                        <version>6.0</version>
                     </dependency>
                 </dependencies>
             </plugin>

essencium-backend-development/src/main/java/de/frachtwerk/essencium/backend/SpringBootApp.java

@@ -25,8 +25,8 @@
 import io.swagger.v3.oas.annotations.servers.Server;
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
-import org.springframework.boot.autoconfigure.domain.EntityScan;
 import org.springframework.boot.context.properties.ConfigurationPropertiesScan;
+import org.springframework.boot.persistence.autoconfigure.EntityScan;
 import org.springframework.context.annotation.EnableAspectJAutoProxy;
 import org.springframework.data.jpa.repository.config.EnableJpaRepositories;
 

essencium-backend-development/src/main/resources/application-development.yaml

@@ -25,15 +25,24 @@ logging:
 
 server:
   port: 8098
-  error:
-    include-stacktrace: always
 
 spring:
   h2:
     console:
       enabled: true
       settings:
         trace: false
+  web:
+    error:
+      include-stacktrace: always
+  mvc:
+    log-request-details: true
+
+springdoc:
+  api-docs:
+    enabled: true
+  swagger-ui:
+    enabled: true
 
 mail:
   # See https://ethereal.email

essencium-backend-development/src/main/resources/application-h2.yaml

@@ -21,6 +21,9 @@ spring:
     driver-class-name: org.h2.Driver
     username: sa
     password: password
-
   jpa:
     database-platform: org.hibernate.dialect.H2Dialect
+    generate-ddl: true
+    hibernate:
+      ddl-auto: update
+    properties.hibernate.auto_quote_keyword: true

essencium-backend-development/src/main/resources/application.yaml

@@ -24,9 +24,6 @@ logging:
 
 server:
   port: 8098
-  error:
-    include-message: always
-    include-stacktrace: never
 
 spring:
   profiles:
@@ -41,15 +38,12 @@ spring:
     generate-ddl: true
     hibernate:
       ddl-auto: update
-    properties:
-      hibernate:
-        globally_quoted_identifiers: true
-  freemarker:
-    enabled: false  # disable web mvc template rendering
+
   mvc:
     pathmatch:
       matching-strategy: ant_path_matcher
     dispatch-trace-request: true
+    log-request-details: false
 
   flyway:
     enabled: false
@@ -58,6 +52,16 @@ spring:
     url: ${spring.datasource.url}
     baselineOnMigrate: true
     validate-on-migrate: true
+  web:
+    error:
+      include-message: always
+      include-stacktrace: never
+
+springdoc:
+  api-docs:
+    enabled: false
+  swagger-ui:
+    enabled: false
 
 mail:
   host: localhost