JDK API 文檔使用全指南：結構解析、查找技巧與類接口使用語法

JDK 文檔概覽

JDK API 文檔（Javadoc 生成的 HTML）是 Java 開發必備參考。官網下載：https://www.oracle.com/java/technologies/javase-downloads.html（需登錄）或使用 IDE 內置（IntelliJ: Ctrl+Q, Eclipse: F2）。

版本必須與項目 JDK 一致。中文版（舊）https://gceclub.sun.com.cn/chinese_java_docs.html，建議閱讀英文原版。

文檔頁面結構

• 左上：包列表（java.lang, java.util...）
• 左下：類/介面/異常/錯誤列表（按包篩選）
• 右側：詳細說明（選中類後顯示）

類詳細頁包含區塊

1. 繼承體系：java.lang.Object → ... → CurrentClass，直接已知子類
2. 實現介面：Serializable, Cloneable, Comparable...
3. 類聲明：public final class String implements ...
4. 類描述：功能、線程安全性、使用示例、參考鏈接
5. 字段摘要/詳情：常量（MAX_VALUE）、靜態字段
6. 構造方法摘要/詳情：參數、異常、說明
7. 方法摘要/詳情：修飾符、返回值、參數、拋出異常、詳細語義、代碼片段、版本標註

每項有錨點鏈接，可直接分享定位。

類與介面使用語法速查

1. 引入

import package.ClassName;      // 單類
import package.*;               // 整包（編譯期展開，不影響運行性能）
// java.lang.* 自動引入

2. 類三種使用方式

繼承細則

• 構造方法不繼承。子類構造首行隱式/顯式調用 super(...)。
• 父類無無參構造 → 子類必須顯式 super(args)。
• 父類構造非 public/protected → 不可繼承。
• 繼承抽象類 → 必須覆寫所有抽象方法，或繼續聲明 abstract。

3. 介面兩種使用方式

高效查找技巧

1. IDE 內置：懸停/快捷鍵直達源碼+文檔，無需離線包。
2. 瀏覽器搜索：site:docs.oracle.com/javase/8/docs/api/ "StringBuilder"
3. 離線工具：Zeal, Dash, Velocity (跨平台文檔瀏覽器)
4. 源碼閱讀：JDK 安裝目錄 src.zip 或 IDE Ctrl+Click 進入實現，理解邊界行為。
5. 版本對比：文檔頂部版本下拉框，查看新增/棄用/移除 API。

實戰：從文檔到代碼的標準流程

// 1. 確定需求：需要線程安全的鍵值存儲
// 2. 查包：java.util.concurrent → ConcurrentHashMap
// 3. 看類描述：確認特性（分段鎖、CAS、弱一致性迭代器）
// 4. 看構造方法：選擇初始容量、負載因子、併發級別
// 5. 看核心方法：putIfAbsent, computeIfAbsent, merge, forEach
// 6. 看異常聲明：NullPointerException 等
// 7. 編寫代碼
ConcurrentMap map = new ConcurrentHashMap<>(16, 0.75f, 4);
map.computeIfAbsent("key", k -> expensiveCalculation());

文檔閱讀紅綠燈