From e8f5b947b8614196c76a7fe61fa6febf77a948e4 Mon Sep 17 00:00:00 2001
From: Njabulo <njabulo.mwandla@gmail.com>
Date: Fri, 17 Oct 2025 11:06:02 +0200
Subject: [PATCH 1/2] BAEL-6598: Guide to Maven Toolchains usage example

---
 maven-modules/maven-toolchains/pom.xml        | 71 +++++++++++++++++++
 .../src/main/proto/addressbook.proto          | 24 +++++++
 maven-modules/maven-toolchains/toolchains.xml | 25 +++++++
 maven-modules/pom.xml                         |  1 +
 4 files changed, 121 insertions(+)
 create mode 100644 maven-modules/maven-toolchains/pom.xml
 create mode 100644 maven-modules/maven-toolchains/src/main/proto/addressbook.proto
 create mode 100644 maven-modules/maven-toolchains/toolchains.xml

diff --git a/maven-modules/maven-toolchains/pom.xml b/maven-modules/maven-toolchains/pom.xml
new file mode 100644
index 000000000000..32f949abefdd
--- /dev/null
+++ b/maven-modules/maven-toolchains/pom.xml
@@ -0,0 +1,71 @@
+<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>com.baeldung</groupId>
+        <artifactId>maven-modules</artifactId>
+        <version>0.0.1-SNAPSHOT</version>
+    </parent>
+
+    <artifactId>maven-toolchains</artifactId>
+
+    <properties>
+        <maven.compiler.source>21</maven.compiler.source>
+        <maven.compiler.target>21</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <protobuf.version>3.0.0</protobuf.version>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>com.google.protobuf</groupId>
+            <artifactId>protobuf-java</artifactId>
+            <version>3.19.4</version>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-toolchains-plugin</artifactId>
+                <version>3.2.0</version>
+                <executions>
+                    <execution>
+                        <goals>
+                            <goal>toolchain</goal>
+                        </goals>
+                    </execution>
+                </executions>
+                <configuration>
+                    <toolchains>
+                        <jdk>
+                            <version>24</version>
+                            <vendor>liberica</vendor>
+                        </jdk>
+                        <protobuf>
+                            <version>${protobuf.version}</version>
+                        </protobuf>
+                    </toolchains>
+                </configuration>
+            </plugin>
+
+            <plugin>
+                <groupId>org.xolstice.maven.plugins</groupId>
+                <artifactId>protobuf-maven-plugin</artifactId>
+                <version>0.6.1</version>
+                <extensions>true</extensions>
+                <executions>
+                    <execution>
+                        <goals>
+                            <goal>compile</goal>
+                            <goal>test-compile</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>
\ No newline at end of file
diff --git a/maven-modules/maven-toolchains/src/main/proto/addressbook.proto b/maven-modules/maven-toolchains/src/main/proto/addressbook.proto
new file mode 100644
index 000000000000..4da9f20440a5
--- /dev/null
+++ b/maven-modules/maven-toolchains/src/main/proto/addressbook.proto
@@ -0,0 +1,24 @@
+syntax = "proto3";
+
+option java_package = "com.baeldung";
+option java_multiple_files = true;
+option java_outer_classname = "AddressBookProtos";
+
+message Address {
+	string street_address = 1;
+	string city = 2;
+	string state = 3;
+	string postal_code = 4;
+}
+
+message Contact {
+	string first_name = 1;
+	string last_name = 2;
+	string email = 3;
+	string phone_number = 4;
+	Address address = 5;
+}
+
+message AddressBook {
+	repeated Contact contacts = 1;
+}
\ No newline at end of file
diff --git a/maven-modules/maven-toolchains/toolchains.xml b/maven-modules/maven-toolchains/toolchains.xml
new file mode 100644
index 000000000000..843ba4fff531
--- /dev/null
+++ b/maven-modules/maven-toolchains/toolchains.xml
@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<toolchains>
+    <!-- JDK toolchains -->
+    <toolchain>
+        <type>jdk</type>
+        <provides>
+            <version>24</version>
+            <vendor>liberica</vendor>
+        </provides>
+        <configuration>
+            <jdkHome>/opt/liberica-24</jdkHome>
+        </configuration>
+    </toolchain>
+
+    <!-- Protocol Buffers toolchains -->
+    <toolchain>
+        <type>protobuf</type>
+        <provides>
+            <version>3.0.0</version>
+        </provides>
+        <configuration>
+            <protocExecutable>/opt/protoc-3.0.0/bin/protoc</protocExecutable>
+        </configuration>
+    </toolchain>
+</toolchains>
diff --git a/maven-modules/pom.xml b/maven-modules/pom.xml
index f98b1bfad94d..61165074d5ef 100644
--- a/maven-modules/pom.xml
+++ b/maven-modules/pom.xml
@@ -60,6 +60,7 @@
         <module>multimodulemavenproject</module>
         <module>resume-from</module>
         <module>maven-multiple-repositories</module>
+        <module>maven-toolchains</module>
     </modules>
 
     <dependencyManagement>

From c4ee7bcbf15ea1034ba98798e363c6abbf385879 Mon Sep 17 00:00:00 2001
From: Njabulo <njabulo.mwandla@gmail.com>
Date: Tue, 21 Oct 2025 14:20:44 +0200
Subject: [PATCH 2/2] BAEL-6598: Guide to Maven Toolchains usage example

---
 maven-modules/pom.xml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/maven-modules/pom.xml b/maven-modules/pom.xml
index 61165074d5ef..fefba2173bc5 100644
--- a/maven-modules/pom.xml
+++ b/maven-modules/pom.xml
@@ -60,7 +60,8 @@
         <module>multimodulemavenproject</module>
         <module>resume-from</module>
         <module>maven-multiple-repositories</module>
-        <module>maven-toolchains</module>
+        <!-- Commented out maven-toolchains due to missing tools on build server -->
+<!--        <module>maven-toolchains</module>-->
     </modules>
 
     <dependencyManagement>