Java Module System (with Gradle)

This is a minimalistic project that shows a structured Java project setup utilising the Java Module System (JPMS) to define a modular software structure with Gradle as the underlying build system. To integrate these, the GradleX Java development plugins are used.

With this setup, modularization and other build configuration concerns are separated. With that accidental complexity in the module setup is avoided.

Learn more

• Browse slides of my 2025 talk Combining Java Modules and Gradle for elegant project structures which is based on this sample
• Watch my 2024 talk Boosting Developer Productivity Through Better Modularity) (and browse the slides) which uses this example
• Browse slides of my 2024 talk Combining Java Modules and Gradle for elegant project structures which is based on this sample
• Browse slides of my 2023 talk Modularizing Projects with the Java Module System and Gradle which gives more background on the modularity concepts in Java and Gradle
• Watch my YouTube playlist Understanding Gradle – Java Modularity for even more information on modularity in Java and how it is handled in Gradle

In action: projects that use this setup

• hiero-ledger/hiero-gradle-conventions use by
  • hiero-ledger/hiero-consensus-node
  • hiero-ledger/hiero-sdk-java
  • ...and other hiero-ledger projects
• jjohannes/gradle-project-setup-howto/java_module_system

Build the example

• Run ./gradlew check to run tests and check integrity of the module setup
• To build a self-contained installable of the application, run:
  • Run ./gradlew assembleWindows-2022
  • Run ./gradlew assembleMacos-13
  • Run ./gradlew assembleMacos-14
  • Run ./gradlew assembleUbuntu-22.04

The example also builds on GitHub. The result can be explored here: https://github.com/jjohannes/java-module-system/actions