Hear from Salesforce leaders on how to create and deploy Agentforce agents.
Register now
Contact Us 1-800-596-4880
  1. Homepage
  2. Mule SDK
  3. Java SDK
  4. Module Structure

  5. Java Version Support

Java Version Support

Specify the Java compatibility of your custom module. In Mule 4.6.0 and later, custom modules that do not specify the Java compatibility are assumed to be compatible with Java 8 and Java 11 only. If your custom module is compatible with a more recent Java version, you must specify the Java compatibility to include that version.

Communicating the Java compatibility of your custom module also ensures:

  • Safe upgrades

    Users can determine whether their Mule applications can safely upgrade to run on a given Java version, ensuring a smooth transition and avoiding potential issues.

  • User experience

    Providing clear information about Java compatibility enhances the user experience, especially for Anypoint Exchange users who rely on this information for selecting modules.

Specify Java Compatibility

To specify Java compatibility of your custom module:

  1. Generate metadata to specify Java compatibility of your custom module by adding or upgrading the custom module mule-sdk-api dependency to the latest version, for example:

    <dependency>
   <groupId>org.mule.sdk</groupId>
   <artifactId>mule-sdk-api</artifactId>
   <version>0.11.0</version>
</dependency>
    xml

  2. Add the @JavaVersionSupport annotation in the same class as the @Extension annotation and include the supported Java versions as values, for example:

    @Extension(name = "Database")
@Operations(...)
@JavaVersionSupport({JavaVersion.JAVA_8, JavaVersion.JAVA_11, JavaVersion.JAVA_17})
public class DatabaseConnector {
..
}
    java
If the mule-modules-parent version is earlier than 1.9.0, all code, including third-party dependencies, must be compiled for Java 8, and you must use Java 8 to build the connector.

You can mark your custom module as compatible with a single Java version only; however, you must ensure that no adoption or backward compatibility issues exist.

When you deploy a Mule app, Mule verifies that all modules in the Mule app are compatible with the Java version. If Mule finds an incompatibility, Mule throws an error and the application does not deploy.

If your code is compatible with a given Java version but you do not declare that compatibility, you can still get a successful test run (only when running a test on Java 8).

See Also