Java 封裝藝術：包機制與 Javadoc 文檔生成全攻略

什麼是包？

Java 中的包本質上是文件系統的目錄結構，用於邏輯上組織管理類與介面。透過 import 關鍵字可引入特定包中的公共類，例如 import java.util.*; 會導入 java.util 下所有公共類別。

核心標準包速覽

自定義包的創建與使用

四步驟建立包

1. 定義 public 類
2. 源文件首行聲明 package 包名;（如 package com.chen.test;）
3. 編譯時指定輸出目錄：javac -d C:\ B.java，自動生成目錄結構 C:\com\chen\test\B.class
4. 將包根目錄（如 C:\）加入環境變數 CLASSPATH

調用範例

// A.java
import com.chen.test.*;

public class A {
    public static void main(String[] args) {
        B test = new B();
        test.add(6, 8); // 輸出 14
    }
}

編譯 javac A.java 即可運行。注意：A.java 與 B.java 不可置於同一目錄，否則會因包結構衝突報錯。

Javadoc：從註釋到專業 API 文檔

核心標籤

• @author：作者資訊，可多行
• @version：版本號
• @param / @return：方法參數與返回值說明
• @see：關聯鏈接（類、方法、欄位）
• {@link}：行內超鏈接，如 {@link java.util.Map Map}

生成文檔命令

javadoc -private -d doc -author -version JavaDocTest.java

將在 doc 目錄下生成完整的 HTML 格式 API 文檔，支援跨類導航、繼承樹視圖、索引搜尋等專業功能。

工程價值：規範使用 Javadoc 不僅能自動生成標準化文檔，更能強制開發者保持註釋與代碼同步，大幅降低維護成本，是專案團隊協作的基礎設施。