Java 26 API 文档怎样按模块查找类

在 Java 26 API 文档中按模块查找类，可以从 Overview 的模块列表进入目标模块，查看 Packages 中的包，再从包页面的类型列表打开类或接口。不知道模块时，先按完整类型名搜索，打开类型后核对所属模块和包；不要仅凭一个简单类名判断它属于哪个模块。

官方地址：https://docs.oracle.com/en/java/javase/26/docs/api/

我查 API 时会先记下“版本、模块、包、类型”这四项。它比只收藏一个类名更有用，尤其是在模块名和包名相同、或者搜索结果混入其他 JDK 版本的时候。下面用我会采用的查找方式，带读者完成一次小练习，不需要安装数据库或启动服务。

先固定文档版本，再选择模块

先确认页面写着 Version 26 API Specification，并观察地址中的 /javase/26/。Overview 把 API 按模块列出，也提供 Java SE 和 JDK 等分类。以 java 开头的模块属于 Java SE API 范围；以 jdk 开头的模块对应 JDK 专用 API，不能因此假定它们在所有 Java SE 实现里都存在。

我的习惯是：知道模块就从模块表直接进入，不知道就先搜索完整类型名，再回到所属模块确认范围。这能少走一些“猜包名前缀就是模块名”的弯路。普通集合相关类型可从 java.base 开始，JDBC 相关接口可从 java.sql 开始。

查 java.base 时，应到标题为 Module java.base 的模块页，而不是某个名字包含 base 的类。模块页可用于理解公开包的范围，类的具体方法仍要继续到类型页面读取。

从模块的包列表找到完整类型名

在 java.base 模块页的 Packages 区域找到 java.util，打开包摘要，再定位 Map。Map 是接口，不能因为日常口语把它称作“类”，就在列表中只盯着 Classes 分类。类似地，String 位于 java.lang 包。

模块入口：https://docs.oracle.com/en/java/javase/26/docs/api/java.base/module-summary.html

我不会把地址栏目录层次直接当成 Java 源码的 import 写法。URL 中模块名是一段文档路径；导入时写的是包限定类型名，例如 java.util.Map。文档导航用于找定义，导入语句用于源码名字解析，两者用途不同。

用类页面反查模块，避免同名误认

接着查 java.sql.Connection。它属于 java.sql 模块，包也恰好叫 java.sql。这个巧合容易让人以为模块与包总是一一对应，但同一个模块还导出 javax.sql 包，DataSource 就在该包中。

JDBC 模块入口：https://docs.oracle.com/en/java/javase/26/docs/api/java.sql/module-summary.html

在模块页区分 Exports 与 Indirect Exports：本练习只从自身导出的 java.sql 和 javax.sql 进入，不把间接呈现的其他模块包归到它自己名下。在 Connection 类型页确认标题是 Interface Connection，然后检查所查方法的签名、参数、返回值和异常说明。

对我来说，搜索框更适合快速定位，模块页更适合确认归属。若 Search 结果出现多个相同简单名字，优先对照包限定名。找不到第三方框架类型时，应到该库对应版本的 API 文档，不能因为它运行在 Java 上就认为 Oracle 平台文档必然收录。

把查到的模块用于最小项目练习

作为扩展练习，可以建立一个具名模块，声明对 java.sql 的依赖。下面两个片段分别保存为 module-info.java 和 demo/ApiLookup.java，放在同一个模块源码根目录下，交给已经配置好的模块化项目编译。它只引用接口类型，不连接数据库：

// module-info.java：requires 后写模块名，而不是接口的完整类名。
module docs.lookup {
    requires java.sql;
}

package demo;

import java.sql.Connection;
import java.util.Map;

public class ApiLookup {
    public static void main(String[] args) {
        // import 使用完整类型名；这里只引用类型，不创建数据库连接。
        Class connectionType = Connection.class;
        Map labels = Map.of("package", connectionType.getPackageName());
        System.out.println(connectionType.getModule().getName());
        System.out.println(labels.get("package"));
    }
}

根据本练习的类型归属，两个输出预期都是 java.sql；第一项来自模块，第二项来自包。示例未在本机执行，输出含义用来帮助读者区分两个概念。java.base 在通常的具名模块声明中有隐式依赖，不需要为 Map 再显式添加 requires java.base。

这个练习适合正在阅读平台 API 或接触 module-info.java 的读者。已有 classpath 项目不必为了查文档立即改成模块化项目；先掌握类型归属，再按项目结构决定依赖配置。若临时创建练习工程，结束后删除自己新建的练习源码和构建目录即可，不需要操作生产环境。

文档写着 Java 26，方法就一定在旧 JDK 可用吗？不能这样推断。需看方法自己的 Since 标记，并切换到项目目标 JDK 的文档确认。

包名能直接用在 requires 后面吗？requires 指向模块；import 指向类型或包内成员，查到包后仍应确认所属模块。

找到类却编译失败怎么办？再看本地 JDK、目标版本、模块依赖和库版本是否匹配；API 文档存在只说明对应版本有该定义。

类型页示例：https://docs.oracle.com/en/java/javase/26/docs/api/java.sql/java/sql/Connection.html。