本 API 文档的组织方式
-
概述
在 概述 页面是本 API 文档的首页,并提供所有包的列表以及每个包的摘要。此页面还可以包含对这组包的总体描述。
-
包
每个包都有一个页面,其中包含其类和接口的列表以及每个类的摘要。这些页面可能包含六个类别:
- 接口
- 类
- 枚举
- 异常
- 错误
- 注解类型
-
类或接口
每个类、接口、嵌套类和嵌套接口都有其单独的页面。这些页面中的每一个都包含三个部分:类/接口描述、摘要表和详细的成员描述。
- 类继承图
- 直接子类
- 所有已知子接口
- 所有已知实现类
- 类或接口声明
- 类或接口描述
- 嵌套类摘要
- 字段摘要
- 属性摘要
- 构造函数摘要
- 方法摘要
- 字段详情
- 属性详情
- 构造函数详情
- 方法详情
每个摘要条目包含该项目详细描述中的第一句话。摘要条目按字母顺序排列,而详细描述则按其在源代码中出现的顺序排列。这保留了程序员建立的逻辑分组。
-
注解类型
每个注解类型都有其自己的单独页面,其中包含以下部分:
- 注解类型声明
- 注解类型描述
- 必需元素摘要
- 可选元素摘要
- 元素详情
-
枚举
每个枚举都有其自己的单独页面,其中包含以下部分:
- 枚举声明
- 枚举描述
- 枚举常量摘要
- 枚举常量详情
-
树状图 (类层次结构)
所有包都有一个 类层次结构 页面,每个包也都有一个层次结构。每个层次结构页面都包含一个类列表和一个接口列表。类按继承结构组织,以 `java.lang.Object` 开头。接口不继承自 `java.lang.Object`。
- 查看“概述”页面时,单击“树状图”将显示所有包的层次结构。
- 查看特定包、类或接口页面时,单击“树状图”将仅显示该包的层次结构。
-
已弃用的 API
在 已弃用的 API 页面列出了所有已弃用的 API。通常由于改进,不建议使用已弃用的 API,并且通常会提供替换 API。已弃用的 API 可能会在将来的实现中删除。
-
索引
在 索引 中包含所有类、接口、构造函数、方法和字段的字母顺序索引,以及所有包和所有类的列表。
-
所有类
所有类 链接显示所有类和接口,但不包括非静态嵌套类型。
-
序列化表单
每个可序列化或可外部化的类都对其序列化字段和方法进行了描述。此信息对重新实现者而非使用 API 的开发人员感兴趣。虽然导航栏中没有链接,但您可以通过转到任何序列化的类并在类描述的“另请参见”部分中单击“序列化表单”来获取此信息。
-
常量字段值
在 常量字段值 页面列出了静态 final 字段及其值。
-
搜索
您可以使用部分或全部名称搜索 API 中定义的模块、包、类型、字段、方法和其他术语的定义。“驼峰式”缩写受支持:例如,“InpStr”将找到“InputStream”和“InputStreamReader”。
此帮助文件适用于由标准 doclet 生成的 API 文档。