# 基礎語言要素 ## 注釋 代碼注釋是編程中非常重要的環節，往往優秀的程序員，注釋寫的比代碼都多。 注釋是編程中非常重要的環節，往往優秀的程序員，注釋寫的比代碼都多。 > 注釋是不會被程序執行的 注釋可能出現的位置： * 類、方法、屬性等上部（文檔注釋：通過 javadoc 命令生成 API 文檔，方便使用的人閱讀） * 方法體內負責業務邏輯處理過程中（一般性注釋） **文檔注釋** ~~~ /** * 相關的注釋內容，甚至可以使用 HTML 標簽 * */ ~~~ 在 javadoc 中也提供了豐富的標記 * @author：指定程序的作者 * @version：指定源代碼的版本 * @param：在方法中指定參數 * @return：在方法中指定返回值 在文檔注釋中可以使用html標簽，但是不能用自封閉的標簽。 使用javadoc命令生成**API文檔**，-d指定生成的目錄地址。 ~~~ 執行命令： javadoc -encoding utf-8 -d apidoc -version -author Hello.java ~~~ **單行注釋** ~~~ // 單行注釋 ~~~ **多行注釋** ~~~ /* 第一行注釋 第二行注釋 */ ~~~ ## JDK 幫助文檔 地址：[http://tool.oschina.net/apidocs/apidoc?api=jdk-zh](http://tool.oschina.net/apidocs/apidoc?api=jdk-zh) 在學習過程中，一定要經常的閱讀 JDK 文檔，去幫助理解相關類的定義。 看 JDK 中相關類的源碼，去學習編碼規范以及設計程序的思路。 > 在doc中包含了，類的說明、類的繼承關系、屬性的說明、構造器的說明、方法的說明等。 ## 標識符和關鍵字 標識符包含了 Java 中默認的關鍵字以及程序員自己定義的類名、方法名、變量名等等。 **標識符的命名規范：** * 只能包含數字、字母（大小寫，Unicode字符）、下劃線 \_、美元符`$` * 不能以數字開頭 * demo1、~demo-1~、$demo、\_demo、~1demo~ **分隔符：** * 花括號`{}`：定義代碼塊，邏輯上是一個整體，包括類的主體、方法體、靜態代碼塊、條件和循環語句的執行體； * 分號`;`：語句的結束，如果出現在一行中有幾條語句，那么多條之間也要用 ; 隔開； * 方括號`[]`：用于數組中； * 圓括號`()`：在方法中聲明形式參數，在調用方法的時候傳入實際參數，表達式優先級定義； * 空格：單個空格、Tab 鍵、Enter 鍵，空格的出現是不會影響程序運行的，但是良好的縮進，可以提高程序的可讀性； * 圓點`.`：用于類/對象與其成員之間的分隔，表示調用類/對象的屬性或者方法。 > 在 Java 中，只要看見單詞首字母是大寫的，那就是類 ~~~ 示例： class Client1 { public static void main(String[] args) { //多條語句可以定義在一行里，建議分開寫，可讀性更好 //int i = 0;String s = "Hello"; int i = 0; String s = "Hello"; System.out.println(i + " " + s); } } ~~~ ## 關鍵字  ## Java語言的書寫規則 * 大小寫敏感：所謂大小寫敏感就是在書寫的時候，例如Hello和HELLO，表示的是不一樣的意思。 * 類名：以駝峰的方式命名，首字母大寫，所謂駝峰就是出現兩個單詞的時候，單詞的首字母大寫，例如StudentScore * 方法名：以駝峰的方式命名，首字母小寫； * 源文件：在定義源文件名的時候，要和類名相同； * Java運行的主入口函數：public static void main(String\[\] args)，在執行java Hello后面可以跟著輸入參數，輸入參數可以多個，用空格隔開； * 代碼規范，如花括號的位置，代碼縮進等