JPMS 全称是 Java Platform Module system(Java 平台模块化系统)。它的目的简单直接:编译期间检查和强化封装。随之而来的好处就是及时反馈,不用等到运行时才出现NoClassDefFoundError
;局部化影响,便于松耦合的开发和调优,当然还有运行时的安全。
编译期检查
JPMS 要求每个定义好的模块下面放置 module-info.java 描述文件(Module Descriptor),用于描述本模块依赖(requires)外部哪些模块,以及对外暴露(exports)本模块中的哪些包(package)。
一旦描述了依赖外部的哪些模块,编译时,就会自动检查这些模块是否已经处于module path 下,如果不在就会报错。
强化封装
除了原有的访问修饰符 public, protected, private, default
形成的访问限制外,模块又强化一层有访问控制。除非模块通过exports
关键字暴露出某些包,否则即便是public
的类,外部也无法访问。另外值得注意的是,以前即使是private
的方法,使用反射调用setAccessible(true)
也可以随意调用,但在 JPMS 下是行不通的。
项目实验
基于上述的基础知识,我在原来托管在 github 上的开源项目 underscore.string.java 上另起了一个 jigsaw 的分支 underscore.string.java-jigsaw,实验了单个模块的用法。
基本步骤
- src/main/java/ 目录下新建 module-info.java
- 引入
gradle plugin org.gradle.java.experimental-jigsaw
- 修改 .travis.yml 以支持 java9 编译
1. 模块描述文件
module com.lambeta.underscorestring {
exports com.lambeta;
requires guava;
}
为了方便别人调用,需要起一个比较简短的名字,又因为最好唯一,所以用了 com.lambeta.underscorestring
。这个模块会导出包 com.lambeta
,事实上,我的项目只有一个包。另外,它需要依赖 guava
模块。
2. gradle 插件
gradle 如何支持 java9 的模块系统,这篇文章已经细说。我最终还是选用了一个实验版的插件使用,因为比较简单。
plugins {
id 'org.gradle.java.experimental-jigsaw' version '0.1.1'
}
javaModule.name = 'com.lambeta.underscorestring'
javadoc {
excludes = ['module-info.java']
}
告知 gradle,这个模块的名字是 com.lambeta.underscorestring
,这个和 gradle 的多模块项目一起使用,效果最佳。
javadoc 的配置,主要针对是执行 javadoc 任务,出现了 module not found: guava
的错误。这应该是 gradle javadoc 的一个 bug,Maven 项目中有类似的记载,后续会解决。不过现在,直接跳过该文件。
3. CI 服务
language: java
jdk: oraclejdk9
sudo: false
dist: trusty
script:
"./gradlew check -i"
addons:
hosts:
- lambetaBuild
hostname: lambetaBuild
光速跟进的travis.ci 已经支持了 oracle jdk9,稍加配置,就可以使用上持续集成服务。
当然,这里面还有不少需要琢磨的内容,比如:guava18 在 gradle4.2 下如何就能作为模块 guava
被依赖?要知道,guava23.1 还没有加上 Automatic-Module-Name 呢。
网友评论