4PointSolutions · rmcdouga · Nov 27, 2025 · Oct 30, 2025 · Nov 14, 2025 · Nov 15, 2025
diff --git a/.github/workflows/spring-boot-jersey-starter-ci.yml b/.github/workflows/spring-boot-jersey-starter-ci.yml
@@ -0,0 +1,51 @@
+name: Spring Boot Jersey Starter CI
+
+on: 
+  push:
+    paths:
+    - 'spring/fluentforms-jersey-spring-boot-**'
+    - '.github/workflows/spring-boot-jersey-starter-ci.yml'
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: Java ${{ matrix.java }} build
+    runs-on: ubuntu-latest
+    continue-on-error: ${{ matrix.experimental }}
+    strategy:
+      fail-fast: true
+      matrix:
+        java: [ 21 ]
+        experimental: [false]
+        include:
+          - java: 25
+            experimental: true
+
+    steps:
+    - uses: actions/checkout@v6
+    - name: Set up JDK ${{ matrix.java }}
+      uses: actions/setup-java@v5
+      with:
+        distribution: 'oracle'
+        java-version: ${{ matrix.java }}
+        cache: 'maven'
+        server-id: github # Value of the distributionManagement/repository/id field of the pom.xml
+        settings-path: ${{ github.workspace }} # location for the settings.xml file
+
+    - name: Build AutoConfigure with Maven
+      run: mvn -B install -s $GITHUB_WORKSPACE/settings.xml --file spring/fluentforms-jersey-spring-boot-autoconfigure
+      env:
+        GITHUB_TOKEN: ${{ github.token }}
+
+    - name: Build AutoConfigure with Maven
+      if: (github.ref == 'refs/heads/master' || github.ref == 'refs/tags/*') &&  !matrix.experimental # Only run on main branch or tags and non-experimental
+      run: mvn -B deploy -s $GITHUB_WORKSPACE/settings.xml --file spring/fluentforms-jersey-spring-boot-autoconfigure
+      env:
+        GITHUB_TOKEN: ${{ github.token }}
+
+    - name: Publish Starter to GitHub Packages Apache Maven
+      if: (github.ref == 'refs/heads/master' || github.ref == 'refs/tags/*') &&  !matrix.experimental # Only run on main branch or tags and non-experimental
+      run: mvn -B deploy -s $GITHUB_WORKSPACE/settings.xml --file spring/fluentforms-jersey-spring-boot-starter
+      env:
+       GITHUB_TOKEN: ${{ github.token }}
+
diff --git a/.github/workflows/spring-boot-starter-ci.yml → ...rkflows/spring-boot-webmvc-starter-ci.yml b/.github/workflows/spring-boot-starter-ci.yml → ...rkflows/spring-boot-webmvc-starter-ci.yml
@@ -1,10 +1,10 @@
-name: Spring Boot Starter CI
+name: Spring Boot WebMVC Starter CI
 
 on: 
   push:
     paths:
     - 'spring/fluentforms-spring-boot-**'
-    - '.github/workflows/spring-boot-starter-ci.yml'
+    - '.github/workflows/spring-boot-webmvc-starter-ci.yml'
   workflow_dispatch:
 
 jobs:
@@ -22,7 +22,7 @@ jobs:
             experimental: true
 
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@v6
     - name: Set up JDK ${{ matrix.java }}
       uses: actions/setup-java@v5
       with:

diff --git a/fluentforms/examples/pom.xml b/fluentforms/examples/pom.xml
@@ -11,6 +11,25 @@
 	<name>FluentForms Examples</name>
 	<description>Various examples of using the Fluent Forms APIs.</description>
 
+	<build>
+		<!-- This project is an example project, so we don't need to install or deploy it. -->
+		<plugins>
+	        <plugin>
+	            <artifactId>maven-install-plugin</artifactId>
+	            <configuration>
+	                <skip>true</skip>
+	            </configuration>
+	        </plugin>
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-deploy-plugin</artifactId>
+				<configuration>
+					<skip>true</skip>
+				</configuration>
+			</plugin>
+		</plugins>
+	</build>
+
 	<dependencies>
 		<dependency>
 			<groupId>org.osgi</groupId>

diff --git a/pom.xml b/pom.xml
@@ -0,0 +1,36 @@
+<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/maven-v4_0_0.xsd">
+	<modelVersion>4.0.0</modelVersion>
+	<groupId>com._4point.aem.fluentforms</groupId>
+	<artifactId>fluentforms</artifactId>
+	<packaging>pom</packaging>
+	<version>0.0.4-SNAPSHOT</version>
+	<description>Fluent Forms Spring Boot Starter Projects</description>
+
+	<modules>
+		<!-- Top Level projects -->
+		<module>fluentforms</module>
+        <module>rest-services</module>
+        <module>spring</module>
+ 	</modules>
+
+	<build>
+		<!-- This project is a compositing project, so we don't need to install or deploy it. -->
+		<plugins>
+	        <plugin>
+	            <artifactId>maven-install-plugin</artifactId>
+	            <configuration>
+	                <skip>true</skip>
+	            </configuration>
+	        </plugin>
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-deploy-plugin</artifactId>
+				<configuration>
+					<skip>true</skip>
+				</configuration>
+			</plugin>
+		</plugins>
+	</build>
+</project>
diff --git a/rest-services/it.tests/pom.xml b/rest-services/it.tests/pom.xml
@@ -38,6 +38,25 @@
         <maven.compiler.release>17</maven.compiler.release>
 	</properties>
 
+	<build>
+		<!-- This project is just integration tests, so we don't need to isntall or deploy it. -->
+		<plugins>
+	        <plugin>
+	            <artifactId>maven-install-plugin</artifactId>
+	            <configuration>
+	                <skip>true</skip>
+	            </configuration>
+	        </plugin>
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-deploy-plugin</artifactId>
+				<configuration>
+					<skip>true</skip>
+				</configuration>
+			</plugin>
+		</plugins>
+	</build>
+
 	<dependencies>
 <!--		<dependency>
 			<groupId>org.glassfish.jersey.core</groupId>

diff --git a/spring/ConfigurationProperties.md b/spring/ConfigurationProperties.md
@@ -43,6 +43,9 @@ be set to `/clientApp` (as in `fluentforms.rproxy.clientPrefix=/clientApp`).
 
 `fluentforms.rproxy.afBaseLocation` - TBD - This needs to be documented.
 
+`fluentforms.rproxy.type` - This is used to set the mechanism used to reverse-proxy secondary resources to AEM.  If the value is `springmvc`, then Spring MVC is used to implement the reverse proxy.  If it is `jersey`, then JAX-RS Jersey is used.  This property is optional and, if omitted, then the autoconfiguration will choose `springmvc` if no other type is available.  It will typically use a different implementation if it is available (e.g. if `fluentforms-jersey-spring-starter` is on the class path).  This means that under normal circumstances, this setting should not have to be set and is only intended to be used to override the autoconfiguration mechanisms.
+
+
 ### Rest Client Properties
 
 Fluent Forms can be configured to use one of two different REST client libraries.  It can use either the Jersey client libraries or the Spring RestClient libraries.  it was originally developed to use the Jersey client libraries however this some drawbacks - firstly, the Spring requires special configuration when you combine it with libraries that use  the built in Spring Web Mechanisms (e.g. Spring MVC, Spring Boot Activator, etc. - see [https://docs.spring.io/spring-boot/how-to/jersey.html](https://docs.spring.io/spring-boot/how-to/jersey.html)). Secondly, Spring Jersey is an extra dependency that duplicates functionality that is already available in the Spring Framework, so it causes some jar bloat.

diff --git a/spring/fluentforms-jersey-spring-boot-autoconfigure/pom.xml b/spring/fluentforms-jersey-spring-boot-autoconfigure/pom.xml
@@ -0,0 +1,164 @@
+<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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+	<parent>
+		<groupId>org.springframework.boot</groupId>
+		<artifactId>spring-boot-starter-parent</artifactId>
+		<version>3.5.7</version>
+		<relativePath /> <!-- lookup parent from repository -->
+	</parent>
+	<groupId>com._4point.aem.fluentforms</groupId>
+	<artifactId>fluentforms-jersey-spring-boot-autoconfigure</artifactId>
+	<version>0.0.4-SNAPSHOT</version>
+	<name>FluentForms Jersey AutoConfigure Project</name>
+
+	<properties>
+		<java.version>17</java.version>
+		<jasypt.spring.boot.version>3.0.5</jasypt.spring.boot.version>
+		<jasypt.maven.plugin.version>3.0.5</jasypt.maven.plugin.version>
+		<fluentforms.version>0.0.4-SNAPSHOT</fluentforms.version>
+		<fluentforms-autoconfigure.version>0.0.4-SNAPSHOT</fluentforms-autoconfigure.version>
+
+		<!-- Testing Dependencies -->
+		<fp.hamcrest.matchers.version>0.0.4-SNAPSHOT</fp.hamcrest.matchers.version>
+		<wiremock.version>4.0.0-beta.16</wiremock.version>
+		<pitest.maven.plugin.version>1.20.2</pitest.maven.plugin.version>
+		<pitest.junit5.maven.plugin.version>1.2.3</pitest.junit5.maven.plugin.version>
+	</properties>
+
+	<distributionManagement>
+		<repository>
+			<id>github</id>
+			<name>4Point Solutions FluentFormsAPI Apache Maven Packages</name>
+			<url>https://maven.pkg.github.com/4PointSolutions/FluentFormsAPI</url>
+		</repository>
+	</distributionManagement>
+
+	<repositories>
+		<repository>
+			<id>github</id>
+			<url>https://maven.pkg.github.com/4PointSolutions/*</url>
+			<snapshots>
+				<enabled>true</enabled>
+			</snapshots>
+		</repository>
+	</repositories>
+
+
+	<dependencies>
+		<!-- Project Dependencies -->
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>com.github.ulisesbocchio</groupId>
+			<artifactId>jasypt-spring-boot-starter</artifactId>
+			<version>${jasypt.spring.boot.version}</version>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-autoconfigure</artifactId>
+			<scope>compile</scope>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-autoconfigure-processor</artifactId>
+			<optional>true</optional>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-jersey</artifactId>
+			<optional>true</optional>
+			<scope>provided</scope>
+		</dependency>
+		<dependency>
+			<groupId>com._4point.aem.fluentforms</groupId>
+			<artifactId>fluentforms-spring-boot-autoconfigure</artifactId>
+			<version>${fluentforms-autoconfigure.version}</version>
+		</dependency>
+		<dependency>
+			<groupId>com._4point.aem</groupId>
+			<artifactId>fluentforms.core</artifactId>
+			<version>${fluentforms.version}</version>
+		</dependency>
+		<dependency>
+			<groupId>com._4point.aem.docservices</groupId>
+			<artifactId>rest-services.client</artifactId>
+			<version>${fluentforms.version}</version>
+		</dependency>
+		<dependency>
+			<groupId>com._4point.aem.docservices.rest-services</groupId>
+			<artifactId>rest-services.jersey-client</artifactId>
+			<version>${fluentforms.version}</version>
+		</dependency>
+		<!-- Testing Dependencies -->
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-test</artifactId>
+			<scope>test</scope>
+		</dependency>
+		<dependency>
+			<groupId>com.4point.testing</groupId>
+			<artifactId>4point-hamcrest-matchers</artifactId>
+			<version>${fp.hamcrest.matchers.version}</version>
+			<scope>test</scope>
+		</dependency>
+		<dependency>
+			<groupId>org.wiremock</groupId>
+			<artifactId>wiremock-standalone</artifactId>
+			<version>${wiremock.version}</version>
+			<scope>test</scope>
+		</dependency>
+		<dependency>
+			<groupId>org.pitest</groupId>
+			<artifactId>pitest-junit5-plugin</artifactId>
+			<version>${pitest.junit5.maven.plugin.version}</version>
+			<scope>test</scope>
+		</dependency>
+	</dependencies>
+	<build>
+		<plugins>
+			<!-- Useful in case you want to change the password or secret key
+			for the jasypt data -->
+			<!-- To change password or key 
+				- Navigate to directory where
+			this pom resides
+				- In command line execute:  
+						mvn
+			jasypt:encrypt-value -Djasypt.encryptor.password=SECRET_KEY
+			-Djasypt.plugin.value=VALUE_TO_BE_ENCRYPTED
+				- SECRET_KEY is the
+			value that is used to encrypt/decrypt 
+				- Alternatively you can
+			download the plugin jar an execute the command from the location
+			where the plugin jar reside
+			-->
+			<plugin>
+				<groupId>com.github.ulisesbocchio</groupId>
+				<artifactId>jasypt-maven-plugin</artifactId>
+				<version>${jasypt.maven.plugin.version}</version>
+			</plugin>
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-source-plugin</artifactId>
+			</plugin>
+			<plugin>
+			    <groupId>org.apache.maven.plugins</groupId>
+    			<artifactId>maven-surefire-plugin</artifactId>
+    			<configuration>
+        			<excludes>
+		            	<exclude/>
+        			</excludes>
+				</configuration>
+			</plugin>
+			<plugin>
+				<!-- PiTest Mutation Testing plugin -->
+				<!-- Run with goals 'test-compile' and 'org.pitest:pitest-maven:mutationCoverage' --> 
+				<groupId>org.pitest</groupId>
+				<artifactId>pitest-maven</artifactId>
+				<version>${pitest.maven.plugin.version}</version>
+			</plugin>
+		</plugins>
+	</build>
+
+</project>