---
schema_version: "1"
id: 3763e3b8a5ed08ad410d1bb34548641c7c42132dde5778e3255ca5db46040f51
title: Upgrading and Migrating Java Module to Version 2.x
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/java-module/latest/java-module-upgrade-migrate.md
canonical_url: https://docs.mulesoft.com/java-module/latest/java-module-upgrade-migrate
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 01b0a8c6650e86b67ae7b1cede73b5d304500e66775cec5ef5f01efa9d20cbfd
description: MuleSoft Documentation Site
release: "2.0"
latest: true
---
---
product: Java Module
version: 2.0
is-latest-version: true
---

# Upgrading and Migrating Java Module to Version 2.x

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

Upgrade Java Module to version 2.x.

## Supported Upgrade Paths

<table><colgroup><col> <col></colgroup><thead><tr><th>From Version</th><th>To Version</th></tr></thead><tbody><tr><td><div><div><p>1.x</p></div></div></td><td><div><div><p>2.x</p></div></div></td></tr></tbody></table>

## Changes in This Release

Java Module 2.0 includes these changes.

- Java 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, Java Module 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:

1.  In Anypoint Studio, right-click the project and select **Manage Dependencies** > **Manage
    Modules**.

2.  Select `Java Module - Mule 4` and click **Update version**.

3.  Click **Apply and Close**.

4.  Verify that the Java Module dependency version is `2.x` in the `pom.xml` file in the Mule
    project.

Alternatively, you can manually update the Java 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:

1.  In Studio, verify that there are no errors in the **Problems** or **Console** views.

2.  Verify that there are no problems in the project `pom.xml` file.

3.  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 Java Module, change the Java Module
dependency version `2.x` in the project’s `pom.xml` to the previous version.

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

## See Also

- [Introduction to Anypoint Connectors](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)

- [Java Module Reference](https://docs.mulesoft.com/java-module/latest/java-reference)

- [Salesforce Help](https://help.salesforce.com)