java9 模块化 jigsaw

---

java9并没有在语言层面做出很多改变，而是致力于一些新特性，如模块化，其核心就是解决历史遗留问题，为以后的jar包森林理清道路。模块化是一个很大的命题，就不讲那么细致了，关于java9的特性也有很多书籍可供参考，如
《Java 9 Revealed: For Early Adoption and Migration》，《Java 9 Modularity》，还有很多很多（点击查看）。

模块化是一个很大的特性，也是一个很大的话题。模块化作为一个未来的的趋势，我们可能会关心项目的迁移，对接OSGI或者微服务等等，本文只是简单阐述下模块化解决的基本问题和模块化的一些用法。

模块化

两个问题，臃肿的jar包和混乱的jar包依赖关系。如果我们没被现在的jar包系统搞疯，首先应该感谢IDE和maven，gradle之类的版本控制软件。你可能见过这个大家伙，60多m的jar包，运行一个Hello World程序，也需要这么一个庞然大物支撑。

再或者，我们依赖一个大的工具包，但我们可能只需要其中几个类的功能。之前的jar包机制是很僵硬的，我们需要更灵活更轻便条理更清晰的环境，从化繁为简的角度来讲，我们需要模块化。

不知道你经历过jar hell吗，可以参考下图:



jar包之间的依赖可谓错综复杂，jar包之间交叉，缠绕，冲突，旋转，跳跃，我觉得没有人会想理清项目中依赖的这一个jar包与其他Jar包之间千丝万缕的联系。不看依赖，便是晴天，但是我们有时候真的需要理清楚，因为我们在部署的时候可能会产生冲突，会报各种异常。我们理清楚了，我们对这个jar包理解更深了，我们变强了，我们秃了。我们需要更清晰的图像来描述依赖关系，我们不能任由jar缠绕旋转，我们应该让他们更守规矩，让依赖图像清楚并且有层次，我们需要模块化。

其实我们不需要理解模块化的字面意义，我们需要知道我们面临的困难和要解决的问题，jdk9发布的解决这些问题的新特性的名称叫做模块化。

漫长的模块化

在使用模块化之前，我需要让你明白一些事情，模块化不是一蹴而就，java平台做了表率，从内部进行了模块化改造。我们先来看一下传统的jdk7的API:



很熟悉的api形式。

再来看一看java9的api:



点进java.activation



我们还可以看到模块的图像，Java9不仅为我们提供了模块化的手段，整个java9平台自身，也已经被模块化改造了。整个java生态彻底改造成模块化是需要时间的，从jdk7时提出模块化概念，到整个模块化版本发布，经历了很长时间。把原来的第三方jar包彻底改造成模块化jar包会花费很多功夫，我们能够使用jdk的模块化包，不代表我们能够使用整个Java生态中所有的模块化包，这需要开发者对自己的jar包进行调整。

• 模块化为我们梳理出了逻辑清晰的jar包系统。
• 模块化需要额外的操作，处理相同的代码，我们需要理清代码之间的关系，对内容模块化，但IDE提供了一些便捷的功能。
• 拥抱彻底的模块化生态需要时间，很多重量级的框架和jar包适应模块化是需要我们等待的,但是有自动化模块可以帮助我们构建模块化项目。

简单入门模块化

在$JAVA_HOME/bin中的Java工具也为模块化提供了很多新功能，就不一一详细介绍了，感兴趣的话可以参考Oracle的介绍。下面的例子主要是参考openJDK模块化的快速入门和GitHub上的一个项目，很好的例子，我也就不做太多更改了，会简要叙述下例子中的新事物。

首先要下载JDK9，可以去官网下载，我是用Linux平台演示的代码。

先来看第一个例子，输出Greetings!

先来看一看整个项目的目录结构:

src
└── src/com.greetings
    ├── src/com.greetings/com
    │   └── src/com.greetings/com/greetings
    │       └── src/com.greetings/com/greetings/Main.java
    └── src/com.greetings/module-info.java

整个项目包含两个文件，一个是module-info.java模块文件，还有一个是Main.java主类文件。让我们看一看这两个文件的内容。

$ cat src/com.greetings/module-info.java
    module com.greetings { }

模块文件中没有内容，因为这个Main.java中没有依赖别的模块的内容，也没有打算向外界暴露Main.java的内容，所以内容是空的。

$ cat src/com.greetings/com/greetings/Main.java
package com.greetings;
public class Main {
    public static void main(String[] args) {
        System.out.println("Greetings!");
    }
}

然后，我们把这两个文件编译运行。

javac -d mods/com.greetings \
        src/com.greetings/module-info.java \
        src/com.greetings/com/greetings/Main.java

javac -d 指定放置生成的类文件的位置

java --module-path mods \
-m com.greetings/com.greetings.Main
#或者
java --module-path mods \
--module com.greetings/com.greetings.Main

就可以运行了，我们会发现屏幕上打印出了Greetings！

其中 --module-path <模块路径>...用 : 分隔的目录列表, 每个目录都是一个包含模块的目录。

-m或--module是一样的，用于指定要解析的初始化模块名称，如果不指定模块名称，可以指定要执行的主类名称

再来看第二个例子，Greetings world!

我们先来看一下目录结构:

src
├── src/com.greetings
│   ├── src/com.greetings/com
│   │   └── src/com.greetings/com/greetings
│   │       └── src/com.greetings/com/greetings/Main.java
│   └── src/com.greetings/module-info.java
└── src/org.astro
    ├── src/org.astro/module-info.java
    └── src/org.astro/org
        └── src/org.astro/org/astro
            └── src/org.astro/org/astro/World.java

再来看看代码内容:

cat src/com.greetings/com/greetings/Main.java

package com.greetings;

import org.astro.World;

public class Main {
        public static void main(String[] args) {
                System.out.format("Greetings %s!%n", World.name());
        }
}

cat src/com.greetings/module-info.java

module com.greetings {
        requires org.astro;
}

cat src/org.astro/org/astro/World.java

package org.astro;

public class World {
        public static String name() {
                return "world";
        }
}

cat src/org.astro/module-info.java

module org.astro {
        exports org.astro;
}

Main.java类中打印了Greetings!+World.name()，com.greetings模块文件声明了requires org.astro，意思就是我这个模块需要依赖org.astro模块；World类中有一个静态方法，返回了world字符串,com.greetings模块依赖于它，而且他在自己的模块文件中做出了声明exports org.astro，将org.astro模块暴露出去，可供其他模块依赖。

#我们先编译com.greetings模块试试

javac -d mods/com.greetings \
> >  src/com.greetings/module-info.java src/com.greetings/com/greetings/Main.java
src/com.greetings/module-info.java:2: 错误: 找不到模块: org.astro
        requires org.astro;
                    ^
1 个错误

那再先编译一下，org.astro模块

 javac -d mods/org.astro \
> src/org.astro/module-info.java src/org.astro/org/astro/World.java

然后编译一下com.greeetings

javac --module-path mods -d mods/com.greetings src/com.greetings/com/greetings/Main.java src/com.greetings/module-info.java

--module-path(或-p) 用来指定应用的模块的位置。

运行一下

java --module-path mods -m com.greetings/com.greetings.Main
//Greetings world!

这个例子中要注意exports和requires的用法，exports对外界暴露内容，requires引入外界功能，如果没有引入，或者引入不存在的module编译无法通过。

#如果没有声明requires
javac --module-path mods -d mods/com.greetings \
    src/com.greetings/module-info.java src/com.greetings/com/greetings/Main.java
src/com.greetings/com/greetings/Main.java:2: error: package org.astro is not visible
    import org.astro.World;
              ^
  (package org.astro is declared in module org.astro, but module com.greetings does not read it)
1 error
#如果没有声明exports
javac --module-path mods -d mods/com.greetings \
   src/com.greetings/module-info.java src/com.greetings/com/greetings/Main.java
src/com.greetings/com/greetings/Main.java:2: error: package org.astro is not visible
    import org.astro.World;
              ^
  (package org.astro is declared in module org.astro, which does not export it)
1 error

多模块的编译

可以一次编译多个模块

我们先找出所有.java文件

echo $(find src -name "*.java")
//src/org.astro/org/astro/World.java src/org.astro/module-info.java src/com.greetings/com/greetings/Main.java src/com.greetings/module-info.java

一口气将所有.java文件编译到mods文件夹中

javac -d mods --module-source-path src $(find ./src -name "*.java")

看一下目录结构

mods
├── mods/com.greetings
│   ├── mods/com.greetings/com
│   │   └── mods/com.greetings/com/greetings
│   │       └── mods/com.greetings/com/greetings/Main.class
│   └── mods/com.greetings/module-info.class
└── mods/org.astro
    ├── mods/org.astro/module-info.class
    └── mods/org.astro/org
        └── mods/org.astro/org/astro
            └── mods/org.astro/org/astro/World.class

效果是一样的，再运行一下

java --module-path mods -m com.greetings/com.greetings.Main
//Greetings world!

• 打包

我们可以把模块打成jar包，这样会更方便，模块jar包里顶级目录下会有一个module-info.calss文件。

我们把已经编译好的mods文件夹中的模块文件打包成jar包

注意：最后的句号不能漏掉

jar -c -f mlib/org.astro@1.0.jar \
        --module-version=1.0 -C mods/org.astro .
//或者
jar --create --file=mlib/org.astro@1.0.jar \
        --module-version=1.0 -C mods/org.astro .

两个都可以的，--create缩写就是-c,意思是我们创建jar包；--file=缩写就是-f,指定文件位置和名称，--module-version是指定版本，创建模块化 jar 或更新非模块化 jar 时的模块版本；-C 就是更改为指定的目录并包含以下文件。关于jar命令还有很多操作，可以通过jar --help查阅，或者去官网查阅。

$ jar --create --file=mlib/com.greetings.jar \
        --main-class=com.greetings.Main -C mods/com.greetings .

产看一下生成的jar包

$ ls mlib
com.greetings.jar   org.astro@1.0.jar

来执行一下，因为我们打包com.greetings模块时，指定了主类，所以运行时可以直接调用

java -p mlib -m com.greetings
//Greetings world!

Service

如何使用模块系统提供服务呢，让我们来看看。

首先查看一下工程的结构:

src
├── src/com.greetings
│   ├── src/com.greetings/com
│   │   └── src/com.greetings/com/greetings
│   │       └── src/com.greetings/com/greetings/Main.java
│   └── src/com.greetings/module-info.java
├── src/com.socket
│   ├── src/com.socket/com
│   │   └── src/com.socket/com/socket
│   │       ├── src/com.socket/com/socket/NetworkSocket.java
│   │       └── src/com.socket/com/socket/spi
│   │           └── src/com.socket/com/socket/spi/NetworkSocketProvider.java
│   └── src/com.socket/module-info.java
└── src/org.fastsocket
    ├── src/org.fastsocket/module-info.java
    └── src/org.fastsocket/org
        └── src/org.fastsocket/org/fastsocket
            ├── src/org.fastsocket/org/fastsocket/FastNetworkSocket.java
            └── src/org.fastsocket/org/fastsocket/FastNetworkSocketProvider.java

有点多，我们先理一理其中的关系



com.scoket中还有个NetworkSocketProvider.java，其实就是用来创建socket的一个工厂。我们再来看看他们的代码:

先来看看org.socket模块:

package com.socket;

import com.socket.spi.NetworkSocketProvider;

import java.io.Closeable;
import java.util.Iterator;
import java.util.ServiceLoader;

public abstract class NetworkSocket implements Closeable {
    protected NetworkSocket() {}

    public static NetworkSocket open() {
        ServiceLoader<NetworkSocketProvider> sl = ServiceLoader.load(NetworkSocketProvider.class);
        Iterator<NetworkSocketProvider> iter = sl.iterator();
        if (!iter.hasNext()) {
            throw new RuntimeException("No service providers found!");
        }
        NetworkSocketProvider provider = iter.next();
        return provider.openNetworkSocket();
    }
}

其中有一个open()方法，其实就是使用provider生成一个NetworkSocket对象并返回。

再来看看NetworkSocketProvider:

package com.socket.spi;

import com.socket.NetworkSocket;

public abstract class NetworkSocketProvider {
    protected NetworkSocketProvider() {}

    public abstract NetworkSocket openNetworkSocket();
}

一个抽象类，openNetworkSocket()抽象方法由子类实现。

module-info.java

module com.socket {
        exports com.socket;
        exports com.socket.spi;
        uses com.socket.spi.NetworkSocketProvider;
}

我想上面两个exports你应该能够理解其意义，但是uses是什么意思呢。为了使用服务，它的提供者需要被发现和加载。java.util.ServiceLoader类来发现和加载服务。发现和加载服务提供者的模块必须在其声明中包含一个uses语句，该语句语法如下：
uses <service-interface>;<service-interface>是服务接口的名称，它是Java接口名称，类名称或注解类型名称。如果一个模块使用ServiceLoader<S>类加载名为S的服务接口的服务提供者的实例，则模块声明必须包含以uses S。总而言之，就是你如果是个服务接口，你需要服务提供的类实现你的接口，你就需要声明uses。

那我们在看一看服务提供者类，org.fastsocket:

//继承了NetWorkSocket类
package org.fastsocket;

import com.socket.NetworkSocket;

public class FastNetworkSocket extends NetworkSocket {
    FastNetworkSocket() {}
    public void close() {}
}

再来看看FastNetworkSocketProvider类，它实现了NetworkSocketProvider抽象类，重写了抽象方法，用来返回一个NetworkSocket。

package org.fastsocket;

import com.socket.NetworkSocket;
import com.socket.spi.NetworkSocketProvider;

public class FastNetworkSocketProvider extends com.socket.spi.NetworkSocketProvider {
    public FastNetworkSocketProvider() {}

    @Override
    public NetworkSocket openNetworkSocket() {
        return new FastNetworkSocket();
    }
}

再来看看module-info.java

module org.fastsocket {
        requires com.socket;
        provides com.socket.spi.NetworkSocketProvider
                with org.fastsocket.FastNetworkSocketProvider;
}

其中有个provides和with，意思就是为NetworkSocketProvider提供一个实现类org.fastsocket.FastNetworkSocketProvider。

再来快速看一下客户端代码，我们运行一下整个服务系统。

cat src/com.greetings/com/greetings/Main.java
package com.greetings;

import com.socket.NetworkSocket;

public class Main {
        public static void main(String[] args) {
                NetworkSocket s = NetworkSocket.open();
                System.out.println(s.getClass());
        }
}

cat src/com.greetings/module-info.java
module com.greetings {
        requires com.socket;
}

客户端代码很简单，客户端模块依赖了com.socket，Main.java打印了提供服务的类名。

我们先试着编译服务接口代码和客户端代码：

javac  -d mods/com.socket  $(find src/com.socket -name "*.java")
javac --module-path mods -d mods/com.greetings  $(find src/com.greetings -name "*.java")

编译时并没有报错。是的，服务接口中虽然声明了uses关键字，意味着这个模块需要实现类，但是在编译时他不会寻找需要的实现类模块。

运行一下看看。

java -p mods -m com.greetings/com.greetings.Main

Exception in thread "main" java.lang.RuntimeException: No service providers found!
        at com.socket/com.socket.NetworkSocket.open(NetworkSocket.java:16)
        at com.greetings/com.greetings.Main.main(Main.java:7)

报了一个运行时异常，意味着对于服务的具体实现是在运行是寻找的。

我们把实现类编译一下，然后运行:

javac --module-path mods -d mods/org.fastsocket $(find src/org.fastsocket -name "*.java") 

java -p mods -m com.greetings/com.greetings.Main
class org.fastsocket.FastNetworkSocket

成功打印出了类名，是不是有点像OSGI的热插拔。通过模块系统，我们实现了对服务接口和服务提供者的解耦，我们确保服务提供者在调用服务之前能够编译到模块中即可。

模块补丁

什么是模块补丁呢，假如我们的项目依赖了一个A模块，但是觉得需要自定义A模块中某些类的功能，那可以修改这个类，然后把修改后的类打到依赖的A模块中。这样，我们的项目就可以使用拥有自定义类的模块了。下面以ConcurrentHashMap为例，ConcurrentHashMap是java.base模块中的一个类，我们将自定义的ConcurrentHashMap类替换java.base中ConcurrentHashMap。

先来看一看整个工程的结构:

├── src/com.greetings
│   ├── src/com.greetings/com
│   │   └── src/com.greetings/com/greetings
│   │       └── src/com.greetings/com/greetings/Main.java
│   └── src/com.greetings/module-info.java
└── src/java.base
    └── src/java.base/java
        └── src/java.base/java/util
            └── src/java.base/java/util/concurrent
                └── src/java.base/java/util/concurrent/ConcurrentHashMap.java

其中有两个模块，com.greeting模块中依赖了java.base中的ConcurrentHashMap，java.base模块里包含了我们重写的ConcurrentHashMap类,而且注意一点，这个模块中没有module-info.java描述文件。再来看看模块的内容:

module com.greetings {
}

package com.greetings;

import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;

public class Main {
    public static void main(String[] args) {
        Map<String, Integer> myMap = new ConcurrentHashMap<>();
        myMap.put("one", 1);
        myMap.put("two", 2);
        myMap.put("three", 3);
        System.out.println("Hello " + myMap);
        System.out.println("Is Duke home? " + myMap.containsKey("Duke"));
    }
}

虽然module-info.java中没有声明依赖java.base，但是其实所有的模块都是隐式依赖java.base模块的，java.base是所有模块的基本模块，他暴露了java.lang和java.util等等基础包。Main.java中的内容也很简单，放入ConcurrentHashMap中几个元素，然后打印。

再来看看我们重写的ConcurrentHashMap的内容，可以只看put()方法,containsKey()方法和toString()方法:

package java.util.concurrent;

import java.io.Serializable;
import java.util.*;

public class ConcurrentHashMap<K, V> extends AbstractMap<K, V> implements ConcurrentMap<K, V>, Serializable {

    private final Map<K, V> innerMap;

    public ConcurrentHashMap() {
        this.innerMap = new HashMap<>();
    }

    public ConcurrentHashMap(int initialCapacity) {
        this.innerMap = new HashMap<>(initialCapacity);
    }

    public ConcurrentHashMap(int initialCapacity,
                             float loadFactor, int concurrencyLevel) {
        this.innerMap = new HashMap<>(initialCapacity, loadFactor);
    }

    public Set<Map.Entry<K, V>> entrySet() {
        return innerMap.entrySet();
    }

    @Override
    public boolean replace(K key, V oldValue, V newValue) {
        return innerMap.replace(key, oldValue, newValue);
    }

    @Override
    public V replace(K key, V value) {
        return innerMap.replace(key, value);
    }

    @Override
    public V remove(Object o) {
        return innerMap.remove(o);
    }

    @Override
    public boolean remove(Object key, Object value) {
        return innerMap.remove(key, value);
    }

    @Override
    public V putIfAbsent(K key, V value) {
        return innerMap.putIfAbsent(key, value);
    }

    @Override
    public V put(K key, V value) {
        return innerMap.put(key, value);
    }

    @Override
    public V get(Object key) {
        return innerMap.get(key);
    }

    @Override
    public void putAll(Map<? extends K, ? extends V> map) {
        innerMap.putAll(map);
    }
    @Override
    public boolean containsKey(Object key) {
        if (Objects.equals(key, "Duke")) {
            return true;
        }
        return super.containsKey(key);
    }

    public String toString() {
        return "patched ConcurrentHashMap " + super.toString() + " + Duke";
    }
}

好了，这就是我们自定义的ConcurrentHashMap类，我们先运行一下不打补丁的com.greetings模块。

javac --module-path mods \
       -d mods/com.greetings/ \
       src/com.greetings/module-info.java \
       src/com.greetings/com/greetings/Main.java

java --module-path mods \
     --module com.greetings/com.greetings.Main

Hello {one=1, two=2, three=3}
Is Duke home? false

在没有补丁的情况下，使用的是原来的ConcurrentHashMap类。

试一试对java.base打上补丁:

javac --patch-module java.base=src \
    -d mypatches/java.base \
     src/java.base/java/util/concurrent/ConcurrentHashMap.java

java --module-path mods \
     --patch-module java.base=mypatches/java.base \
      --module com.greetings/com.greetings.Main

Hello patched ConcurrentHashMap {one=1, two=2, three=3} + Duke
Is Duke home? true

成功了！我们在运行Main方法时候，使用的是自定义的ConcurrentHashMap类，来看看是如何做到的。首先在编译的时候，我们使用了--patch-module这个命令，查看一下javac的帮助文档javac --help-extra可以看到这个命令的解释

--patch-module <模块>=<文件>(:<文件>)*,使用 JAR文件或目录中的类和资源覆盖

所以呢，我们把java.base中的ConcurrentHashMap类给覆盖了，在运行时，也有一个--patch-module，其实和上面的解释是一样的，运行时使用mypatches/java.base文件覆盖java.base文件，然后得到了想要的结果。

自动模块化

当我们已经开始模块化的工程，但是需要依赖一些非模块化的jar包，这些库的开发人员并没有及时更新库使其适应模块化，他们缺少模块化的描述符，所以我们需要自动模块化--将非模块化的jar包转化成模块化jar。以junit为例，我们先来看看junitjar包的描述信息。

jar -d --file=lib/junit-4.12.jar
找不到模块描述符。已派生自动模块。

junit@4.12 automatic
requires java.base mandated
contains junit.extensions
contains junit.framework
contains junit.runner
contains junit.textui
contains org.junit
...

-d等同于--describe-module,用于输出模块描述符或自动模块名称，--file=指定文件名，我们可以看到他为我们派生出junit的版本和描述符。但是不幸的是，他没有告诉我们junit其实还依赖了Hamcrest，我们通过jdeps工具来查看jar包的依赖。

jdeps -s lib/junit-4.12.jar
junit-4.12.jar -> java.base
junit-4.12.jar -> java.management
junit-4.12.jar -> 找不到

-s只是查看以来的概览，有些依赖是不确定的，那我们看看丢失了哪些依赖:

jdeps lib/junit-4.12.jar | grep "找不到"
junit-4.12.jar -> 找不到
   org.junit                                          -> org.hamcrest                                       找不到
   org.junit.experimental.results                     -> org.hamcrest                                       找不到
   org.junit.internal                                 -> org.hamcrest                                       找不到
   org.junit.internal.matchers                        -> org.hamcrest                                       找不到
   org.junit.matchers                                 -> org.hamcrest                                       找不到
   org.junit.matchers                                 -> org.hamcrest.core                                  找不到
   org.junit.rules                                    -> org.hamcrest                                       找不到

找到了！那我们看看Hamcrest需要哪些依赖:

jar -d -f lib/hamcrest-core-1.3.jar
找不到模块描述符。已派生自动模块。

hamcrest.core@1.3 automatic
requires java.base mandated
contains org.hamcrest
contains org.hamcrest.core
contains org.hamcrest.internal

jdeps -s lib/hamcrest-core-1.3.jar
hamcrest-core-1.3.jar -> java.base

Hamcrest没有缺失的依赖了，下面我们看看src文件的内容:

src
└── src/com.greetings
    ├── src/com.greetings/main
    │   └── src/com.greetings/main/java
    │       └── src/com.greetings/main/java/com
    │           └── src/com.greetings/main/java/com/greetings
    │               ├── src/com.greetings/main/java/com/greetings/Greet.java
    │               └── src/com.greetings/main/java/com/greetings/Main.java
    ├── src/com.greetings/module-info.java
    └── src/com.greetings/test
        └── src/com.greetings/test/java
            └── src/com.greetings/test/java/com
                └── src/com.greetings/test/java/com/greetings
                    └── src/com.greetings/test/java/com/greetings/GreetTest.java

这是src的目录结构，然后再看看四个文件的内容:

cat src/com.greetings/module-info.java
module com.greetings {
        //1：声明需要的模块
        //2：设置对自动化模块可访问
}

cat src/com.greetings/main/java/com/greetings/Greet.java
package com.greetings;

import java.util.Arrays;
import java.util.stream.Collectors;

public class Greet {

    String greeting(String... names) {
        if ((names == null) || (names.length == 0)) {
            return "Hello World!";
        } else {
            return Arrays.stream(names)
                    .map(name -> String.format("Hello %s!", name))
                    .collect(Collectors.joining("\n"));
        }
    }

}

cat src/com.greetings/main/java/com/greetings/Main.java
package com.greetings;

public class Main {

    public static void main(String[] args) {
        Greet greet = new Greet();
        System.out.println(greet.greeting(args));
    }

}

cat src/com.greetings/test/java/com/greetings/GreetTest.java
package com.greetings;

import org.junit.Test;

import static org.junit.Assert.assertEquals;

public class GreetTest {

    @Test
    public void greetingNobody_greetsTheWorld() {
        Greet greet = new Greet();

        assertEquals(
                greet.greeting(),
                "Hello World!"
        );
    }

    @Test
    public void greetingEmptyArray_greetsTheWorld() {
        Greet greet = new Greet();

        assertEquals(
                greet.greeting(new String[0]),
                "Hello World!"
        );
    }

    @Test
    public void greetingOnePerson_greetsThatPerson() {
        Greet greet = new Greet();

        assertEquals(
                greet.greeting("Alice"),
                "Hello Alice!"
        );
    }

    @Test
    public void greetingSeveralPeople_greetsAllOfThem() {
        Greet greet = new Greet();

        assertEquals(
                greet.greeting("Alice", "Bob", "Charlie"),
                "Hello Alice!\nHello Bob!\nHello Charlie!"
        );
    }

    @Test
    public void greetingArrayOfPeople_greetsAllOfThem() {
        Greet greet = new Greet();

        assertEquals(
                greet.greeting(new String[]{"Alice", "Bob", "Charlie"}),
                "Hello Alice!\nHello Bob!\nHello Charlie!"
        );
    }
}

内容其实挺简单，打印Hello,world或者打印Hello,人名，在module-info.java文件中设置了一个小问题，可以试着填一填，答案在文章末尾。大体内容我们知道了，可是我们应该怎么编译呢:

javac [3：设置自动化模块路径] \
      -d mods/main/com.greetings \
      src/com.greetings/module-info.java \
      src/com.greetings/main/java/com/greetings/Greet.java \
      src/com.greetings/main/java/com/greetings/Main.java

答案也在文章末尾，可以自己试着编译一下。我们来运行一下:

java --module-path mods/main:lib \
          --module com.greetings/com.greetings.Main
//Hello World!

java --module-path mods/main:lib \
         --module com.greetings/com.greetings.Main \
        Alice Bob Charlie
//Hello Alice!
//Hello Bob!
//Hello Charlie!

再来编译一下GreetingTest类:

javac --module-path mods:lib \
          -d mods/test/com.greetings \
          src/com.greetings/module-info.java \
          src/com.greetings/main/java/com/greetings/Greet.java \
          src/com.greetings/test/java/com/greetings/GreetTest.java

运行一下:

java --module-path mods/main:lib \
         --add-modules com.greetings \
         --patch-module com.greetings=mods/test/com.greetings \
         --module junit/org.junit.runner.JUnitCore \
        com.greetings.GreetTest
//JUnit version 4.12
.....
Time: 0.013

OK (5 tests)

完成！将非模块化jar包转换成自动模块化jar包大体就是这样了，如果遇见不会的java命令，可以通过--help查看说明。

jlink

jlink有什么用呢，其实很简单，我们可以通过jlink构造自己的jre，前文提到rt.jar包很臃肿，jlink可以帮助我们构建精巧的运行环境。那我们先来看看整个项目的内容，内容很简单，和第二个小测试一样，可以快速浏览一下，主要是为了练习使用jlink工具的使用:

//结构目录
src
├── src/com.greetings
│   ├── src/com.greetings/com
│   │   └── src/com.greetings/com/greetings
│   │       └── src/com.greetings/com/greetings/Main.java
│   └── src/com.greetings/module-info.java
└── src/org.astro
    ├── src/org.astro/module-info.java
    └── src/org.astro/org
        └── src/org.astro/org/astro
            └── src/org.astro/org/astro/World.java

//文件内容
cat src/com.greetings/module-info.java
module com.greetings {
        requires org.astro;
}

cat src/com.greetings/com/greetings/Main.java
package com.greetings;

import org.astro.World;

public class Main {
        public static void main(String[] args) {
                System.out.format("Greetings %s!%n", World.name());
        }
}

cat src/org.astro/module-info.java
module org.astro {
        exports org.astro;
}

cat src/org.astro/org/astro/World.java
package org.astro;

public class World {
        public static String name() {
                return "World";
        }
}

那我们编译一下:

javac -d mods/com.greetings \
        src/org.astro/module-info.java \
        src/org.astro/org/astro/World.java

javac --module-path mods \
      -d mods/org.astro \
      src/com.greetings/module-info.java \
      src/com.greetings/com/greetings/Main.java

jlink工具目前要求模块路径上的模块以模块化JAR或JMOD格式打包，所以我们将他们打成jar包:

jar --create \
    --file mlib/org.astro@1.0.jar \
        --module-version 1.0  \
        -C mods/org.astro .

jar --create \
    --file mlib/com.greetings.jar \
        --main-class=com.greetings.Main \
        -C mods/com.greetings .

好了，已经打成模块化jar包了，开始jlink！

 jlink --module-path "${JAVA_HOME}"/jmods:mlib \
        --add-modules com.greetings \
        --output executable

完成！我们把执行文件输出到了excutable文件夹，如果对这些命令选项不太理解，可以通过jlink --help来查看命令解释。我们现在已经可以执行了:

./executable/bin/java --module-path mods --module com.greetings/com.greetings.Main
//Greetings World!
./executable/bin/java -jar mlib/com.greetings.jar com.greetings.Main
//Greetings World!

是不是很神奇，我们使用了executable中的java命令，对，他就是自定义的jre环境。如果感兴趣可以查看一下excutable中的结构。

jmod

jmod可以对模块或jar包压缩的一个工具，但他的格式和jar包不一样。

直接在上个练习目录中试用命令就好。

jmod create \
              --class-path mods/com.greetings:mods/org.astro \
              greetings.jmod

然后查看一下:

jmod list greetings.jmod
classes/module-info.class
classes/com/greetings/Main.class
classes/org/astro/World.class

更多的命令解释可以查看一下jmod --help，我就不多做解释了。

java9的新功能真的挺有意思的，我这只是冰山一角，想了解更详细的内容最好去看oracle的文档，最后附送一张图，是java9模块化的小表单。

最后的最后，上面命令的答案想出来了吗，公布一下结果:

1.requires junit

2.opens com.greetings to junit

3.--module-path lib