feat(spring-multimodule-example): add multi-module structure with example modules A and B

Author: igorcampos-dev

.github/workflows/spring-multimodule-example.yml

@@ -0,0 +1,37 @@
+name: spring-multimodule-example CI Build
+
+on:
+  pull_request:
+    branches: [master]
+    paths:
+      - "spring-multimodule-example/**"
+    types:
+      - opened
+      - synchronize
+      - reopened
+
+jobs:
+
+  integration-tests:
+    name: Run Unit & Integration Tests
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: spring-multimodule-example
+    strategy:
+      matrix:
+        distribution: [ 'temurin' ]
+        java: [ '21' ]
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - name: Set up JDK ${{ matrix.java }}
+        uses: actions/[email protected]
+        with:
+          java-version: ${{ matrix.java }}
+          distribution: ${{ matrix.distribution }}
+          cache: 'maven'
+      - name: Build and analyze
+        run: ./mvnw clean verify

pom.xml

@@ -17,6 +17,7 @@
         <module>spring-keycloak-example</module>
         <module>spring-jasper-example</module>
         <module>spring-oracle-example</module>
+        <module>spring-multimodule-example</module>
     </modules>
 
 </project>

spring-multimodule-example/.mvn/wrapper/maven-wrapper.properties

@@ -0,0 +1,2 @@
+distributionType=only-script
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.11/apache-maven-3.9.11-bin.zip

spring-multimodule-example/README.md

@@ -0,0 +1,10 @@
+# spring-multimodule-sample
+
+This project demonstrates a basic and simple configuration for a Spring application with a multi-module Maven structure.
+
+## Structure
+
+- `module-a-example`: Example module A with its own code and dependencies.
+- `module-b-example`: Example module B with its own code and dependencies.
+
+Each module is managed independently but can share code and dependencies through the parent `pom.xml`.

spring-multimodule-example/module-a-example/pom.xml

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<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>sample.multimodule</groupId>
+        <artifactId>sample.multimodule</artifactId>
+        <version>1.0.0</version>
+    </parent>
+
+    <artifactId>sample.multimodule.a</artifactId>
+    <packaging>jar</packaging>
+
+    <dependencies>
+
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+            <version>${spring.boot.version}</version>
+        </dependency>
+
+    </dependencies>
+
+</project>

spring-multimodule-example/module-a-example/src/main/java/sample/multimodule/a/Main.java

@@ -0,0 +1,18 @@
+package sample.multimodule.a;
+
+public class Main {
+
+    public static void main(String[] args) {
+        Test test = new Test();
+        test.print("Hello world from Module A");
+    }
+
+    public static class Test {
+
+        public void print(String text){
+            System.out.println(text);
+        }
+
+    }
+
+}

spring-multimodule-example/module-a-example/src/test/java/sample/multimodule/a/MainTest.java

@@ -0,0 +1,17 @@
+package sample.multimodule.a;
+
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
+public class MainTest {
+
+    @Test
+    @DisplayName("Should print text without throwing any exception")
+    void shouldPrintTextWithoutErrors() {
+        Main.Test test = new Main.Test();
+        assertDoesNotThrow(() -> test.print("Hello world from Module A"));
+    }
+
+}

spring-multimodule-example/module-b-example/pom.xml

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+
+<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>sample.multimodule</groupId>
+        <artifactId>sample.multimodule</artifactId>
+        <version>1.0.0</version>
+    </parent>
+
+    <artifactId>sample.multimodule.b</artifactId>
+    <packaging>jar</packaging>
+
+    <properties>
+        <java.version>21</java.version>
+        <spring.boot.version>3.5.6</spring.boot.version>
+    </properties>
+
+    <dependencies>
+
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+            <version>${spring.boot.version}</version>
+        </dependency>
+
+    </dependencies>
+
+</project>

spring-multimodule-example/module-b-example/src/main/java/sample/multimodule/b/Main.java

@@ -0,0 +1,18 @@
+package sample.multimodule.b;
+
+public class Main {
+
+    public static void main(String[] args) {
+        Test test = new Test();
+        test.print("Hello world from Module B");
+    }
+
+    public static class Test {
+
+        public void print(String text){
+            System.out.println(text);
+        }
+
+    }
+
+}

spring-multimodule-example/module-b-example/src/main/resources/application.yml

@@ -0,0 +1,2 @@
+application:
+  name: module-b