33
第 3 章
使用模块
在本章,将迈出使用 Java 9 进行模块开发的第一步,即动手编写自己的第一个模块,而
不仅仅是查看 JDK 中现有的模块。为了轻松地走好第一步,首先创建一个最简单的模
块,可以将其称为 Modular Hello World。有了相关的经验之后,就可以开始创建带有多
个模块的更复杂的示例了,此时将会介绍贯穿本书的运行示例 EasyText。随着对模块系
统的进一步了解,该示例的设计也将逐步完善。
3.1 第一个模块
在前一章,已经给出了模块描述符的示例。然而,一个模块通常不只是一个描述符。因
此,Modular Hello World 超越了单个源文件的级别:需要在上下文中来研究该示例。我
们将从编译、打包和运行单个模块开始,以了解模块的新工具选项。
3.1.1 剖析模块
第一个示例的目的是将下面所示的类编译成一个模块并运行(见示例 3-1)。首先从一
个包的单一类开始,编译成单一模块。模块可能仅包含包中的类型,所以需要一个包
定义。
示例 3-1:HelloWorld.java( chapter3/helloworld)package com.javamodularity.helloworld;
public class HelloWorld {
public static void main(String... args) { System.out.println("Hello Modular World!"); }
}
34 | 第 3章
文件系统中源文件的布局如下所示:
src└─ helloworld ❶ ├─ com │ └─ javamodularity │ └─ helloworld │ └─ HelloWorld.java └─ module-info.java ❷
❶ 模块目录。
❷ 模块描述符。
相比于 Java 源文件的传统布局,上述布局存在两个主要区别。首先,有一个额外的间接
层:在 src 的下面引入了另一个目录 helloworld,该目录以所创建的模块名称命名。其
次,在模块目录中找到了源文件(像往常一样嵌套在包结构中)和一个模块描述符。模
块描述符位于 module-info.java 文件中,是 Java 模块的关键组成部分。它的存在相当于
告诉 Java 编译器正在使用的是一个模块,而不是普通的 Java 源代码。如本章的后续内
容所述,与普通的 Java 源文件相比,当使用模块时,编译器的行为是完全不同的。模块
描述符必须存在于模块目录的根目录中。它与其他源文件一起编译成一个名为 module-info.class 的二进制类文件。
模块描述符的内部是什么呢? Modular Hello World 示例非常简单:
module helloworld {
}
此时,使用新关键字 module并紧跟模块名称声明了一个模块。该名称必须与包含模块
描述符的目录名称相匹配。否则,编译器将拒绝编译并报告匹配错误。
仅在多模块模式下(这种情况是非常常见的)运行编译器时,才需要满足名称
匹配要求。对于 3.1.3 节中所讨论的单模块方案,目录名称无关紧要。但在任
何情况下,使用模块名称作为目录名称不失为一个好主意。
由于模块声明体是空的,因此不会从 helloworld模块中导出任何内容到其他模块。
默认情况下,所有包都是强封装的。即使目前在这个声明中没有任何依赖关系信息,但
是请记住,该模块隐式地依赖 java.base平台模块。
此时,你可能会问,向语言中添加新的关键字是否会破坏使用 module作为标识符的现
有代码。幸运的是,情况并非如此。仍然可以在其他源文件中使用名为 module的标识
符,因为 module关键字是限制关键字(restricted keyword),它仅在 module-info.java
使用模块 | 35
中被视为关键字。对于目前在模块描述符中所看到的 requires关键字和其他新关键字
来说,也是一样的。
名称 module-info
通 常,Java 源 文 件 的 名 称 与 其 所 包 含 的(公 共) 类 型 相 对 应。 例 如, 包 含
HelloWorld 类的文件名必须为 HelloWorld.java。但名称 module-info 打破了这
种对应关系。此外,module-info 甚至不是一个合法的 Java 标识符,因为它包
含了破折号。这样做的目的是防止非模块感知工具盲目地将 module-info.java 或
module-info.class 作为普通的 Java 类加以处理。
为特殊源文件保留名称在 Java 语言中并不是没有出现过。在 module-info.java 之
前,就已经有了 package-info.java。该名称虽然可能相对比较陌生,但自 Java 5之后它就出现了。在 package-info.java 中,可以向包声明中添加文档和注释。与
module-info.java 一样,它也是由 Java 编译器编译成一个类文件。
现在,已经拥有了一个仅包含模块声明的模块描述符以及一个源文件。接下来可以编译
第一个模块了!
3.1.2 命名模块
命名事物虽然很难,但却很重要。尤其是对于模块而言更是如此,因为它们将传递应用
程序的高级结构。
模块名称所在的全局命名空间与 Java 中其他命名空间是分开的。因此,从理论上讲,模
块的名称可以与类、接口或包的名称相同。但实际上,这样做可能会导致混乱。
模块名称必须是唯一的:应用程序只能具有一个给定名称的模块。在 Java 中,通常使
用反向 DNS 符号来确保包名称全局唯一。可以对模块应用相同的方法。例如,可以将
helloworld模块重命名为 com.javamodularity.helloworld,但这样做会导致
模块名称过长且有些笨重。
应用程序中的模块名称是否需要全局唯一呢?答案是肯定的,当模块是已发布的库并且
在许多应用程序中使用时,选择全局唯一的模块名称就显得非常有意义了。在 10.2 节
中,将会进一步讨论这个概念。对于应用程序模块来说,要尽量选择更短且更令人难忘
的名称。
为了增加示例的可读性,本书选择使用更简短的模块名称。
36 | 第 3章
3.1.3 编译
有一个源文件格式的模块是一回事,但要运行该模块,首先必须进行编译。在 Java 9 之
前,Java 编译器使用目标目录以及一组源文件进行编译:
javac -d out src/com/foo/Class1.java src/com/foo/Class2.java
在实践中,通常是通过构建工具(如 Maven 或 Gradle)来完成的,但原理是一样的。在
目标目录中输出类(此时使用了 out),其中包含代表输入(包)结构的嵌套文件夹。按
照同样的模式,可以编译 Modular Hello World 示例:
javac -d out/helloworld \ src/helloworld/com/javamodularity/helloworld/HelloWorld.java \ src/helloworld/module-info.java
存在两个显著的区别:
• �输出到反映了模块名称的 helloworld 目录。
• �将 module-info.java 作为额外源文件进行编译。
在要编译的文件集中出现 module-info.java 源文件会触发 javac 的模块感知模式。下面显
示的输出是编译后的结果,也被称为分解模块(exploded module)格式:
out└─ helloworld ├─ com │ └─ javamodularity │ └─ helloworld │ └─ HelloWorld.class └─ module-info.class
最好在模块之后命名包含分解模块的目录,但不是必需的。最终,模块系统是从描述
符中获取模块名称,而不是从目录名称中。在 3.1.5 节中,将会创建并运行这个分解
模块。
编译多个模块
到目前为止所看到的都是所谓的 Java 编译器单模块模式(single-module mode)。通常,
需要编译的项目由多个模块组成,这些模块还可能会相互引用。又或者项目是单个模
块,但却使用了其他(已经编译)的模块。为了处理这些情况,引入了额外的编译器标
志:--module-source-path和 --module-path。这些标志都是 -sourcepath
和 -classpath标志(长期以来,这些标志一直是 javac 的一部分)的模块感应对应项。
在学习 3.2.2 节中的多模块示例时,将会解释其语义。请记住,模块源目录的名称必须
与在多模块模式下 module-info.java 中声明的名称相匹配。
使用模块 | 37
构建工具
直接通过命令行使用 Java 编译器、操作其标志以及手动列出所有源文件并不是常见的做
法,更常见的做法是使用 Maven 或 Gradle 等构建工具来抽取这些细节信息。因此,本
书不会详细介绍添加到 Java 编译器和运行时的每个新选项,可以在官方文档中找到相
关详细信息(http://bitly/tools-comm-ref)。当然,构建工具也需要适应新的模块化现实。
在第 11 章中,将介绍一些可以与 Java 9 一起使用的最流行的构建工具。
3.1.4 打包
到目前为止,已经创建了单个模块并将其编译为分解模块格式,在下一节将会讨论如何
运行分解模块。这种格式在开发环境下是可行的,但在生产环境中则需要以更方便的格
式分发模块。为此,可以将模块打包成 JAR 文件并使用,从而产生了模块化 JAR 文件。
模块化 JAR 文件类似于普通的 JAR 文件,但它还包含了 module-info.class。
JAR 工具已经进行了更新,从而可以使用 Java 9 中的模块。为了打包 Modular Hello World 示例,请运行下面的命令:
jar -cfe mods/helloworld.jar com.javamodularity.helloworld.HelloWorld \ -C out/helloworld .
通过上述命令,在 mods 目录(请确保该目录存在)中创建了一个新存档文件(-cf)
helloworld.jar。此外,还希望这个模块的入口点(-e)是 HelloWorld类;每当模块启
动并且没有指定另一个要运行的主类时,这是默认入口点。此时提供了完全限定的类名
称作为入口点的参数。最后,指示 jar 工具更改(-C)为 out/helloworld 目录,并将此目
录中的所有已编译文件放在 JAR 文件中。现在,JAR 的内容类似于分解模块,同时还额
外添加了一个 MANIFEST.MF 文件:
helloworld.jar├── META-INF│ └── MANIFEST.MF├── com│ └── javamodularity│ └── helloworld│ └── HelloWorld.class└── module-info.class
与编译期间的模块目录名称不同,模块化 JAR 文件的名称并不重要。可以使用任意喜欢
的文件名 , 因为模块由绑定的 module-info.class 中声明的名称所标识。
3.1.5 运行模块
现在,回顾一下目前所完成的事情。首先从 Modular Hello World 示例开始,创建了一个
38 | 第 3章
带有单个 HelloWorld.java 源文件和模块描述符的 helloworld模块。然后,将模块编
译成分解模块格式。最后,将分解模块打包成一个模块化 JAR 文件。这个 JAR 文件包
含了已编译的类和模块描述符,并且知道要执行的主类。
尝试运行模块,分解模块格式和模块化 JAR 文件都可以运行。可以使用下面的命令运行
分解模块格式:
$ java --module-path out \ --module helloworld/com.javamodularity.helloworld.HelloWorldHello Modular World!
还可以使用 --module-path的缩写格式 -p。标志 --module可以缩写
为 -m。
除了基于类路径的应用程序之外,Java 命令还获得了新的标志来处理模块。请注意,此
时将 out 目录(包含分解的 helloworld模块)放在模块路径上。模块路径是原始类路
径的模块感知对应项。
接下来使用 --module标志提供所运行的模块。此时,模块名称后跟斜杠,然后是要运
行的类。另一方面,如果运行模块化 JAR,则只需提供模块名称即可:
$ java --module-path mods --module helloworldHello Modular World!
这么做是有道理的,因为模块化 JAR 知道要从其元数据执行的类。在构建模块化 JAR 时
已经显式地将入口点设置为 com.javamodularity.helloworld.Hello World。
带有相应模块名称(和可选主类)的 --module或 -m标志必须始终在最后。
任何后续参数都将传递至从给定模块启动的主类。
以这两种方式中的任何一种启动都会使 helloworld成为执行的根模块。JVM 从这个
根模块开始,解析从模块路径运行根模块所需的任何其他模块。如前面的 2.7 节所述,
解析模块是一个递归过程:如果新解析的模块需要其他模块,那么模块系统会自动考虑
到这一点。
在简单的 HelloWorld例子中,没有执行太多的解析。可以向 java 命令中添加 --
show-module-resolution,从而跟踪模块系统所采取的操作:
使用模块 | 39
$ java --show-module-resolution --limit-modules java.base \ --module-path mods --module helloworldroot helloworld file:///chapter3/helloworld/mods/helloworld.jarHello Modular World!
(通过添加 java.base标志 --limit-modules,可以阻止通过服务绑定解析其他平
台模块。下一章将会详细介绍服务绑定。)
此时,除了隐式需要的平台模块 java.base之外,不再需要其他模块来运行
helloworld。在模块解析输出中仅显示了根模块 helloworld。这意味着运行
Modular Hello World 示例仅涉及运行时的两个模块,即 helloworld和 java.base,
其他平台模块或者模块路径上的模块都没有解析。在类加载期间,没有任何资源被浪费
在搜索与应用程序无关的类上。
通过使用 -Xlog:module=debug,可以显示更多关于模块解析的诊断信息。
以 -X开头的选项都是非标准的,那些不是基于 OpenJDK 的 Java 实现可能不
支持这些选项。
如果需要另一个模块来运行 helloworld,并且该模块不存在于模块路径上(或不是
JDK 平台模块的一部分),那么在启动时就会遇到错误。这种形式的可靠配置解决了使用
类路径所面临的问题。在模块系统出现之前,只有当 JVM 在运行时尝试加载不存在的
类时才会注意到缺少的依赖项。通过使用模块描述符的显式依赖信息,模块解析可以确
保在运行任何代码之前对模块进行工作配置。
3.1.6 模块路径
虽然模块路径听起来与类路径类似,但两者的行为却完全不同。模块路径是各个模块
以及包含模块的目录的路径列表。模块路径上的每个目录都可以包含零个或多个模
块定义,其中模块定义可以是分解模块或模块化 JAR 文件。包含三个选项的示例模
块 路 径 如 下 所 示:out/:myexplodedmodule/:mypackagedmodule.jar。out目录中的所有模块都在模块路径上,并与模块 myexplodedmodule(目录)以及
mypackagedmodule(模块化 JAR 文件)相结合。
模块路径上的条目由默认的平台分隔符分隔。在 Linux/macOS 上,分隔符是一
个冒号(java -p dir1:dir2);而在 Windows 上,则使用分号(java -p
dir1; dir2)。标志 -p是 --module-path的缩写。
最重要的是,模块路径上的所有工件都有模块描述符(可能是在运行中合成,8.4 节将会
40 | 第 3章
详细讨论相关内容),解析器依赖此信息找到模块路径上的正确模块。当模块路径上相同
目录中具有相同名称的多个模块时,解析器就会显示错误,并且不会启动应用程序。这
样一来,就可以防止以前在类路径上可能发生的 JAR 文件冲突的问题。
当具有相同名称的多个模块位于模块路径上的不同目录中时,则不会产生错
误,而是选择第一个模块,并忽略具有相同名称的后续模块。
3.1.7 链接模块
前一节所示的模块系统仅解析了两个模块:helloworld和 java.base。如果可以利
用前面所学到的知识创建一个 Java 运行时的特殊分布,其中包含运行应用程序所需的
最少模块,岂不是很好?而这正是在 Java 9 中使用自定义运行时映像(custom runtime image)所完成的事情。
在编译和运行时阶段之间,Java 9 引入了一个可选的链接阶段。通过使用一个名为 jlink的新工具,可以创建仅包含运行应用程序所需的模块的运行时映像。使用以下命令,创
建一个以 helloworld为根模块的运行时映像:
$ jlink --module-path mods/:$JAVA_HOME/jmods \ --add-modules helloworld \ --launcher hello=helloworld \ --output helloworld-image
jlink 工具位于 JDK 安装目录下的 bin 目录。在默认情况下并没有将它添加到系
统路径中,所以想要在示例中使用该工具,必须首先将其添加到路径中。
第一个选项是构造一个模块路径,其中包含 mods 目录(helloworld 所在的位置)以
及要链接到映像中的平台模块的 JDK 安装目录。与 javac 和 java 不同,必须将平台模块
显式添加到 jlink 模块路径中。随后,--add-modules表示 helloworld是需要在运
行时映像中运行的根模块。--launcher定义了一个入口点来直接运行映像中的模块。
最后,--output表示运行时映像的目录名称。
运行上述命令的结果是生成一个新目录,包含了一个完全适合运行 helloworld的
Java 运行时:
helloworld-image├── bin│ ├── hello ❶
使用模块 | 41
│ ├── java ❷│ └── keytool├── conf│ └── ...├── include│ └── ...├── legal│ └── ...├── lib│ └── ...└── release
❶ 直接启动 helloworld模块的可执行脚本。
❷ 仅能解析 helloworld及其依赖项的 Java 运行时。
由于解析器知道除了 helloworld之外只需要使用 java.base,因此无须向运行时映
像中添加更多的内容。因此,生成的运行时映像比完整的 JDK 小许多。可以在资源受
限的设备上使用自定义运行时映像,或者将其作为在云中运行应用程序的容器映像的基
础。虽然链接是可选的,却可以大大减少应用程序的占用空间。在第 13 章中,将会更
详细地讨论自定义运行时映像的优点以及如何使用 jlink。
3.2 任何模块都不是一座孤岛
到目前为止,为了便于理解模块的创建机制和相关工具,特意将事情进行了简单化。然
而,模块系统的真正魅力在于组合使用多个模块。也只有这样,模块系统的优势才会显
现出来。
扩展 Modular Hello World 示例将是一件相当无聊的事情,因此,这里使用一个更有趣的
示例应用程序 EasyText。首先从单个模块开始,然后逐渐创建一个多模块应用程序。虽
然 EasyText 示例可能没有典型的企业应用程序那么大,但在实践中可以作为一种学习工
具来使用。
3.2.1 EasyText 示例介绍
EasyText 是一个分析文本复杂性的应用程序。事实证明,可以将一些非常有趣的算法应
用到文本以确定它的复杂性。如果对细节感兴趣,请阅读随后的“文本的复杂性”分析。
当然,我们关注的不是文本分析算法 , 而是构成 EasyText 应用程序的模块组合,主要目
标是使用 Java 模块来创建灵活且可维护的应用程序。以下是 EasyText 模块化实现所需
满足的要求:
• 必须能够在不修改或不重新编译现有模块的情况下添加新的分析算法。
42 | 第 3章
• 不同的前端(如 GUI 和命令行)必须能够重用相同的分析逻辑。
• 必须支持不同的配置,同时无须重新编译,也无须部署每个配置的所有代码。
当然,即使不使用模块也可以满足所有这些需求。不过,这不是一件容易的工作。使用
Java 模块系统有助于更容易地满足这些要求。
文本的复杂性
虽然 EasyText 示例的重点是介绍解决方案的结构,但仍然可以学习其他新内容。
文本分析是一个有着悠久历史的领域。EasyText 应用程序将可读性公式(readability formula)应用于文本。其中最受欢迎的可读性公式是 Flesch-Kincaid 评分:
复杂度 flesch_kincaid =206.835–1.015totalwords
totalsentences–84.6
totalsyllablestotalwords
通过使用文本中一些相对容易的可推导性指标,可以计算得分。如果一个文本得分
在 90 到 100 之间,那么普通 11 岁的学生可以很容易理解该文本,而得分在 0 到
30 范围内的文本则最适合研究生阶段的学生。
当然,还有很多其他可读性公式,如 Coleman-Liau 和 Fry 可读性公式,另外还有
许多局部化公式。每个公式都有自己的范围,不存在最好的公式。当然,这也是一
个让 EasyText 尽可能灵活的原因。
本章及其后续章节将会满足前面的所有要求。从功能角度来看,文本分析由以下步骤
组成:
1)读取输入文本(从文件、GUI 或者其他地方获取)。
2)将文本拆分成句子和单词(因为许多可读性公式需要使用句子或单词)。
3)对文本进行一次或者多次分析。
4)向用户显示结果。
刚开始,其实现由单个模块 easytext构成。从这一点上看,不存在关注点分离的问
题。该模块内只有一个包,如示例 3-2 所示。
示例 3-2:包含单个模块的 EasyText( chapter3/easytext-singlemodule)src└── easytext ├── javamodularity │ └── easytext │ └── Main.java └── module-info.java
使用模块 | 43
模块描述符是空的。Main类首先读取了一个文件,然后应用了一个可读性公式(Flesch-Kincaid),最后向控制台打印结果。在对包进行编译和打包之后,工作过程如下所示:
$ java --module-path mods -m easytext input.txtReading input.txtFlesh-Kincaid: 83.42468299865723
显而易见,单个模块无法满足上述要求,接下来是时候添加更多的模块了。
3.2.2 两个模块
第一步,需要将文本分析算法和主程序分离成两个模块。这样一来,就可以在不同的前
端模块上重复使用分析模块。主模块使用分析模块,如图 3-1 所示。
图 3-1:两个模块中的 EasyText
easytext.cli模 块 包 含 了 命 令 行 处 理 逻 辑 以 及 文 件 解 析 代 码。easytext.
analysis模块包含了 Flesch-Kincaid 算法的实现过程。在分离单个 easytext模块的
过程中,在两个不同的包中创建了两个新模块,如示例 3-3 所示。
示例 3-3:包含两个模块的 EasyText( chapter3/easytext-twomodules)src├── easytext.analysis│ ├── javamodularity│ │ └── easytext│ │ └── analysis│ │ └── FleschKincaid.java│ └── module-info.java└── easytext.cli ├── javamodularity │ └── easytext │ └── cli │ └── Main.java └── module-info.java
所不同的是,现在 Main类将算法分析委托给 FleschKincaid类。因为有两个相互独
立的模块,所以需要使用 javac 的多模块模式进行编译。
44 | 第 3章
javac -d out --module-source-path src -m easytext.cli
此后,假设示例的所有模块总是被编译在一起的。只需使用 -m指定要编译的实际模块
即可,而无须列出所有源文件作为编译器的输入。在这种情况下,提供 easytext.
cli模块就足够了。编译器通过模块描述符知道,easytext.cli也需要 easytext.
analysis(也是通过模块源路径进行编译)。当然,也可以像示例 Hello World 那样只
提供所有源文件列表 (不使用 -m)。1
--module-source-path标志告诉 javac 在编译期间去哪里查找源格式的其他模块。
在多模块模式下进行编译时,必须使用 -d 提供目标目录。编译之后,目标目录包含了
分解模块格式的编译模块。此输出目录还可以用作运行模块时模块路径上的一个元素。
在本示例中,当编译 Main.java 时,javac 在模块源中查找 FleschKincaid.java。但编译器
是如何知道在 easytext.analysis模块中查找该类呢?如果使用类路径,那么该类
可以位于编译类路径上的任何 JAR 中。请记住,类路径是一个类型的平面列表。但模块
路径却不是这样,它仅处理模块。当然,所缺少的部分位于模块描述符的内容中。这些
内容提供了必要的信息以找到正确的模块并导出指定包。这样一来,不管所需的类在哪
里,都无须漫无目的地扫描所有可用类。
为了让示例正常运行,还需要表示出如图 3-1 所示的依赖关系。分析模块需要导出包含
FleschKincaid 类的包:
module easytext.analysis { exports javamodularity.easytext.analysis;}
通过使用关键字 exports,可以将模块中的包公开以供其他模块使用。通过声明导出
包 javamodularity.easytext.analysis,其所有的公共类型都可以被其他模块
使用。一个模块可以导出多个包。在本示例中,仅将 FleschKincaid类导出。反之,
模块中未导出的包都是模块私有的。
前面已经介绍了分析模块如何导出包含 FleschKincaid类的包,而 easytext.cli
的模块描述符需要表达对分析模块的依赖:
module easytext.cli { requires easytext.analysis;}
之所以需要 easytext.analysis模块,是因为 Main类导入了来自该模块的
FleschKincaid类。完成了上述的模块描述符之后,就可以编译和运行代码了。
在 Linux/ macOS 系统上,可以很容易地提供 $(find.-name'* .java')作为编译器的最
后一个参数来实现此目的。
使用模块 | 45
如果在模块描述符中省略 requires语句,会发生什么事情呢?此时,编译器将产生如
下所示的错误:
src/easytext.cli/javamodularity/easytext/cli/Main.java:11: error: package javamodularity.easytext.analysis is not visibleimport javamodularity.easytext.analysis.FleschKincaid; ^ (package javamodularity.easytext.analysis is declared in module easytext.analysis, but module easytext.cli does not read it)
虽然 FleschKincaid.java 源文件对编译器可用(假设使用 -m easytext.analysis,
easytext.cli进行编译,以弥补所缺少的 requires easytext.analysis),但
仍然会抛出一个错误。如果在分析模块的描述符中省略 exports 语句,也会产生类似的
错误。此时,可以看到在软件开发过程的每个步骤中明确依赖关系的主要优势。模块只
能使用它所需要的内容,编译器会强制执行此操作。在运行时,解析器使用相同的信
息,以确保在启动应用程序之前所有模块都已存在。在编译时不会出现对库的意外依
赖,只有在运行时才能发现这个库在类路径上不可用。
模块系统执行的另一个检查是循环依赖。在上一章已经讲过,在编译时,模块之间的可
读性关系必须是非循环的。而在模块中,仍然可以在类之间创建循环关系,过去一直
是这么做的。从软件工程的角度来看,是否真的需要这么做存在争议,但只要愿意,也
是可以的。但是,在模块级别将别无选择。模块之间的依赖关系必须形成非循环的有向
图。推而广之,不同模块中的类之间也不能存在循环依赖。如果引入了循环依赖关系,
编译器就不会接受。向分析模块添加 requires easytext.cli,引入一个循环,如
图 3-2 所示。
图 3-2:带有非法循环依赖关系的 EasyText模块
如果尝试编译该模块,会出现如下所示的错误:
src/easytext.analysis/module-info.java:3: error: cyclic dependence involving easytext.cli requires easytext.cli; ^
请注意,循环也可以是间接的,如图 3-3 所示。虽然在实践中以下情况不太常见,但被
视为与直接循环相同:它们导致 Java 模块系统发生错误。
46 | 第 3章
图 3-3:循环也可以是间接的
许多实际应用程序的组件之间存在循环依赖关系。在 5.5.2 节,将会讨论如何防止和打
破应用程序模块图中的循环。
3.3 使用平台模块
平台模块伴随着 Java 运行时,并提供了包括 XML 解析器、GUI 工具包在内的功能以及
期望在标准库中看到的其他功能。图 2-1 显示了平台模块的一个子集。从开发人员的角
度来看,它们的行为与应用程序模块相同。平台模块封装某些代码,可能导出包,并且
可以依赖其他(平台)模块。使用模块化 JDK 意味着需要了解应用程序模块中所使用的
平台模块。
在本节,将使用新的模块扩展 EasyText 应用程序。扩展后的应用程序使用平台模块,而
不是前面所创建的模块。从技术上讲,我们已经使用了一个平台模块:java.base模
块。然而,这只是一个隐式依赖关系,接下来所创建的新模块与其他平台模块之间具有
显式依赖关系。
3.3.1 找到正确的平台模块
如果需要了解所使用的平台模块,那么如何知道存在哪些平台模块呢?毕竟只有知道了
名称,才能依赖(平台)模块。当运行 java --list-modules时,运行时将输出所
有可用的平台模块:
$ java [email protected]@[email protected]@9jdk.management@9
上面简短的输出显示了几种类型的平台模块。以 java.为前缀的平台模式是 Java SE 规
范的一部分。它们通过 Java SE 的 JCP(Java Community Process)导出标准化的 API。JavaFX API 分布在共享 javafx.前缀的模块中。以 jdk.开头的模块包含了 JDK 特定
的代码,在不同的 JDK 实现中可能会有所不同。
使用模块 | 47
尽管 --list-modules功能是发现平台模块的良好起点,但远远不够。如果导入一个
不是由 java.base导出的包时,则需要知道哪个平台模块提供了这个包,此时必须使
用 requires子句将该模块添加到 module-info.java 中。因此,让我们返回到示例应用
程序,了解哪些模块与平台模块一起工作。
3.3.2 创建 GUI 模块
到目前为止,EasyText 使用了两个应用程序模块,命令行主应用程序已经与分析模块分
离开来。按照需求,希望在相同的分析逻辑之上支持多个前端。所以,接下来尝试创建
除命令行版本之外的 GUI 前端。显然,该前端应该重用已经存在的分析模块。
使用 JavaFX 为 EasyText 创建一个合适的 GUI。从 Java 8 起,JavaFX GUI 框架就已经
成为 Java 平台的一部分,旨在取代旧的 Swing 框架。此 GUI 如图 3-4 所示。
图 3-4:EasyText 简单的 GUI
当点击 Calculate 按钮时,分析逻辑在文本字段的文本上运行,并在 GUI 上显示结果值。
虽然在下拉列表中只能选择一种分析算法,但稍后随着需求的扩展,会添加更多算法。
目前暂时保持示例的简单性,假设 FleschKincaid 分析是唯一可用的算法。GUI Main类
的代码非常简单,如示例 3-4 所示。
示例 3-4:EasyText GUI 实现过程( chapter3/easytext-threemodules)package javamodularity.easytext.gui;
import java.util.ArrayList;import java.util.List;
import javafx.application.Application;import javafx.event.*;import javafx.geometry.*;import javafx.scene.*;import javafx.scene.control.*;
48 | 第 3章
import javafx.scene.layout.*;import javafx.scene.text.Text;import javafx.stage.Stage;
import javamodularity.easytext.analysis.FleschKincaid;
public class Main extends Application {
private static ComboBox<String> algorithm; private static TextArea input; private static Text output;
public static void main(String[] args) { Application.launch(args); }
@Override public void start(Stage primaryStage) { primaryStage.setTitle("EasyText"); Button btn = new Button(); btn.setText("Calculate"); btn.setOnAction(event -> output.setText(analyze(input.getText(), (String) algorithm.getValue())) );
VBox vbox = new VBox(); vbox.setPadding(new Insets(3)); vbox.setSpacing(3); Text title = new Text("Choose an algorithm:"); algorithm = new ComboBox<>(); algorithm.getItems().add("Flesch-Kincaid");
vbox.getChildren().add(title); vbox.getChildren().add(algorithm); vbox.getChildren().add(btn);
input = new TextArea(); output = new Text(); BorderPane pane = new BorderPane(); pane.setRight(vbox); pane.setCenter(input); pane.setBottom(output); primaryStage.setScene(new Scene(pane, 300, 250)); primaryStage.show(); }
private String analyze(String input, String algorithm) { List<List<String>> sentences = toSentences(input); return "Flesch-Kincaid: " + new FleschKincaid().analyze(sentences); }
// 为简洁起见,省略了 toSentences() 的实现过程}
在 Main类中导入了 8 个 JavaFX 包。如何知道 module-info.java 中需要哪些平台模块
使用模块 | 49
呢?一种方法是使用 JavaDoc 找出包位于哪个模块中。对于 Java 9 来说,JavaDoc 已经
进行了更新——包含了模块名称(类型是模块名称的一部分)。
另一种方法是使用 java --list-modules检查可用的 JavaFX 模块。在运行完该命
令后,可以看到名称中包含 javafx的 8 个模块:
[email protected]@[email protected]@[email protected]@[email protected]@9
因为模块名称与其所包含的包之间并不总是一一对应的,所以选择正确的模块有点像
根据上述列表所进行的一个猜测游戏。可以使用 --describe-module检查平台模
块的模块声明以验证猜测是否正确。例如,如果认为 javafx.controls可能包含
javafx.scene.control包,那么可以使用下面的代码加以验证:
$ java --describe-module javafx.controlsjavafx.controls@9exports javafx.scene.chartexports javafx.scene.control ❶exports javafx.scene.control.cellexports javafx.scene.control.skinrequires javafx.base transitiverequires javafx.graphics transitive...
❶ 模块 javafx.controls导出了 javafx.scene.control包。
事实上,所需要的包就包含在这个包中。以上述方法手动地找到正确平台模块的过程是
相当单调乏味的。预计在 Java 9 提供了相应的支持之后,IDE 将会帮助开发人员完成此
任务。对于 EasyText GUI 来说,只需要两个 JavaFX 平台模块:
module easytext.gui { requires javafx.graphics; requires javafx.controls; requires easytext.analysis;}
根据上面的模块描述符,GUI 模块顺利编译。但是当尝试运行时,会出现下面的奇怪
错误:
Exception in Application constructorException in thread "main" java.lang.reflect.InvocationTargetException ...Caused by: java.lang.RuntimeException: Unable to construct
50 | 第 3章
Application instance: class javamodularity.easytext.gui.Main at javafx.graphics/..LauncherImpl.launchApplication1(LauncherImpl.java:963) at javafx.graphics/..LauncherImpl.lambda$launchApplication$2(LauncherImpl.java) at java.base/java.lang.Thread.run(Thread.java:844)Caused by: java.lang.IllegalAccessException: class ..application.LauncherImpl (in module javafx.graphics) cannot access class javamodularity.easytext.gui.Main (in module easytext.gui) because module easytext.gui does not export javamodularity.easytext.gui to module javafx.graphics at java.base/..Reflection.newIllegalAccessException(Reflection.java:361) at java.base/..AccessibleObject.checkAccess(AccessibleObject.java:589)
Java 9 中另一个变化是,堆栈跟踪也会显示一个类来自哪个模块。斜杠(/)之
前的名称是包含斜杠之后指定类的模块。
到底发生了什么事情呢?根本原因是由于无法加载 Main类而产生了 IllegalAccess-
Exception。Main类扩展了 javafx.application.Application(它位于 javafx.
graphics模块中),并从 main 方法调用了 Application::launch。这是启动 JavaFX应用程序的一种典型方式,即将 UI 创建委托给 JavaFX 框架。然后 JavaFX 使用反射实
例化 Main,随后调用 start方法。这意味着 javafx.graphics模块必须能够访问
easytext.gui中的 Main类。正如 2.4 节中所讲到的,访问另一个模块中的类需要满
足两个条件:对目标模块的可读性以及目标模块必须导出给定的类。
在这种情况下,javafx.graphics必须具有与 easytext.gui的可读性关系。幸运
的是,模块系统非常智能,可以动态地建立与 GUI 模块的可读性关系(显然,只要使用
反射加载另一个模块中的类)。可问题是,包含 Main类的包并不是从 GUI 模块中公开
的。对于 javafx.graphics模块来说,Main是不可访问的,因为它没有被导出,而
这也正是前面的错误信息所告诉我们的内容。
一种解决方案是在模块描述符中为 javamodularity.easytext.gui包添加一个
exports子句。只有这样才能将 Main类暴露给任何需要 GUI 模块的模块。这真的是
我们想要的结果吗? Main类是否真的成为需要支持的公共 API 的一部分呢?答案是否
定的。需要访问该类的唯一原因是 JavaFX 需要实例化它。而这恰恰是使用限制导出的
时候:
使用模块 | 51
module easytext.gui {
exports javamodularity.easytext.gui to javafx.graphics;
requires javafx.graphics; requires javafx.controls; requires easytext.analysis;}
在编译期间,限制导出的目标模块必须在模块路径上或者同时编译。显然对平
台模块来说这不是问题,但是当对非平台模块进行限制导出时,这是一个需要
注意的问题。
通过限制导出,只有 javafx.graphics可以访问 Main类。现在运行应用程序,
JavaFX 能够实例化 Main类。在 6.1.2 节,将会学习另一种方法来处理在运行时对模块
内部的反射访问。
在运行时出现了一个有趣的情况。如上所述,javax.graphics模块在运行时动态地
建立了与 easytext.gui的可读性关系(如图 3-5 中粗箭头所示)。
图 3-5:运行时的可读性边
这意味着可读性图中存在一个循环!这怎么可能?循环通常被认为是不可能的。在
编译时 可能存在循环。在本示例中,使用与 javafx.graphics的依赖关系(也
因此产生可读性关系)编译 easytext.gui。在运行时,当它以反射方式实例化
Main时,javax.graphics自动建立与 easytext.gui的可读性关系。在运行
时,可读性关系可以是循环的。因为导出是受限的,所以只有 javafx.graphics
可以访问 Main类。与 easytext.gui建立可读性关系的任何其他模块将无法访问
javamodularity.easytext.gui包。
3.4 封装的限制
回顾一下本章前面所学的内容,主要学习了如何创建和运行模块,以及如何将它们与平
台模块结合使用。示例应用程序 EasyText 已从一个小型的整体应用程序发展成一个多模
块 Java 应用程序。同时,还实现了两个规定要求:在重复使用相同的分析模块前提下支
52 | 第 3章
持多个前端,以及创建针对命令行或 GUI 的模块的不同配置。
然而,看一下其他需求,会发现还有很多需要改进的地方。从目前情况来看,前端模块
都会从分析模块中实例化一个特定的实现类(FleschKincaid)来完成自己的工作。
虽然代码存在于单独的模块中,但此时却出现了紧耦合。如果想要使用不同的分析来扩
展应用程序,那么应该怎么办呢?是否应该对每个前端模块进行修改以了解新的实现类
呢?这听起来像是很差的封装。前端模块是否应该根据新引入的分析模块进行更新呢?
这听起来很明显是非模块化的,也违反了在不修改或重新编译现有模块的情况下添加新
的分析算法的要求。图 3-6 显示由两个前端和两个分析所带来的混乱(Coleman-Liau 是
另一种众所周知的复杂性算法)。
图 3-6:为了实例化导出的实现类,每个前端模块都需要依赖所有的分析模块
简而言之,有两个问题需要解决:
• 前端需要与具体分析实施类型和模块相分离。分析模块不应导出这些类型,以避免
出现紧耦合。
• 前端应该能够发现新模块中的新分析实现,而不需要更改任何代码。
一旦解决了这两个问题,则只需将新的分析模块添加到模块路径上从而引入新的分析算
法,而无须接触前端。
接口和实例化
在理想情况下,可以通过一个接口抽象出不同的分析。毕竟只是传递句子,并为每种算
法返回一个分数:
public interface Analyzer {
String getName();
double analyze(List<List<String>> text);
}
只要能找到一种算法的名称(为了显示的需要)并计算复杂度就可以了,这种抽象类型
恰恰是接口可以实现的。Analyzer接口比较稳定,并且可以在自己的模块中使用,比
使用模块 | 53
如 easytext.analysis.api。该接口是前端模块应该知道和关注的。分析实现模块
也需要这个 API 模块,并实现 Analyzer接口。到目前为止,一切都比较顺利。
然而,存在一个问题。即使前端模块仅关注如何通过 Analyzer接口调用 analyze方
法,但它们仍然需要一个具体实例来调用该方法:
Analyzer analyzer = ???
如何才能找到一个实现了 Analyzer接口却又不依赖特定实现类的实例呢?可以参考下
面的代码:
Analyzer analyzer = new FleschKincaid();
不幸的是,如果想要上面的代码正常工作,仍然需要公开 FleschKincaid类,这样一
来又回到了原点。此时需要一种方法来获取不参考具体实现类的实例。
与计算机科学中的所有问题一样,可以尝试通过添加一个新的间接层来解决这个问题。 在下一章中将会讨论这个问题的解决方案,其详细介绍了工厂模式及其如何启动服务。
Top Related