跟著彥磊學Java系列為Java基礎入門系列。通過此系列，我們將了解Java基礎知識，包括變量、數據類型、運算符，選擇結構、循環結構、數組等基本知識。此系列總結磊哥多年的經驗，采用邊講邊練的方式一起帶領零基礎的朋友走進Java世界。

本系列每章都會有大量的練習題，請大家在學習過程中，認真地進行練習，并和我提供的參考代碼比較，反復感悟。要把一門語言學好，只學不悟是不可能學好的，用心自我感悟，多練，多想是學好一門語言的基礎。

這是本系列的第二章

Java控制臺輸出語句

輸出不換行

語法：System.out.print(“要輸出的字符串”）;

作用：向控制臺輸出小括號中的字符串，輸出后不換行。

注意：Java中的字符串必須用英文雙引號包圍。

例如：我們在記事本中寫入下面代碼

1. public class MyFirstProgram {

2.    public static void main(String[] args) {

3.       //代碼中寫了兩行輸出語句

4.       System.out.print("HelloJava");

5.       System.out.print("HelloWorld");

6.    }

7. }

運行結果如下，我們看到print 方法輸出是不換行的。

代碼運行結果

輸出并換行

語法：System.out.println(“要輸出的字符串”）;

作用：向控制臺輸出小括號中的字符串，輸出后換行，即在輸出后多輸出一個換行符。

注意： Java中的字符串必須用英文雙引號包圍。

例如：我們在記事本中寫入下面代碼

1. public class MyFirstProgram {

2.    public static void main(String[] args) {

3.       //代碼中寫了兩行輸出語句

4.       System.out.println("HelloJava");

5.       System.out.println("HelloWorld");

6.    }

7. }

運行結果如下，我們看到println方法輸出后加了換行符。

println方法輸出結果

Java中的轉義符

如果我們想輸出英文的雙引號等特殊字符如何做呢？在Java中我們可以通過轉義符輸出，轉義符的引導符為””，如果我們想輸出英文雙引號就要按下面方法進行：

1. public class MyFirstProgram {

2.    public static void main(String[] args) {

3.

4.       System.out.println(""");

5.

6.    }

7. }

輸出結果為：

輸出雙引號的結果圖

Java中常見的轉義符

思考？

能不能用System.out.print()方法實現和System.out.println()方法一樣的效果呢？

相信聰明的你一定想出了方法，下面是其中的一種

1. public class MyFirstProgram {

2.    public static void main(String[] args) {

3.       System.out.print("Hello JavarHello World");

4.    }

5. }

練習一

請按下圖的格式在控制臺輸出相應內容（因記事本編碼問題，我們暫不輸出中文，除非你知道如何調整記事本的編碼）：

練習一輸出結果

聰明如你，一定運行出了正確的結果。你也可以看一下文末的參考代碼。

Java中的注釋

注釋在程序中是給我們程序員看的，Java編譯時，不會對注釋進行任何操作。寫注釋是寫源碼的一部分，一個良構的程序，注釋應約占總代碼量的1/3 左右。注釋應實現以下作用：

??1. 寫在類上（如我們上面寫的代碼中：class MyFirstProgram就是類)或方法（如我們上面寫的代碼中 main(String[] args)就是一個方法）的注釋應注明類或方法的作用。

??2. 寫在方法中的注釋應是業務的思路（我們在今后的學習中會不斷的學習）

??3. 寫在變量中的注釋應注明變量的作用(第四課開始我們將學習變量)

??Java語言中的注釋共分三種

• · 單行注釋
• · 多行注釋
• · 文檔注釋

單行注釋和多行注釋

• 單行注釋以//開頭 后面寫注釋內容。
• 多行注釋以 /*開頭，以*/ 結束。

下面是添加了注釋的代碼：

1. public class MyFirstProgram {

2.    /*

3.    * main方法是程序的入口

4.    * main方法的四要素缺一不可

5.    * public 表示main方法是公有的

6.    * static 是靜態方法，我們在后續將學習

7.    * void 表示方法不對外提供數據，我們后續將學習

8.    * 小括號中的String[] args 是參數，表示方法將從外部接收數據

9.    * 現在演示的的Java的多行注釋，而不是文檔注釋，多行注釋斜線后是一個＊號

10. 　　 * 中間每行的*號是為了好看，不是必須。

11.    */

12.    public static void main(String[] args) {

13.       //向控制臺中輸出name和age，并輸出一個空行

14.       System.out.println("nametttagen");

15.       System.out.println("LeiGettt18");

16.       System.out.println("My name is LeiGet18");

17.    }

18. }

文檔注釋的作用很大，很強。下面描述中出現的新名詞，大家可以先記憶，不用去理會，在后續的學習中，我們會逐漸的學習，在今后的學習中磊哥也會不斷的強化注釋。

· 在類、方法、屬性上的文檔注釋的類或方法的描述，可以在開發工具中生成提示信息。

· 在類、方法、屬性上的文檔注釋可以通過javadoc命令生成幫助手冊（API) 。

· 文檔注釋以 /**開頭（注意是兩個*），以 */ 結束。

· 文檔注釋支持html語言。

文檔注釋寫法很專業，今天我們只簡單了解，在后續學習中，我們還會不斷的了解文檔注釋，以生成更專業的API手冊

??下面示例給類和方法添加了文檔注釋，注釋中的<p></p>,<a …></a>等為html代碼，主要是為了在幫助文檔中用，不了解可忽略，注釋一般分為三部分：

· 第一部分寫類或方法的概要功能

· 第二部分寫類或方法的詳細功能

· 第三部分寫類或方法的標注

??文檔注釋常見的標注：(除第一個和第二個外，其它大家僅需了解，在隨后的學習過程中，我們會繼續深化)

@author 程序的作者

@version 程序的版本

@param 程序的參數，有寫，沒有不寫

@return 程序的返回值，有寫，沒有不寫

1. /**

2. * <p>寫在類第一行的文檔注釋應是類的作用.</p>

3. *

4. * <P>空一行后這里寫類的詳細作用，支持html語法比如寫上：</P>

5. * <p>歡迎訪問<a >彥磊的博客</a></P>

6. * <p>其后可以寫明作者等信息</p>

7. *

8. *<p>空一行后寫文檔標注，如作者、版本等</p>

9. * @author 彥磊

10. * @version 1.0

11. */

12. public class MyFirstProgram {

13.    /**

14.    * <p>寫在方法文檔注釋第一行的是方法的概要作用.</p>

15.    *

16.    * <p>空一行后寫方法的詳細作用</P>

17.    * <p>程序的入口.</p>

18.    *

19.    * <p>空一行后寫文檔的標注，如參數、返回值等.</p>

20.    * @param args 接收從控制臺傳入的參數.

21. 　　*

22.    */

23.    public static void main(String[] args) {

24.       //向控制臺中輸出name和age，并輸出一個空行

25.       System.out.println("nametttagen");

26.       System.out.println("LeiGettt18");

27.       System.out.println("My name is LeiGet18");

28.    }

29. }

javadoc命令簡介

??文檔注釋寫完后，我們可以使用javadoc命令來生成API。

??java中的每個命令后加 -help參數都可獲取到命令的使用幫助，下圖演示了獲取幫助的命令及部分幫助信息

??今天我們重點了解部分參數

語法：

javadoc -d 要生成的幫助文檔所在目錄 -author -version -windowtitle 要生成API的文檔

參數解釋：

-d 輸出文檔的目標路徑，即要生成的幫助文檔所在目錄。

-author 包含 @author 段。

-version 包含 @version 段。

-windowtitle 文字 瀏覽器窗口顯示的標題。

-要生成API的文檔 對哪些文件生成文檔。

每個參數中間都需要由空隔間分隔。

示例:

*javadoc -d d:javaProjectdoc -author -version -windowtitle 我的第一個API .java上面命令的作用是：為當前目錄下所有的擴展名為.java的文件，在d盤javaProject的doc目錄中生成幫助文檔，幫助文檔顯示的標題為”我的第一個API”,顯示版本號和作者。

下圖演示了執行上述命令的過程。

執行成功后會在DOC目錄下生成API文檔

我們雙擊index.html就能打開我們的幫助文檔了。

下面我們一一把注釋和最終的效果對應一下，以更好理解文檔注釋。

點擊”程序包”,出現下圖，我們對應類的文檔注釋的第一行顯示內容

點擊上圖綠框框住的類名，進入類的詳細描述頁面，如下圖，請仔細對照：

點擊上圖綠框框住的文字，我們來對照方法的文檔注釋

練習二

??本階段我們學習Java中的注釋，重點了解了文檔注釋及javadoc命令生成API。通過下面練習來驗證一下，你是否掌握了吧。

1. 在練習一的基礎上，為第一個輸出語句添加多行注釋，詳細描述t n的作用及為什么添加多個t。

2. 在練習一的基礎上，為第二個及第三個輸出語句分別添加單選注釋，描述語句的作用。

3. 在練習一的基礎上，為MyFirstProgram類加文檔注釋，需要有概要描述、詳細描述、版本號及作者

4. 在練習一的基礎上，為main方法添加文檔注釋，需要有概要描述、詳細描述和參數標注。

5. 5.添加完注釋后，再次對類進行編譯運行，不能出錯。

練習三

??在練習二的基礎上完成練習三：

1. 使用javadoc命令生成類的API。

2. 打開API文檔，對各種描述及標注進行一一對應，加深對文檔注釋的理解 。

總結

??到此，今天的內容就已經結束了，下面的思維導圖是今天的總結 ：

?練習參考代碼

練習一參考代碼

1. public class MyFirstProgram {

2.    public static void main(String[] args) {

3.       //行末的n是為了多輸出一個換行符

4.       //由于My name is LeiGe比較長，因此在name后加了三個t，用于對齊制表位。

5.       System.out.println("nametttagen");

6.       System.out.println("LeiGettt18");

7.       System.out.println("My name is LeiGet18");

8.    }

9. }

練習二參考代碼

1. /**

2. * <p>寫在類第一行的文檔注釋應是類的作用.</p>

3. *

4. * <P>空一行后這里寫類的詳細作用，支持html語法比如寫上：</P>

5. * <p>歡迎訪問<a >彥磊的博客</a></P>

6. * <p>其后可以寫明作者等信息</p>

7. *

8. *<p>空一行后寫文檔標注，如作者、版本等</p>

9. * @author 彥磊

10. * @version 1.0

11. */

12. public class MyFirstProgram {

13.    /**

14.    * <p>寫在方法文檔注釋第一行的是方法的概要作用.</p>

15.    *

16.    * <p>空一行后寫方法的詳細作用</P>

17.    * <p>程序的入口.</p>

18.    *

19.    * <p>空一行后寫文檔的標注，如參數、返回值等.</p>

20.    * @param args 接收從控制臺傳入的參數.

21. 　　　　　*

22.    */

23.    public static void main(String[] args) {

24.       /*

25.       * 向控制臺中輸出name和age，并輸出一個空行

26.       * t 的作用是輸出一個制表位

27.       * n的作用是輸出一個換行符

28.       */

29.       System.out.println("nametttagen");

30.       //換行輸出LeiGe及18，并用制表位和上一行對齊

31.       System.out.println("LeiGettt18");

32.       //換行輸出My name is LeiGe及18，并用制表位和上一行對齊

33.       System.out.println("My name is LeiGet18");

34.

35.

36.    }

37. }