Java ???? ?? ??? ???? ???? ??

Java ?? ?????? ?? ??? ???? ???? ?? ?? ??? ?????. ?? ?? ??? ??? ???? ?? ???? ?????, ???? ??? ?? ??? ?? ??? ????, ?? ?? ?? ?? ? ???? ??? ???.

1. ?? ??

??? ?? ??? ???? ??? ??, ?? ??, ???? ?? ?? ???? ? ??? ? ????. Java?? ? ? ??(//), ?? ? ??(/ ... /), ?? ??(/* ... /)? ? ?? ??? ??? ????.

? ? ??? ? ? ??? ???? ?? ?? ???? ?? ??? ?? ??? ? ? ??? ? ????. ?:

int age = 18; // 年齡

?? ? ??? ?? ? ??? ???? ?? ??? ???? ?? ??? ?? ??? ? ? ??? ? ????. ?:

/*
 * 這段代碼用來(lái)計(jì)算兩個(gè)數(shù)的和
 */
int sum = a + b;

?? ??? ???, ??? ? ??? ??? ???? ? ???? API ??? ??? ?? ??? ? ????. ?:

/**
 * 這個(gè)類表示一個(gè)學(xué)生的信息
 */
public class Student {
    /**
     * 學(xué)生的姓名
     */
    private String name;
    
    /**
     * 學(xué)生的年齡
     */
    private int age;
    
    /**
     * 構(gòu)造方法
     * @param name 學(xué)生的姓名
     * @param age 學(xué)生的年齡
     */
    public Student(String name, int age) {
        this.name = name;
        this.age = age;
    }
    
    /**
     * 獲取學(xué)生的姓名
     * @return 學(xué)生的姓名
     */
    public String getName() {
        return name;
    }
    
    /**
     * 設(shè)置學(xué)生的年齡
     * @param age 學(xué)生的年齡
     */
    public void setAge(int age) {
        this.age = age;
    }
}

2. ?? ?? ?? ??

?? ?? ??? ?? ??, ?? ??, ?? ??? ?? ?? ?? ???? ???? ???? ???? ? ??? ? ? ????. ????? ???? ?? ?? ???? Checkstyle, PMD, FindBugs ?? ????.

??? ??? ???? ??? ?? ?? ??? ???? ???? ??? ?? ??? ??? ? ????. ?? ?? Checkstyle? ?? ??? ?? ??? ??? ? ?? PMD? ??? ???? ??? ??? ? ??? FindBugs? ??? ???? ??? ??? ? ????.

3. ?? ??? ???? API ?? ??

API ?? ??? ?? ??? ??? ?????. Java? ?? ???? ?? ??? ???? HTML ???? API ??? ??? ? ?? javadoc ??? ?????.

?? ??? ???? API ??? ??? ? ????.

javadoc -d doc -encoding UTF-8 -charset UTF-8 -sourcepath src -subpackages com.example

? ? -d? ??? ?? ????? ????, -encoding ? -charset? ??? ??? ????, -sourcepath? ?? ?? ??? ???? -subpackages? ??? ???? ?? ???.

4. ?? ?? ? ?? ?? ??

?? ???? ?? ??? ?? ??? ??? ??? ?? ??? ???? ? ?? ?????. ?? ??? ?? ?? ??? ???? ???? ?? ???? ?????.

????? ?? ????, ?? ??, ?? ?? ?? ???? ?? ?? ??? ??? ? ????. ??? ?? ??? ?? ??? ??? ??? ??? ? ????.

?:

/**
 * 這個(gè)類提供了一個(gè)計(jì)算兩個(gè)數(shù)的和的方法
 *
 * 使用示例：
 * int sum = Calculator.add(2, 3);
 * System.out.println("2 + 3 = " + sum);
 */
public class Calculator {
    /**
     * 計(jì)算兩個(gè)數(shù)的和
     * @param a 第一個(gè)數(shù)
     * @param b 第二個(gè)數(shù)
     * @return 兩個(gè)數(shù)的和
     */
    public static int add(int a, int b) {
        return a + b;
    }
}

?????, ?? ?? ?? ? ?? ??? Java ???? ?? ?????. ??, ?? ?? ??, API ?? ?? ??, ?? ?? ? ?? ?? ??? ?? ??? ???? ?? ???? ???? ???? ??? ?? ??? ?? ??? ??? ? ????. ?? ?? ?? ?? ? ??? ??? ???.

? ??? Java ???? ?? ??? ???? ?? ???? ??? ?? ?????. ??? ??? PHP ??? ????? ?? ?? ??? ?????!