Upgrading and Migrating Web Service Consumer Connector to Version 2.2

Upgrade Web Service Consumer Connector 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 2.2

New WSC:SECURITY error type usable in <error-handler> blocks. Operations that fail because of a security-related cause now raise this error type.
The soap-engine dependency is upgraded to version 2.4.0 with security improvements. XML parsing is hardened by default; if your integration legitimately requires DOCTYPE declarations or external entities in SOAP messages, see Troubleshooting for the system property to re-enable them.

Changes in 2.1

The WSS Sign Configuration Adapter type now includes the new Expand XOP Include field to define how XOP (XML-binary Optimized Packaging) includes are expanded inline within the SOAP message body.

Changes in 2.0

Web Service Consumer Connector 2.0 includes these changes.

Web Service Consumer Connector (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, Web Service Consumer Connector is upgraded from Spring 5.x to Spring 6.x.

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 Web Service Consumer Connector - Mule 4 and click Update version.
Click Apply and Close.
Verify that the Web Service Consumer Connector dependency version is 2.0.0 in the pom.xml file in the Mule project.

Alternatively, you can manually update the Web Service Consumer Connector dependency version in the pom.xml file in the Mule project, or simply add the updated connector 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 Web Service Consumer Connector, change the Web Service Consumer Connector 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.