[Java入門筆記] Java語言基礎（一）：註釋、標識符與關鍵字

註釋

什麼是註釋？

註釋是咱們在編寫代碼時某段代碼、某個方法、某個類的說明文字，方便你們對於代碼的閱讀。被註釋的內容不會被編譯、執行。

Java的註釋分爲三種類型：單行註釋、多行註釋、文檔註釋。

單行註釋和多行註釋

單行註釋在程序中註釋一行文字或代碼，Java中，使用「//」進行單行註釋。多行註釋能夠一次性將多行代碼註釋，Java中使用「/*」表示多行註釋開頭，「*/」表示多行註釋結尾

例：

public class CommentTest{
    public static void main(String[] args){
        //這是單行註釋
        /*
        多行註釋第一行
        第二行
        */
        //System.out.println("被註釋的代碼不會編譯和運行");
        System.out.println("未被註釋的代碼");
    }
}

Eclipse註釋快捷鍵：Ctrl+/ 單行註釋和取消註釋；Ctrl+Shift+/ 添加/* */註釋 ；Ctrl+Shift+\ 消除/* */註釋

文檔註釋

使用文檔註釋添加的註釋能夠經過文檔生成工具javadoc生成API文檔，javadoc工具只處理文檔源文中的以public和protected修飾的類、接口、方法、Field、構造器和內部類前面的註釋。

文檔註釋以「/**」開頭，以「*/」結尾。中間的部分是文檔註釋，會被生成到API文檔中。

例：

/**
 * 這是一個文檔註釋的測試類
 * @author ping
 *
 */
public class Test {
    
    /** 這是一個Filed */
    public int i;

    /**
     * 這是程序的main方法
     * @param args
     */
    public static void main(String[] args) {
        
    }
}

關於生成JavaAPI文檔，能夠參考如下兩篇文章：

用javadoc命令生成api幫助文檔

eclipse怎樣生成javadoc

標識符和關鍵字

分隔符

Java裏的分隔符包括分號（;）、花括號（{}）、方括號（[]）、圓括號（()）、空格、圓點（.），全部的符號都爲英文符號，這一點在編寫代碼的時候要尤其注意。

分號：，Java中，換行不能表明語句結束，只有分號表明一個語句的結束，所以一行中理論上是能夠寫多個語句，但不推薦這麼寫，會影響代碼的可讀性，使代碼看起來雜亂。

花括號：一對花括號表明一個語句塊，須要成對出現。

方括號：用作數組，定義數組和訪問數組元素時使用，也須要成對使用。

圓括號：定義方法時用來包含形參，調用方法和構造方法，須要有圓括號。

空格：用來分割一個語句的多個部分。

圓點：用做使用對象和類的成員使用。

標識符

標識符是用來爲程序中的類、方法、變量命名的符號。Java標識符具備如下特色：

• 區分大小寫。
• 必須以字符、下劃線、美圓符號開頭，後面能夠跟字符、下劃線、美圓符號和數字四種元素。字符不侷限於英文字符，能夠是漢字等各國家的文字。
• 不能包含除下劃線其餘的特殊符號以及空格等。
• 不能是Java中的關鍵字。

public class Test{  //Test是一個標識符
    public static void main(String[] args){  //main args也是一個標識符
　　　　int a = 1;
　　　　int A = 1;  //a和A是兩個不一樣的標識符
　　　　int $i = 2; //標識符正確
　　　　int 123 = 123;  //標識符錯誤
　　　　int i123 = 123;  //標識符正確
　　　　int i_1 = 1; //正確
　　　　int i.1 = 1;  //錯誤
　　　　int class = 2;  //class是關鍵字，錯誤
　　}
}    

 

關鍵字

Java中總共包含48個關鍵字和兩個保留字（goto/const）。

 

詳細介紹能夠參考下面這篇文章：

Java關鍵字及其做用