• 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程序,也需要这么一个庞然大物支撑。

    nothing

    再或者,我们依赖一个大的工具包,但我们可能只需要其中几个类的功能。之前的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!
    

    这个例子中要注意exportsrequires的用法,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
    

    有点多,我们先理一理其中的关系
    image
    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;
    }
    
    

    其中有个provideswith,意思就是为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.socketMain.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为例,ConcurrentHashMapjava.base模块中的一个类,我们将自定义的ConcurrentHashMap类替换java.baseConcurrentHashMap

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

    ├── 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中的ConcurrentHashMapjava.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.langjava.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("
    "));
            }
        }
    
    }
    
    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!
    Hello Bob!
    Hello Charlie!"
            );
        }
    
        @Test
        public void greetingArrayOfPeople_greetsAllOfThem() {
            Greet greet = new Greet();
    
            assertEquals(
                    greet.greeting(new String[]{"Alice", "Bob", "Charlie"}),
                    "Hello Alice!
    Hello Bob!
    Hello 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构造自己的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

  • 相关阅读:
    案例8高级打砖块游戏
    案例17——Flash地图应用
    案例11——用遮障制作聚光灯效果及冷却动画
    案例1:用Flash CS工具制作进度条
    Flex 中可以应用于 ActionScript 类的元标签
    案例7用Flash Builder做虚拟计算器
    案例16——没特效还玩毛个Flash
    案例9不要在加载时面对苍白的屏幕
    案例15——游戏物品栏的制作(AS3高级应用)
    案例2心跳模拟
  • 原文地址:https://www.cnblogs.com/krcys/p/8657282.html
Copyright © 2020-2023  润新知