From 1da41a718f1d188d5744e1db8f24d88320d66833 Mon Sep 17 00:00:00 2001
From: Philip Helger <philip@helger.com>
Date: Wed, 22 Oct 2025 15:54:07 +0200
Subject: [PATCH] Enforcing specific Java versions for compilation

---
 CHANGELOG.md |  7 +++++++
 pom.xml      | 15 +++++++++++++++
 2 files changed, 22 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b7d4237..05b839d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -19,6 +19,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - (CORE) Migration from javax to jakarta xml bind
 - (DOC) [GitHub PR#132](https://github.com/itplr-kosit/validator/pull/132) Updated the link to the example Validator scenario configuration
+- (BUILD) Support for *building and compilation* is restricted to the following Java versions:
+    - Java 11: any version &ge; 11.0.23
+    - Java 12 to 16 will not work
+    - Java 17: any version &ge; 17.0.11
+    - Java 18 to 20 will not work
+    - Any version from Java 21 onwards will work
+    - The reason for this is the usage of the `-proc:full` compiler parameter which in turn is needed for Lombok usage in JDK 23+.
 
 ### Removed
 
diff --git a/pom.xml b/pom.xml
index 438e301..4b4eada 100644
--- a/pom.xml
+++ b/pom.xml
@@ -241,6 +241,16 @@
                                 <requireMavenVersion>
                                     <version>[3.3.9,)</version>
                                 </requireMavenVersion>
+                                <requireJavaVersion>
+                                    <!-- Required for "-proc:full" required for Lombok: 
+                                      Any Java 11 (LTS) >= 11.0.23
+                                      No Java 12 to 16
+                                      Any Java 17 (LTS) >= 17.0.11
+                                      No Java 18 to 20
+                                      Any Java 21 or higher
+                                    -->
+                                    <version>[11.0.23,12),[17.0.11,18),[21,)</version>
+                                </requireJavaVersion>
                             </rules>
                         </configuration>
                     </execution>
@@ -253,6 +263,11 @@
                 <configuration>
                     <release>11</release>
                     <encoding>UTF-8</encoding>
+                    <!-- This is required for Lombok only since JDK 23
+                         Was backported to 17.0.11 and 11.0.23.
+                         See: https://inside.java/2024/06/18/quality-heads-up/ 
+                    -->
+                    <proc>full</proc>
                 </configuration>
             </plugin>