Implement unit tests

.github/workflows/unit-test.yml

@@ -0,0 +1,56 @@
+name: Run Unit Tests
+
+on:
+  pull_request:
+    branches: [ default-app ]
+  workflow_dispatch:
+    inputs:
+      snapshot:
+        description: 'CI version snapshot'
+        required: true
+        default: '5.0.0-alpha-SNAPSHOT'
+        type: choice
+        options:
+          - '5.0.0-alpha-SNAPSHOT'
+      clean_install:
+        description: 'Run clean install with -U flag if true, else false'
+        required: true
+        default: "false"
+
+jobs:
+  test:
+    name: Run Test Suite
+    runs-on: ubuntu-latest
+    container: maven:3.9.9-amazoncorretto-21-debian
+    env:
+      SNAPSHOT: ${{ inputs.snapshot || '5.0.0-alpha-SNAPSHOT' }}
+      CLEAN_INSTALL: ${{ inputs.clean_install || 'false' }}
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Cache Maven packages
+        uses: actions/cache@v4
+        with:
+          path: /root/.m2/repository
+          key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
+          restore-keys: |
+            ${{ runner.os }}-maven-
+
+      - name: Maven Install
+        run: |
+          if [ "${CLEAN_INSTALL}" = "true" ] || [ -z "${CLEAN_INSTALL}" ]; then
+            echo "clean install: ${CLEAN_INSTALL}"
+            echo "snapshot: ${SNAPSHOT}"
+            echo "Running mvn clean install with -U flag"
+            mvn clean install -U -DskipTests=true -Dci.version="${SNAPSHOT}" | grep -v "^Progress (1):"
+          else
+            echo "Running mvn install without -U flag"
+            mvn install -DskipTests=true -Dci.version="${SNAPSHOT}" | grep -v "^Progress (1):"
+          fi
+
+      - name: Run Unit Tests
+        run: |
+          mvn test -Dci.version="${SNAPSHOT}" | grep -v "^Progress (1):"
+

.gitignore

@@ -6,6 +6,7 @@ client/node_modules/
 portals/
 classes/
 target/
+test-classes/
 
 # Local configuration files
 *.local

README.md

@@ -115,6 +115,7 @@ This repository includes several tools to help maintain code quality:
 
 - See `client/README.md` for front-end development instructions.
 - See `java/README.md` for back-end/reactor development.
+- See `test/README.md` for comprehensive testing guide and workflow.
 
 ---
 

pom.xml

@@ -9,7 +9,9 @@
   </properties>
   <build>
     <sourceDirectory>java/src</sourceDirectory>
+    <testSourceDirectory>test</testSourceDirectory>
     <outputDirectory>classes</outputDirectory>
+    <testOutputDirectory>test-classes</testOutputDirectory>
     <resources>
       <resource>
         <directory>java</directory>
@@ -61,6 +63,26 @@
         <enabled>false</enabled>
       </snapshots>
     </repository>
+    <repository>
+      <id>public</id>
+      <name>Sonatype's Maven repository</name>
+      <url>https://oss.sonatype.org/content/groups/public</url>
+      <releases>
+        <enabled>true</enabled>
+      </releases>
+      <snapshots>
+        <enabled>false</enabled>
+      </snapshots>
+    </repository>
+    <repository>
+      <id>sonatype-snapshots</id>
+      <name>Sonatype Snapshots</name>
+      <url>https://central.sonatype.com/repository/maven-snapshots</url>
+      <snapshots>
+        <enabled>true</enabled>
+        <updatePolicy>always</updatePolicy>
+      </snapshots>
+    </repository>
     <repository>
       <id>3rdPartyJARs</id>
       <name>Maven repository</name>
@@ -80,6 +102,38 @@
       <version>${ci.version}</version>
       <scope>provided</scope>
     </dependency>
+    <!--  testing jars  -->
+    <!-- https://mvnrepository.com/artifact/org.junit.jupiter/junit-jupiter-api -->
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter</artifactId>
+      <version>6.0.0</version>
+      <scope>test</scope>
+    </dependency>
+    <!-- https://mvnrepository.com/artifact/org.junit.platform/junit-platform-suite -->
+    <dependency>
+      <groupId>org.junit.platform</groupId>
+      <artifactId>junit-platform-suite</artifactId>
+      <version>6.0.0</version>
+      <scope>test</scope>
+    </dependency>
+    <!-- https://mvnrepository.com/artifact/org.mockito/mockito-core -->
+    <dependency>
+      <groupId>org.mockito</groupId>
+      <artifactId>mockito-core</artifactId>
+      <version>5.18.0</version>
+      <scope>test</scope>
+      <exclusions>
+        <exclusion>
+          <groupId>net.bytebuddy</groupId>
+          <artifactId>byte-buddy</artifactId>
+        </exclusion>
+        <exclusion>
+          <groupId>org.objenesis</groupId>
+          <artifactId>objenesis</artifactId>
+        </exclusion>
+      </exclusions>
+    </dependency>
   </dependencies>
   <reporting>
     <plugins>
@@ -89,7 +143,6 @@
         <version>3.6.3</version>
         <configuration>
           <source>21</source>
-          <target>21</target>
           <encoding>UTF-8</encoding>
           <show>private</show>
           <nohelp>true</nohelp>