Upgrading and Migrating Spring Module to Version 2.x

Upgrade Spring Module to version 2.x.

Supported Upgrade Paths

From Version	To Version
1.x	2.x

From Version

To Version

1.x

2.x

Changes in This Release

Spring Module 2.0 includes these changes.

Spring Module (and its dependencies) are now compilable and compatible only with Java 17.
To align with modern development practices and ensure continued compatibility with secure and supported libraries, Spring Module is upgraded from Spring 5.x to Spring 6.x.

The structure of the spring:security-manager element is updated to resolve validation issues with the DSL. Previously, delegate-security-providers could be defined directly within spring:security-manager. Now, all spring:delegate-security-provider elements must be wrapped within a new spring:delegate-security-providers element.

Old structure (no longer supported):

<spring:security-manager doc:name="Spring Security Manager">
   <spring:delegate-security-provider name="memory-provider" delegate-ref="authenticationManager" />
</spring:security-manager>

New structure (required):

<spring:security-manager doc:name="Spring Security Manager">
   <spring:delegate-security-providers>
     <spring:delegate-security-provider name="memory-provider" delegate-ref="authenticationManager" />
   </spring:delegate-security-providers>
</spring:security-manager>

Upgrade Prerequisites

Before you perform the upgrade, you must create a backup of your files, data, and configurations in case you need to restore them.

Upgrade Steps

Follow these steps to perform the upgrade:

In Anypoint Studio, right-click the project and select Manage Dependencies > Manage Modules.
Select Spring Module - Mule 4 and click Update version.
Click Apply and Close.
Verify that the Spring Module dependency version is 2.0.0 in the pom.xml file in the Mule project.

Alternatively, you can manually update the Spring Module dependency version in the pom.xml file in the Mule project, or simply add the updated module to the project.

Verify the Upgrade

After you upgrade the connector, follow these steps to verify the upgrade:

In Studio, verify that there are no errors in the Problems or Console views.
Verify that there are no problems in the project pom.xml file.
Test the connection to verify that the operations work.

Troubleshoot

If there are problems with caching the parameters and caching the metadata, try restarting Anypoint Studio.

Revert the Upgrade

If it is necessary to revert to the previous version of Spring Module, change the Spring Module dependency version 2.0.0 in the project’s pom.xml to the previous version.

You must update the project’s pom.xml in Anypoint Studio.