Java 入門：從 HelloWorld 到 Javadoc 文檔生成全流程

第一個 Java 程序

public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello World!");
    }
}

• 源文件名必須與 public class 同名（HelloWorld.java）
• main 方法固定簽名：public static void main(String[] args)
• Java 嚴格區分大小寫，關鍵字全小寫

三種註釋類型

Javadoc 標籤詳解

/**
 * 類說明
 * @author 作者名
 * @version 版本號
 * @see 參考鏈接
 */
public class Demo {
    /**
     * 方法說明
     * @param 參數名 參數說明
     * @return 返回值說明
     * @throws 異常類型 拋出條件
     * @deprecated 不推薦使用原因
     */
    public String method(String param) { ... }
}

生成 API 文檔

javadoc -d docs -author -version -encoding UTF-8 HelloWorld.java

• -author/-version 包含作者版本標籤
• 默認只提取 public/protected 成員，加 -private 包含私有成員
• 輸出目錄 docs/ 下打開 index.html 查看

完整示例

package gee;
/**
 * 網站：作者博客
 * 程序名：Javadoc 演示
 * @author Gee
 * @version 1.0
 */
public class JavaDocDemo {
    /** 簡單測試字段 */
    protected String name;
    /** 主方法，程序入口 */
    public static void main(String[] args) {
        System.out.println("Hello World!");
    }
}

1. 上一篇文章： Java 方法重載與變量作用域完整指南
2. 下一篇文章： Java 計算字符串像素寬高：Graphics2D 與 FontRenderContext 實戰

Java 相關知識

NetBeans 整合 JRuby 開發完整指南：從專案建立到測試部署

前言 JRuby 是 Ruby 語言在 JVM 上的完整實作

讓您的應用程式呼叫我的應用程式，第 1 部分 (下)

Apache Geronimo 通訊基礎 — 開發、部署和測

Java 自動生成頸椎矯正圖：文字繞排版與圖形旋轉實戰

久坐電腦前容易頸椎僵硬？網路上流傳的「頸椎矯正圖」利用文字螺

Java Web 應用整合 OpenID 身份驗證：依賴方 (RP) 實作完整指南

OpenID 核心概念速覽 OpenID 是去中心化身份驗證