一 编译器选项

随着模块系统产生了一系列新的命令行选项，本书将对它们进行介绍。

为了帮你轻松地找到它们，表4-1列出了与编译器相关的所有选项。

表4-1 按字母顺序排列的所有与模块相关的编译器（javac命令）选项。

表4-1

新的选项：--release

你是否曾使用-source和-target选项编译代码，方便它在较旧版本的Java上运行，结果它却由于某个方法调用失败而在运行时崩溃？这着实令人费解，但是原因或许是你忘了指定-bootclasspath选项。

如果没有指定该选项，那么编译器会创建指定版本JVM可以理解的字节码（这里还是正确的），但它会链接到当前版本的核心库API（错误从这里开始），导致对旧版JDK中不存在的类型或方法进行调用，从而产生运行时错误。

从Java 9开始，编译器使用--release选项来防止常见的操作错误，该选项会将上述3个选项设置为正确的值。

二 打包模块化JAR

在将想法实现为可运行代码的过程中，编码和编译后的下一步是将类文件打包成模块。正如前两篇所解释的那样，这应该产生一个模块化JAR——它就像一个普通JAR，但包含模块描述符文件module-info.class。

因此，你希望由值得信赖的jar工具来负责打包工作。以下是非常简单的创建模块化JAR（本例中为monitor.observer）的命令。

除了新的命令行别名，上述命令的调用方式和Java 9之前版本完全一致。一个有趣的隐含细节是，因为monitor.observer/target/classes包含模块描述符module-info.class，所以生成的monitor.observer.jar成了一个模块化JAR。

虽然jar工具的工作方式与之前类似，但依然有一些与模块相关的细节和补充值得关注，比如定义模块入口点。

注意 JAR并非交付Java字节码的唯一格式。JEE还可以使用WAR和EAR格式文件。但是在其标准支持模块之前，人们还无法创建模块化WAR或模块化EAR。

1 快速回顾jar工具

为了帮助理解，先来快速了解一下jar是如何打包归档的。正如前文所指出的，如果文件列表中包含模块描述符module-info.class，那么打包的结果是模块化JAR。

以打包monitor.observer的命令为例，打包的结果是mods目录中的module.observer.jar，其中包含了monitor.observer/target/classes及其子目录中的所有类文件。因为classes中包含模块描述符，所以JAR也将包含它。因此，无须任何额外工作即可生成模块化JAR。

在打包时，应该考虑使用--module-version记录模块的版本。后文会解释如何做到这一点。

2 分析JAR

在使用JAR时，掌握对所创建的包进行分析的方法十分有意义，尤其要知道JAR中包含的文件及其模块描述符中的内容。幸运的是，这两点jar工具都能做到。

01. 列出JAR中的内容

查看JAR中的内容是最显而易见的需求，这可以通过--list选项实现。以下代码段可以展示前文创建的monitor.observer.jar中的内容。

它包含一个META-INF目录，但这里不做过多介绍，因为这个目录已经存在多年并且与模块系统无关。它还包含一个模块描述符，以及monitor.observer包中的DiagnosticDataPoint和ServiceObserver类。可以说，没什么引人注目或令人意外的。

这并不是一条新命令。它之所以看起来不同，只是因为拥有新的别名：--list的简写是-t，--file的简写是-f。在Java 9之前版本中，jar -t -f some.jar的作用与此相同。

02. 检查模块描述符

模块描述符是一个类文件，它由字节码组成。因此有必要通过工具来查看它的内容。幸好，jar可以使用--describe-module（或者-d）来实现。

检查monitor.observer.jar，你会发现它是一个名为monitor.observer的模块。该模块会导出一个同名的包，同时会依赖base模块。

（如果想知道mandated的含义，请回顾前两篇。该篇提到，每个模块都隐性地依赖于基础模块，这意味着java.base的存在是强制性的。）

3 定义模块入口点

要启动Java应用程序，就要知道程序入口点，即把包含public staticvoid main(String[])方法的所有类中的一个类作为主类。

你可以在应用程序启动时通过命令行来指定入口点，也可以在JAR附带的manifest文件中将其写明。如果你不知道这两个选项的确切工作原理，请不要担心，因为Java 9增加了第三个选项，即一种配合模块系统使用的新方式。

在使用jar打包类文件时，可以使用--main-class ${class}来定义主类，其中${class}是带有main函数的类的完全限定名称（包名后面附加一个点和类名）。

被指定的主类将被记录在模块描述符中，并且当此模块成为启动应用程序的初始模块时，将默认使用它作为主类（详细信息参见后文）。

注意 如果你习惯通过设置manifest中的Main-Class条目来创建可执行的JAR，那么你会很高兴地了解到jar --main-class也起着同样的作用。

ServiceMonitor应用程序在monitor.Main中有一个入口点，在打包时可以使用--main-class monitor.Main来指明它。

借助--describe-module选项，可以看到该主类已经被记录在模块描述符中。

有趣的是，jar工具既没有能力也没有责任来验证你所指定的类是否存在。它既不检查类是否存在，也不检查类中是否包含main函数。如果存在问题，尽管现阶段不会发生错误，但是模块启动会失败。

4 归档选项

本文目前只探讨了jar所提供的一些最重要的选项，其他一些不同上下文中的有趣选项将在后续的相关章节中得到阐述。为了帮助你轻松地找到它们，表4-2列出了jar工具与模块系统相关的所有选项。

表4-2 按字母顺序排列的所有与模块相关的归档（jar命令）选项。

表4-2

三 小结

1）确保选择的目录结构能满足项目的需求。如果有疑问，请毫不犹豫地使用构建系统的默认结构。

2）编译所有模块源代码的javac命令（包括声明）与Java 9之前版本的命令基本相同，只是它使用模块路径而不是类路径。

3）模块源路径（--module-source-path）将告知编译器项目的结构。这使得编译器操作从处理类型提升至处理模块，这让你能够使用简单的选项（--module或-m）来编译指定模块及其所有依赖，而不是仅仅列出源文件。

4）模块化JAR只是具有模块描述符module-info.class的普通JAR。jar工具可以像处理其他类文件一样处理模块描述符，因此要将它完全打包到JAR中，不需要添加新的选项。

5）作为一个可选项，jar允许人们指定模块的入口点（使用--mainclass），入口点指的是具有main函数的类。这样的方式使模块启动更加简单。