0Pricing
Java Academy · 课时

requires 与 exports

控制依赖关系与可见性

requires 与 exports 是 CoddyKit 上的免费 Java Academy 课时。 这是第 2 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Java Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Java Academy 课程共包含 4 节课。

控制模块图

两个指令会影响模块图:requires 声明您依赖的内容,exports 声明您公开的内容。

本课将探讨它们的变体,以及它们创建的可读性和可访问性规则。

普通依赖声明

简单的 requires X; 表示“此模块读取模块 X”。您的代码可以使用 X 导出的公共类型,但使用您的模块的模块不会因此了解到 X。

module com.example.app {
    requires java.sql;
}

传递性依赖声明

requires transitive Y; 表示任何读取您模块的模块也会读取 Y。这称为隐式可读性,当您的应用程序接口公开 Y 的类型时非常有用。

module com.example.api {
    requires transitive java.sql;
}

何时使用传递性依赖

当您导出的应用程序接口中的方法返回或接受另一个模块中的类型时,请使用 transitive。否则,调用方必须额外声明自己的 requires,才能为返回类型写出名称。

这样可以避免使用方声明重复的依赖关系。

静态依赖声明

requires static Z; 声明一个仅在编译时需要的依赖关系。编译时需要该模块,但运行时可以没有它,因此非常适合注解处理器或可选集成。

module com.example.app {
    requires static com.example.annotations;
}

普通导出

exports pkg; 会使 pkg 中的公共类型可被所有依赖您模块的模块读取。

module com.example.lib {
    exports com.example.lib.api;
}

限定导出

限定导出只会将一个包公开给指定名称的模块,写法是 exports pkg to modA, modB;。这适用于大型系统中的友元模块。

module com.example.core {
    exports com.example.core.internal to com.example.web, com.example.batch;
}

用于反射的开放声明

exports 授予对公共成员的编译时和运行时访问权限。深层反射(访问私有字段)则需要使用 opens pkg;,Jackson 或 Hibernate 等框架会用到它。

module com.example.model {
    exports com.example.model;
    opens com.example.model.entities to com.fasterxml.jackson.databind;
}

开放模块

如果整个模块都需要反射访问(旧版框架中很常见),请将其声明为 open。这样每个包都会对反射开放,不过普通的 exports 仍会控制编译时访问权限。

open module com.example.beans {
    requires java.logging;
}

可读性与可访问性

要使用另一个模块中的类型,以下两个条件必须同时满足:

  • 可读性:您的模块声明了对该模块的 requires
  • 可访问性:该模块导出相应的包,并且该类型是公共的

只要缺少其中一个条件,编译器就会拒绝您的代码。

组合起来

下面是一个结构正确的模块,它重新公开 Java 数据库连接类型,并为 JSON 库开放实体类:

module com.example.service {
    requires transitive java.sql;
    requires static com.example.annotations;

    exports com.example.service.api;
    exports com.example.service.spi to com.example.plugins;
    opens com.example.service.dto to com.fasterxml.jackson.databind;
}

快速检查

请选择用于重新公开应用程序接口类型的指令。

回顾

您已经学习了依赖关系和可见性指令:

  • requires、requires transitive、requires static
  • exports 和限定的 exports ... to
  • 用于反射的 opens 和 open module
  • 使用某个类型同时需要可读性和可访问性

下一步:通过服务以及 provides 和 uses 实现解耦。

常见问题解答

「requires 与 exports」课时是免费的吗?

是的 — 「requires 与 exports」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Java Academy 课程的其余内容,请升级到 CoddyKit PRO。 Java Academy 课程共包含 4 节课。

「requires 与 exports」这节课中我会学到什么?

控制依赖关系与可见性 你通过在浏览器中直接运行的动手代码来练习 Java Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Java Academy 需要有经验吗?

无需任何先前经验。CoddyKit 上的 Java Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 2 节课,共 4 节。

「requires 与 exports」课时需要多长时间?

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。

我能在这节 Java Academy 课中编写并运行代码吗?

能。每节 Java Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. module-info.java
  2. requires 与 exports
  3. 使用 provides/uses 提供服务
  4. 迁移到模块
← 返回 Java Academy