Support JPMS for Spring Cloud Azure Libraries

What is JPMS

JPMS is Java Platform Module System.

Until Java 9, Java's top-level code organization element had been the package. Starting with Java 9 that changed: above the package now is the module. The module collects related packages together.

The JPMS is a code-level structure, so it doesn't change the fact that we package Java into JAR files.

What is a module

Modularity adds a higher level of aggregation above packages. The key new language element is the module - a uniquely named, reusable group of related packages, as well as resources (such as images and XML files) and a module descriptor specifying

• the module's name
• the module's dependencies (that is, other modules this module depends on)
• the package it explicitly makes available to other modules (all other packages in the modules are implicitly unavailable to other modules)
• the services it offers
• the services it consumes
• to what other modules it allows reflection

How to create a Java module

Add module descriptor

As mentioned, a module must provide a module descriptor. A mdodule descriptor is defined in a file named module-info.java.

One can refer to the module-info.java of azure-cosmos for example.

More syntax about module-info.java can see https://www.oracle.com/corporate/features/understanding-java-9-modules.html.

Automatic module

If a project, which is modular itself but has a dependency which is not a module yet, how will the JPMS handle that?

It automatically creates a module:

• Name:

  • If the JAR defines the Automatic-Module-Name header in the manifest file, it will be the module's name.
  • Otherwise the JAR name is the module's name.

• Requires:

  • An automatic module read all other modules.

• Exports/Opens

  • An automatic module exports all packages and also opens them for deep reflection.

Useful tools

Listing the JDK's modules

To list the JDK's set of modules, which includes the standard modules that implement the Java Language SE Specification (names starting with java), JavaFX modules (names starting with JavaFX), JDK-specific modules (names starting with jdk).

A version string follows each module name - @9 indicates that the module belongs to Java 9.

java --list-modules

Listing the modules for a specific module

This command can be used to verify whether a module is valid.

java -p ~/.m2/repository/com/azure/azure-core/1.32.0/azure-core-1.32.0.jar --list-modules

How to make a Spring Cloud Azure library a module

For Spring Cloud Azure library

Our current plan is the same as the Spring's team, they don't support full JPMS yet. https://github.com/spring-projects/spring-framework/issues/18079.

So we only need to provide Automatic Module Name for a Spring Cloud Azure library.

Check this for example https://github.com/Azure/azure-sdk-for-java/blob/d96d0333112997b0ee5aa03aacfad2d0b0e7d1d4/sdk/spring/spring-cloud-azure-starter/pom.xml#L106-L115.

For SDK level library

But if you are developing a SDK level library, we should add the module-info.java module descriptor for it. For example azure-identity-providers-* libraries.

Check this for example https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity/src/main/java/module-info.java.

How to test

If you want to make sure the module you created is correct, you can create an application, and add the module-info.java for this application.

Run the application with Java version greater than 9, for example Java 11.

References

• https://www.oracle.com/corporate/features/understanding-java-9-modules.html
• https://stackoverflow.com/questions/46741907/what-is-an-automatic-module#:~:text=The%20module%20name%20of%20an,JAR%20file%20by%20the%20ModuleFinder%20.
• https://github.com/tfesenko/Java-Modules-JPMS-CheatSheet/blob/master/README.md