# 此 API 文档的组织方式

此 API (应用程序编程接口) 文档包含对应于导航栏中的项目的页面, 如下所述。

- ## 程序包

  每个程序包都有一页，其中包含它的类和接口的列表及其概要。这些页可以包含六个类别：

  - 接口
  - 类
  - 枚举
  - 异常错误
  - 错误
  - 注释类型

- ## 类或接口

  每个类, 接口, 嵌套类和嵌套接口都有各自的页面。其中每个页面都由三部分 (类/接口说明, 概要表, 以及详细的成员说明) 组成:

  - 类继承图
  - 直接子类
  - 所有已知子接口
  - 所有已知实现类
  - 类或接口声明
  - 类或接口说明
  - 嵌套类概要
  - 字段概要
  - 属性概要
  - 构造器概要
  - 方法概要
  - 字段详细资料
  - 属性详细信息
  - 构造器详细资料
  - 方法详细资料

  每个概要条目都包含该项目的详细说明的第一句。概要条目按字母顺序排列, 而详细说明则按其在源代码中出现的顺序排列。这样保持了程序员所建立的逻辑分组。

- ## 注释类型

  每个注释类型都有各自的页面, 其中包含以下部分:

  - 注释类型声明
  - 注释类型说明
  - 必需元素概要
  - 可选元素概要
  - 元素详细资料

- ## 枚举

  每个枚举都有各自的页面, 其中包含以下部分:

  - 枚举声明
  - 枚举说明
  - 枚举常量概要
  - 枚举常量详细资料

- ## 树 (类分层结构)

  对于所有程序包，都有一个 类分层结构 页，以及每个程序包的分层结构。每个分层结构页都包含类的列表和接口的列表。从 `java.lang.Object` 开始，按继承结构对类进行排列。接口不从 `java.lang.Object` 继承。

  - 查看“概览”页面时, 单击 "树" 将显示所有程序包的分层结构。
  - 查看特定程序包、类或接口页时，单击“树”将仅显示该程序包的分层结构。

- ## 已过时的 API

  已过时的 API 页面列出了所有已过时的 API。一般由于进行了改进并且通常提供了替代的 API, 所以建议不要使用已过时的 API。在将来的实现过程中, 可能会删除已过时的 API。

- ## 索引

  索引 包含所有类、接口、构造器、方法和字段的按字母顺序排列的索引，以及所有程序包和所有类的列表。

- ## 所有类

  所有类链接显示所有类和接口 (除了非静态嵌套类型)。

- ## 序列化表格

  每个可序列化或可外部化的类都有其序列化字段和方法的说明。此信息对重新实现者有用, 而对使用 API 的开发者则没有什么用处。尽管导航栏中没有链接, 但您可以通过下列方式获取此信息: 转至任何序列化类, 然后单击类说明的 "另请参阅" 部分中的 "序列化表格"。

- ## 常量字段值

  常量字段值页面列出了静态最终字段及其值。

- ## 搜索

  可以使用部分或完整名称搜索模块、程序包、类型、字段、方法以及在 API 中定义的其他术语的定义。支持“驼峰大小写式”缩写：例如，"InpStr" 将查找 "InputStream" 和 "InputStreamReader"。

此帮助文件适用于由标准 doclet 生成的 API 文档。