Java9模块化学习笔记三之迁移到Java9

java[c]命令行参数文件

鉴于迁移到java9后可能须要很长的命令行参数,有些os会限制命令行长度,java9支持定义一个命令行参数文件。使用方式:java

java @arguments.txt

arguments.txt内容(每一个选项一行):spring

-cp application.jar:javassist.jar
--add-opens java.base/java.lang=ALL_UNNAMED
--add-exports java.base/sun.security.x509=ALL_UNNAMED
-jar application.jar

Jdeps

前面咱们说过之前不少时候咱们或第三方库使用jdk不推荐使用的内部类,好比sun.,jdk.internal.,在jdk9以后这些类被强封装了,为了保持兼容性,默认运行运行时访问,其行为能够经过java选项--illegal-access=值,控制,默认值为permit,其余可选值有warn,debug,denysql

除此以外还有些类被移除了,好比sun.misc.Base64Decoder/Base64Encoder, 不过提供了替代方案java.util.Encoder
咱们能够借助于jdeps工具来发现这些问题,使用方式:express

jdeps -jdkinternals Xxx.class

注意:jdeps只能用于分析class文件或jar,不能用于分析源码文件apache

使用jdeps分析 classpath-based依赖:
.
├── jars
│ ├── jackson-annotations-2.8.8.jar
│ └── jackson-core-2.8.8.jar
| └── jackson-databind-2.8.8.1.jar
└── outapi

├── demo
     ├── Book.class
     └── Main.class

好比分析上面的这个模块:app

jdeps -recursive -summary -cp lib/*.jar out

-recusive表明requires transitive的也会被分析,-summary表明汇总依赖信息,否则会打印很长的依赖信息, -cp classpath, out就是须要被分析的class/jar文件路径maven

tjw$ jdeps -recursive -summary -cp lib/*.jar out
jackson-annotations-2.8.8.jar -> java.base
jackson-core-2.8.8.jar -> java.base
jackson-databind-2.8.8.jar -> lib/jackson-annotations-2.8.8.jar
jackson-databind-2.8.8.jar -> lib/jackson-core-2.8.8.jar
jackson-databind-2.8.8.jar -> java.base
jackson-databind-2.8.8.jar -> java.desktop
jackson-databind-2.8.8.jar -> java.logging
jackson-databind-2.8.8.jar -> java.sql
jackson-databind-2.8.8.jar -> java.xml
out -> lib/jackson-databind-2.8.8.jar
out -> java.base

上面的依赖分析显示,咱们的代码直接依赖jackson-databind,故而咱们在迁移到模块时应将jackson-databind做为Automic Module,故而迁移到模块化后的代码结构以下:
.
├── lib
│ ├── jackson-annotations-2.8.8.jar
│ └── jackson-core-2.8.8.jar
├── mods
│ └── jackson-databind-2.8.8.jar //这里会被做为Automic Module
└── src模块化

└── books
    ├── demo
    │   ├── Book.java
    │   └── Main.java
    └── module-info.java

module-info.java内容:工具

module books {
    requires jackson.databind;
    opens demo;
}

使用jdeps分析 module-based依赖:
jdeps -module-path out:mods -m books

注意:使用jdeps咱们还能够利用-dotoutput选项来输出模块的依赖关系图做为文件保存

除了分析依赖以外,jdeps还能够生成module-info.java,这在迁移已有三方库的时候特别有用:

jdeps --generate-module-info ./out mylibrary.jar

JAXB与其余JavaEE API

java.se.ee模块
clipboard.png

Automatic Modules

除了以前说的unamed modules,还有一种叫automatic modules,这是为解决已有三方库迁移到模块化的问题。已有三分库能够自动转成模块,只要在启动时将jar放在指定--module-path路径中,便会自动变成automatic module。
automatic module的特性:一、该module自己是open的;二、该module的依赖由开发者自行解决,编译时没法找出相关问题;三、automatic module与explicit module的区别在于,前者能够无限制访问unamed module,然后者遵循模块的封装性原则。
automatic modules模块名: 好比jackson-databind-2.8.8.jar,在java定义它成模块时,首先须要扫描MATA-INF/MANIFEST.MF中的Automatic-Module-Name字段,若是没有这个字段,那么就以jar文件名字做为模块名,好比jackson-databind-2.8.8.jar的模块名就是jackson.databind,转成模块名时会把-替换成. 而后版本号会被忽略掉。

clipboard.png

迁移示例:迁移Spring And Hibernate

未迁移代码就不列出来了,迁移后的代码结构以下:

.
├── README.md
├── lib
│   ├── hsqldb-2.3.4.jar
│   ├── ...
│   ├── slf4j-api-1.7.21.jar
│   ├── slf4j-simple-1.7.21.jar
│   ├── spring-aop-4.3.2.RELEASE.jar
│   ├── spring-beans-4.3.2.RELEASE.jar
│   ├── spring-core-4.3.2.RELEASE.jar
│   ├── spring-expression-4.3.2.RELEASE.jar
│   ├── spring-jdbc-4.3.2.RELEASE.jar
│   └── spring-orm-4.3.2.RELEASE.jar
├── mods
│   ├── hibernate-core-5.2.2.Final.jar
│   ├── hibernate-jpa-2.1-api-1.0.0.Final.jar
│   ├── javassist-3.20.0-GA.jar
│   ├── javax.inject-1.jar
│   ├── spring-context-4.3.2.RELEASE.jar
│   └── spring-tx-4.3.2.RELEASE.jar
├── run.sh
└── src
    └── bookapp
        ├── books
        │   ├── api
        │   │   ├── entities
        │   │   │   └── Book.java
        │   │   └── service
        │   │       └── BooksService.java
        │   └── impl
        │       ├── entities
        │       │   └── BookEntity.java
        │       └── service
        │           └── HibernateBooksService.java
        ├── bookstore
        │   ├── api
        │   │   └── service
        │   │       └── BookstoreService.java
        │   └── impl
        │       └── service
        │           └── BookstoreServiceImpl.java
        ├── log4j2.xml
        ├── main
        │   └── Main.java
        ├── main.xml
        └── module-info.java

module-info.java内容

module bookapp {
    requires spring.context;
    requires spring.tx;

    requires javax.inject;

    requires hibernate.core;
    requires hibernate.jpa;

    exports books.api.entities;
    exports books.api.service;
    opens books.impl.entities;
    opens books.impl.service;

    exports bookstore.api.service;
    opens bookstore.impl.service;
}

run.sh内容

CP=lib/antlr-2.7.7.jar:
...
CP+=lib/slf4j-api-1.7.21.jar:
CP+=lib/slf4j-simple-1.7.21.jar:
CP+=lib/spring-aop-4.3.2.RELEASE.jar:
CP+=lib/spring-beans-4.3.2.RELEASE.jar:
CP+=lib/spring-core-4.3.2.RELEASE.jar:
CP+=lib/spring-expression-4.3.2.RELEASE.jar:
CP+=lib/spring-jdbc-4.3.2.RELEASE.jar:
CP+=lib/spring-orm-4.3.2.RELEASE.jar

$JAVA_HOME/bin/javac -cp $CP \
      --module-path mods \
      --add-modules java.naming \
      -d out         \
      --module-source-path src \
      -m bookapp

cp $(find src -name '*.xml') out/bookapp

$JAVA_HOME/bin/java -cp $CP \
     --module-path mods:out       \
     --add-modules java.xml.bind,java.sql \
     --add-opens java.base/java.lang=javassist \
     -m bookapp/main.Main

咱们还能够将本身的应用拆分为多个模块
演化图以下:
clipboard.png
clipboard.png
clipboard.png

迁移Library到模块化

迁移方式一,迁移为Automatic Module,适用于没有源码的情形:
模块名:在MANIFEST.MF中定义

Automatic-Module-Name: com.javamodularity.modulename
jar -cfm mylibrary.jar META-INF/MANIFEST.MF -C out/ .

你也可使用maven插件

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-jar-plugin</artifactId>
    <configuration>
        <archive>
            <manifestEntries>
                <Automatic-Module-Namec>com.mymodule</Automatic-Module-Name>
            </manifestEntries>
        </archive>
    </configuration>
</plugin>

迁移方式二,迁移为explicit module,适用于库的做者或者有源码的情形:
首先借助jdeps生成module-info.java,而后进行简单修改

jdeps --generate-module-info ./out mylibrary.jar  //你也可使用--generate-open-module选项

方式三,迁移为explicit module,即便没有源码:

mkdir mylibrary
cd mylibrary
jar -xf ../mylibrary.jar
cd ..
javac -d mylibrary out/mylibrary/module-info.java
jar -uf mylibrary.jar -C mylibrary module-info.class

针对不一样版本发布 javac --release 版本号 好比 javac --release 8

模块化开发工具

maven

.
├── README.md
├── algorithm.api
│   ├── pom.xml
│   └── src
│       └── main
│           └── java
│               ├── javamodularity
│               │   └── easytext
│               │       └── algorithm
│               │           └── api
│               │               ├── Analyzer.java
│               │               ├── Preprocessing.java
│               │               └── SyllableCounter.java
│               └── module-info.java
├── cli
│   ├── README.adoc
│   ├── pom.xml
│   └── src
│       └── main
│           ├── java
│           │   ├── javamodularity
│           │   │   └── easytext
│           │   │       └── cli
│           │   │           └── Main.java
│           │   └── module-info.java
│           └── resources
│               └── test.txt
├── gui
│   ├── gui.iml
│   ├── pom.xml
│   └── src
│       └── main
│           └── java
│               ├── javamodularity
│               │   └── easytext
│               │       └── gui
│               │           └── Main.java
│               └── module-info.java
├── pom.xml
└── run.sh
<build>
      <plugins>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-compiler-plugin</artifactId>
          <version>3.6.1</version>
          <configuration>
            <release>9</release>
          </configuration>
        </plugin>
      </plugins>
</build>

使用maven执行模块

<build>
    <plugins>
      <plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>exec-maven-plugin</artifactId>
        <version>1.6.0</version>
        <executions>
          <execution>
            <goals>
              <goal>exec</goal>
            </goals>
          </execution>
        </executions>
        <configuration>
          <executable>${JAVA_HOME}/bin/java</executable>
          <arguments>
            <argument>--module-path</argument>
            <modulepath/>
            <argument>--module</argument>
            <argument>easytext.cli/javamodularity.easytext.cli.Main</argument>
            <argument>${easytext.file}</argument>
          </arguments>
        </configuration>
      </plugin>
    </plugins>
  </build>

具体执行命令 mvn exec:exec

相关文章
相关标签/搜索