The Java Module System in practice

package org.example.jpms;

import javax.xml.bind.annotation.XmlRootElement;

@XmlRootElement
public class Product {
    private int id;
    private String name;
    private double price; // Using double for money is actually a bad idea

    public Product() {
        this(-1, "", 0);
    }

    public Product(int id, String name, double price) {
        this.id = id;
        this.name = name;
        this.price = price;
    }

    public int getId() {
        return id;
    }
    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }

    public double getPrice() {
        return price;
    }
    public void setPrice(double price) {
        this.price = price;
    }

    @Override
    public String toString() {
        return name + ": " + price;
    }
}

package org.example.jpms;

import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.Test;

public class ProductTest {
    @Test
    public void testToString() {
        Product p = new Product(33, "spaghetti", 2.15);
        Assertions.assertEquals("spaghetti: 2.15", p.toString());
    }
}

package org.example.jpms;

import javax.xml.bind.JAXBContext;
import javax.xml.bind.Marshaller;

public class XMLPrinter {
    public static void main(String[] args) throws Exception {
        Product product = new Product(100, "pizza", 3.25);

        JAXBContext jaxbContext = JAXBContext.newInstance(Product.class);
        Marshaller jaxbMarshaller = jaxbContext.createMarshaller();
        jaxbMarshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);
        jaxbMarshaller.marshal(product, System.out);
    }
}

package java.sql;

import java.util.logging.Logger;

public interface Driver {
    public Logger getParentLogger() throws SQLFeatureNotSupportedException;
    ...
}

module java.se {
    requires transitive java.compiler;
    requires transitive java.datatransfer;
    requires transitive java.desktop;
    requires transitive java.instrument;
    requires transitive java.logging;
    requires transitive java.management;
    ...
}

import org.example.jpms.zip.Compressor;

module org.example.jpms.lzw {
    requires org.example.jpms.zip;
    provides Compressor with org.example.jpms.lzw.LZWCompressor;
}

import org.example.jpms.zip.Compressor;

module org.example.jpms.huffman {
    requires org.example.jpms.zip;
    provides Compressor with org.example.jpms.huffman.HuffmanCompressor;
}

public class App {
    public static void main(String[] args) {
        for(Compressor compressor: ServiceLoader.load(Compressor.class)) {
            System.out.println(compressor.getClass().getSimpleName() +
                    " (" + compressor.getCompressionRatio() + ")");
        }
    }
}

public class App {
    public static void main(String[] args) {
        for(Compressor compressor: Compressor.getCompressors()) {
            System.out.println(compressor.getClass().getSimpleName() +
                    " (" + compressor.getCompressionRatio() + ")");
        }
    }
}

open module org.example.jpms {
    ....
}

module org.example.jpms {
    opens org.example.jpms.impl;
}

module org.example.jpms {
    opens org.example.jpms.impl to org.example.tool;
}

compileTestJava {
    inputs.property("moduleName", moduleName)
    doFirst {
        options.compilerArgs = [
                '--module-path', classpath.asPath,
                '--add-modules', 'org.junit.jupiter.api',
                '--add-reads', "$moduleName=org.junit.jupiter.api",
                '--patch-module', "$moduleName=" + files(sourceSets.test.java.srcDirs).asPath,
        ]
        classpath = files()
    }
}

test {
    inputs.property("moduleName", moduleName)
    doFirst {
        jvmArgs = [
                '--module-path', classpath.asPath,
                '--add-modules', 'ALL-MODULE-PATH',
                '--add-reads', "$moduleName=org.junit.jupiter.api",
                '--patch-module', "$moduleName=" + files(sourceSets.test.java.outputDir).asPath,
                '--add-opens', "$moduleName/org.example.jpms=org.junit.platform.commons"
        ]
        classpath = files()
    }
}

import java.util.regex.Matcher
startScripts {
    inputs.property("moduleName", moduleName)
    doFirst {
        defaultJvmOpts = [
                '--module-path', 'LIB_DIR_PLACEHOLDER',
                '--add-modules', moduleName,
        ]
    }

    doLast{
        def bashFile = new File(outputDir, applicationName)
        String bashContent = bashFile.text
        bashFile.text = bashContent.replaceFirst('LIB_DIR_PLACEHOLDER',
                                        Matcher.quoteReplacement('$APP_HOME/lib'))

        def batFile = new File(outputDir, applicationName + ".bat")
        String batContent = batFile.text
        batFile.text = batContent.replaceFirst('LIB_DIR_PLACEHOLDER',
                                        Matcher.quoteReplacement('%APP_HOME%\\lib'))
    }
}

plugins {
    id 'application'
    id "org.javamodularity.moduleplugin" version "1.4.0"
}

repositories {
    jcenter()
}

ext.moduleName = 'org.example.jpms'
mainClassName = 'org.example.jpms.XMLPrinter'

dependencies {
    implementation 'org.glassfish.jaxb:jaxb-runtime:2.3.2'

    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.3.1'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.3.1'
}

test {
    useJUnitPlatform()
    testLogging {
        showStandardStreams = true
    }
}

--add-modules
  java.logging

--add-reads
  org.example.jpms=java.logging

buildscript {
  repositories {
      maven {
        url "https://plugins.gradle.org/m2/"
      }
      maven {
        url 'https://jitpack.io'
      }
  }
  dependencies {
    classpath "org.moditect:moditect-gradle-plugin:1.0.0-beta1"
  }
}

plugins{
    id "java"
    id "application"
}
apply plugin: "org.moditect.gradleplugin"

repositories {
    mavenCentral()
}

group = "org.moditect"
version = "2.0.0"

targetCompatibility = JavaVersion.VERSION_1_9
sourceCompatibility = JavaVersion.VERSION_1_9

ext {
    moduleName = 'com.example'

    vertxVersion = '3.5.0'
    nettyVersion = '4.1.15.Final'
    jacksonVersion ='2.9.0'
}

mainClassName = 'com.example.HelloWorldServer'
jar {
    manifest {
        attributes("Automatic-Module-Name": moduleName)
    }
}

dependencies{
    compile "io.vertx:vertx-core:$vertxVersion"
}

moditect {
    addMainModuleInfo {
        version = project.version
        overwriteExistingFiles = false
        jdepsExtraArgs = ['-q']
        module {
            mainClass = mainClassName
            moduleInfo {
                name = moduleName
                exports = 'com.example to io.vertx.core;'
            }
        }
    }
    addDependenciesModuleInfo {
        jdepsExtraArgs = ['-q']
        modules {
            module {
                artifact "com.fasterxml.jackson.core:jackson-core:$jacksonVersion"
                moduleInfo {
                    name = 'com.fasterxml.jackson.core'
                }
            }
            module {
                artifact "com.fasterxml.jackson.core:jackson-annotations:$jacksonVersion"
                moduleInfo {
                    name = 'com.fasterxml.jackson.annotations'
                }
            }
            module {
                artifact "com.fasterxml.jackson.core:jackson-databind:$jacksonVersion"
                moduleInfo {
                    name = 'com.fasterxml.jackson.databind'
                }
            }
            module {
                artifact "io.netty:netty-common:$nettyVersion"
                moduleInfo {
                    name = 'io.netty.common'
                }
            }
            module {
                artifact "io.netty:netty-buffer:$nettyVersion"
                moduleInfo {
                    name = 'io.netty.buffer'
                }
            }
            module {
                artifact "io.netty:netty-codec:$nettyVersion"
                moduleInfo {
                    name = 'io.netty.codec'
                }
            }
            module {
                artifact "io.netty:netty-resolver:$nettyVersion"
                moduleInfo {
                    name = 'io.netty.resolver'
                }
            }
            module {
                artifact "io.netty:netty-transport:$nettyVersion"
                moduleInfo {
                    name = 'io.netty.transport'
                }
            }
            module {
                artifact "io.netty:netty-codec-dns:$nettyVersion"
                moduleInfo {
                    name = 'io.netty.codec.dns'
                }
            }
            module {
                artifact "io.netty:netty-codec-http2:$nettyVersion"
                moduleInfo {
                    name = 'io.netty.codec.http2'
                }
            }
            module {
                artifact "io.netty:netty-resolver-dns:$nettyVersion"
                moduleInfo {
                    name = 'io.netty.resolver.dns'
                }
            }
            module {
                artifact "io.netty:netty-transport-native-unix-common:$nettyVersion"
                moduleInfo {
                    name = 'io.netty.channel.unix'
                }
            }
            module {
                artifact "io.netty:netty-transport-native-epoll:$nettyVersion"
                moduleInfo {
                    name = 'io.netty.channel.epoll'
                }

            }
            module {
                artifact "io.netty:netty-transport-native-kqueue:$nettyVersion"
                moduleInfo {
                    name = 'io.netty.channel.kqueue'
                }
            }
            module {
                artifact "io.netty:netty-handler:$nettyVersion"
                moduleInfoSource = '''
                    module io.netty.handler {
                        exports io.netty.handler.flow;
                        exports io.netty.handler.flush;
                        exports io.netty.handler.ipfilter;
                        exports io.netty.handler.logging;
                        exports io.netty.handler.ssl;
                        exports io.netty.handler.ssl.ocsp;
                        exports io.netty.handler.ssl.util;
                        exports io.netty.handler.stream;
                        exports io.netty.handler.timeout;
                        exports io.netty.handler.traffic;
                    }
                '''
            }
            module {
                artifact "io.netty:netty-codec-socks:$nettyVersion"
                moduleInfo {
                    name = 'io.netty.codec.socks'
                }
            }
            module {
                artifact "io.netty:netty-handler-proxy:$nettyVersion"
                moduleInfo {
                    name = 'io.netty.handler.proxy'
                }
            }
            module {
                artifact "io.netty:netty-codec-http:$nettyVersion"
                moduleInfo {
                    name = 'io.netty.codec.http'
                }
            }
            module {
                artifact "io.vertx:vertx-core:$vertxVersion"
                moduleInfo {
                    name = 'io.vertx.core'
                    requires = '''
                        static log4j.api;
                        static log4j;
                        static slf4j.api;
                        *;
                    '''
                    exports = '''
                        !*impl*;
                        *;
                    '''
                    uses = '''
                        io.vertx.core.spi.VertxFactory;
                        io.vertx.core.spi.VerticleFactory;
                        io.vertx.core.spi.FutureFactory;
                        io.vertx.core.spi.BufferFactory;
                    '''
                }
            }
        }
    }
    createRuntimeImage {
        outputDirectory = file("$buildDir/jlink-image")
        modules = ['com.example']
        launcher {
            name = 'helloWorld'
            module = 'com.example'
        }
        compression = 2
        stripDebug = true
    }
}

plugins {
    id 'application'
    id "org.javamodularity.moduleplugin" version "1.4.0"
    id 'org.beryx.jlink' version '2.5.0'
}
repositories {
    jcenter()
}
dependencies {
    implementation "io.vertx:vertx-core:3.5.0"
}
ext.moduleName = 'com.example'
mainClassName = "com.example/com.example.HelloWorldServer"

jlink {
    options = ['--strip-debug', '--compress', '2', '--no-header-files', '--no-man-pages']
    mergedModule {
        additive = true
        uses 'io.vertx.core.spi.VertxFactory'
        uses 'io.vertx.core.spi.VerticleFactory'
        uses 'io.vertx.core.spi.FutureFactory'
        uses 'io.vertx.core.spi.BufferFactory'
    }
}

plugins {
    id 'application'
    id "org.beryx.runtime" version "1.1.5"
}

repositories {
    jcenter()
}

dependencies {
    implementation "io.vertx:vertx-core:3.5.0"
}

mainClassName = "com.example.HelloWorldServer"

runtime {
    options = ['--strip-debug', '--compress', '2', '--no-header-files', '--no-man-pages']
    modules = ['java.naming', 'java.compiler', 'java.logging', 'jdk.unsupported']
}