Java 方法定義全解析：語法結構、參數傳遞與實戰範例

深入理解 Java 方法的定義與使用

方法是 Java 程式碼復用的基本單元，掌握方法的定義語法、參數機制與返回值處理是編寫高質量代碼的基石。本文將從語法結構、修飾符、參數傳遞、重載等核心概念展開詳細講解。

一、方法的完整語法結構

一個標準的 Java 方法聲明包含以下六個部分：

<修飾符> <返回類型> <方法名>(<參數列表>) <方法體>

1.1 修飾符

• 訪問控制：public（公開）、protected（受保護）、private（私有）、默認（包可見）
• 非訪問修飾符：static（靜態）、final（不可重寫）、abstract（抽象）、synchronized（同步）、native（本地）

1.2 返回類型

• 基本類型：int、double、boolean 等
• 引用類型：String、List<T>、自定義類等
• void：表示無返回值

1.3 方法名與參數列表

• 方法名遵循駝峰命名法（如 calculateTotalPrice）
• 參數列表：零個或多個 類型 參數名，以逗號分隔
• 方法簽名 = 方法名 + 參數列表（不包含返回類型）

1.4 方法體

包含具體業務邏輯的代碼塊，若有返回類型必須以 return 值 結束。

二、實戰代碼範例

2.1 基礎方法定義

/**
 * 計算年齡
 * @param birthYear 出生年份
 * @return 當前年齡
 */
public static int calculateAge(int birthYear) {
    int currentYear = Year.now().getValue();
    return currentYear - birthYear;
}

2.2 多參數方法

/**
 * 計算複利
 * @param principal 本金
 * @param rate 年利率（如 0.05 表示 5%）
 * @param years 年數
 * @return 本利和
 */
public static double compoundInterest(double principal, double rate, int years) {
    return principal * Math.pow(1 + rate, years);
}

2.3 方法重載

public class MathUtils {
    // 兩整數求最大值
    public static int max(int a, int b) {
        return a > b ? a : b;
    }
    
    // 三整數求最大值
    public static int max(int a, int b, int c) {
        return max(max(a, b), c);
    }
    
    // 兩浮點數求最大值
    public static double max(double a, double b) {
        return a > b ? a : b;
    }
}

三、參數傳遞機制深度解析

Java 採用值傳遞機制，這點至關重要：

3.1 基本類型傳遞

public void modifyPrimitive(int value) {
    value = 20; // 只修改副本
}

public static void main(String[] args) {
    int num = 10;
    modifyPrimitive(num);
    System.out.println(num); // 輸出 10，原值未變
}

3.2 引用類型傳遞

public void modifyObject(StringBuilder sb) {
    sb.append(" World"); // 修改對象內部狀態
    sb = new StringBuilder("New"); // 修改引用指向，不影響外部
}

public static void main(String[] args) {
    StringBuilder sb = new StringBuilder("Hello");
    modifyObject(sb);
    System.out.println(sb); // 輸出 "Hello World"
}

核心結論：方法接收的是引用的副本，可以修改對象內部狀態，但無法改變外部引用指向的對象。

四、變長參數與泛型方法

4.1 可變參數

public static double average(double... numbers) {
    if (numbers.length == 0) return 0;
    double sum = 0;
    for (double n : numbers) sum += n;
    return sum / numbers.length;
}

// 調用方式
average(1, 2, 3);        // 2.0
average(new double[]{1,2,3}); // 2.0

4.2 泛型方法

public static  void swap(T[] array, int i, int j) {
    T temp = array[i];
    array[i] = array[j];
    array[j] = temp;
}

五、最佳實踐指南

1. 單一職責：每個方法只做一件事，建議控制在 20 行以內
2. 命名規範：動詞開頭，清晰表達意圖（get/set/is/calculate/process）
3. 參數驗證：公共方法開頭檢查非空、範圍等前置條件
4. 異常處理：拋出具體異常而非通用 Exception，文檔說明拋出條件
5. 避免過長參數列表：超過 4 個參數考慮封裝為參數對象或使用建造者模式
6. 靜態方法優先：不依賴實例狀態的工具方法聲明為 static

六、常見錯誤與避坑

掌握方法定義的精髓，能讓你的代碼更加模組化、可測試、易維護。建議在實際項目中多練習重構大方法為小方法，體會「高內聚、低耦合」的設計哲學。