??跟著磊哥學Java系列為Java基礎入門系列，通過此系列，我們將了解Java基礎知識，包括變數、資料型別、運算子，選擇結構、回圈結構、陣列等基本知識，此系列總結磊哥多年的經驗，采用邊講邊練的方式一起帶領零基礎的朋友走進Java世界，


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

??這是本系列的第二章
??您也可以通過下面連接查看其它章節

??磊哥帶你學Java——第一課 走進Java世界

Java控制臺輸出陳述句

輸出不換行

語法：System.out.print(“要輸出的字串”）;
**作用：**向控制臺輸出小括號中的字串，輸出后不換行，
**注意：**Java中的字串必須用英文雙引號包圍，

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

public class   MyFirstProgram   {
	public static void main(String[] args)  {
		//代碼中寫了兩行輸出陳述句
		System.out.print("HelloJava");
		System.out.print("HelloWorld");
	}
}

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

輸出并換行

語法：System.out.println(“要輸出的字串”）;
**作用：**向控制臺輸出小括號中的字串，輸出后換行，即在輸出后多輸出一個換行符，
**注意：**Java中的字串必須用英文雙引號包圍，

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

public class   MyFirstProgram   {
	public static void main(String[] args)  {
		//代碼中寫了兩行輸出陳述句
		System.out.println("HelloJava");
		System.out.println("HelloWorld");
	}
}

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

Java中的轉義符

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

public class   MyFirstProgram   {
	public static void main(String[] args)  {
		
		System.out.println("\"");
		
	}
}

輸出結果為：

Java中常見的轉義符

思考？
能不能用System.out.print()方法實作和System.out.println()方法一樣的效果呢？
相信聰明的你一定想出了方法，下面是其中的一種

public class   MyFirstProgram   {
	public static void main(String[] args)  {
		
		System.out.print("Hello Java\rHello World");
		
	}
}

練習一

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

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

Java中的注釋

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

??1. 寫在類上（如我們上面寫的代碼中：class MyFirstProgram就是類)或方法（如我們上面寫的代碼中 main(String[] args)就是一個方法）的注釋應注明類或方法的作用，
??2. 寫在方法中的注釋應是業務的思路（我們在今后的學習中會不斷的學習）
??3. 寫在變數中的注釋應注明變數的作用(下章開始我們將學習變數)

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

• 單行注釋
• 多行注釋
• 檔案注釋

單行注釋和多行注釋

??- 單行注釋以//開頭 后面寫注釋內容，
??- 多行注釋以 /*開頭，以*/ 結束，
下圖是添加了注釋的代碼：

public class   MyFirstProgram   {
	/*
	* main方法是程式的入口
	* main方法的四要素缺一不可
	* public 表示main方法是公有的
	* static  是靜態方法，我們在后續將學習
	* void 表示方法不對外提供資料，我們后續將學習
	* 小括號中的String[] args 是引數，表示方法將從外部接收資料
	* 現在演示的的Java的多行注釋，而不是檔案注釋，多行注釋斜線后是一個＊號
　　 * 中間每行的*號是為了好看，不是必須，
	*/	
	public static void main(String[] args)  {
		//向控制臺中輸出name和age，并輸出一個空行
		System.out.println("name\t\t\tage\n");
		
		System.out.println("LeiGe\t\t\t18");
		System.out.println("My name is LeiGe\t18");

		
	}
}

檔案注釋

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

• 在類、方法、屬性上的檔案注釋的類或方法的描述，可以在開發工具中生成提示資訊，
• 在類、方法、屬性上的檔案注釋可以通過javadoc命令生成幫助手冊（API) ，
• 檔案注釋以 /**開頭（注意是兩個*），以 */ 結束，
• 檔案注釋支持html語言，
• 檔案注釋寫法很專業，今天我們只簡單了解，在后續學習中，我們還會不斷的了解檔案注釋，以生成更專業的API手冊

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

• 第一部分寫類或方法的概要功能
• 第二部分寫類或方法的詳細功能
• 第三部分寫類或方法的標注

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

@author 程式的作者
@version 程式的版本
@param 程式的引數，有寫，沒有不寫
@return 程式的回傳值，有寫，沒有不寫

/**
* <p>寫在類第一行的檔案注釋應是類的作用.</p>
* 
* <P>空一行后這里寫類的詳細作用，支持html語法比如寫上：</P>
* <p>歡迎訪問<a href="https://blog.csdn.net/weixin_42452652">彥磊的博客</a></P>
* <p>其后可以寫明作者等資訊</p>
*
*<p>空一行后寫檔案標注，如作者、版本等</p>
* @author 彥磊
* @version 1.0
*/
public class   MyFirstProgram   {
	/**
	* <p>寫在方法檔案注釋第一行的是方法的概要作用.</p>
	* 
	* <p>空一行后寫方法的詳細作用</P>
	* <p>程式的入口.</p>
	* 
	* <p>空一行后寫檔案的標注，如引數、回傳值等.</p>
	* @param args  接收從控制臺傳入的引數.
　　* 
	*/	
	public static void main(String[] args)  {
		//向控制臺中輸出name和age，并輸出一個空行
		System.out.println("name\t\t\tage\n");
		
		System.out.println("LeiGe\t\t\t18");
		System.out.println("My name is LeiGe\t18");

		
	}
}

javadoc命令簡介

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

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


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

語法：javadoc -d 要生成的幫助檔案所在目錄 -author -version -windowtitle 要生成API的檔案


引數解釋：
-d 輸出檔案的目標路徑，即要生成的幫助檔案所在目錄，
-author 包含 @author 段，
-version 包含 @version 段，
-windowtitle 文字 瀏覽器視窗顯示的標題，
-要生成API的檔案 對哪些檔案生成檔案，
每個引數中間都需要由空隔間分隔，


示例:
*javadoc -d d:\javaProject\doc -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.添加完注釋后，再次對類進行編譯運行，不能出錯，

練習三

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

1.使用javadoc命令生成類的API，
2.打開API檔案，對各種描述及標注進行一一對應，加深對檔案注釋的理解 ，

總結

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

??歡迎大家在評論中提出自己的建議及想和磊哥交流的問題，我將及時和大家交流，歡迎大家關注磊哥的博客，您將快速得到我的更新

練習參考代碼

練習一參考代碼

public class   MyFirstProgram   {
	public static void main(String[] args)  {
		//行末的\n是為了多輸出一個換行符
		//由于My name is LeiGe比較長，因此在name后加了三個\t，用于對齊制表位，
		System.out.println("name\t\t\tage\n");
		System.out.println("LeiGe\t\t\t18");
		System.out.println("My name is LeiGe\t18");
	}
}

練習二參考代碼

/**
* <p>寫在類第一行的檔案注釋應是類的作用.</p>
* 
* <P>空一行后這里寫類的詳細作用，支持html語法比如寫上：</P>
* <p>歡迎訪問<a href="https://blog.csdn.net/weixin_42452652">彥磊的博客</a></P>
* <p>其后可以寫明作者等資訊</p>
*
*<p>空一行后寫檔案標注，如作者、版本等</p>
* @author 彥磊
* @version 1.0
*/
public class   MyFirstProgram   {
	/**
	* <p>寫在方法檔案注釋第一行的是方法的概要作用.</p>
	* 
	* <p>空一行后寫方法的詳細作用</P>
	* <p>程式的入口.</p>
	* 
	* <p>空一行后寫檔案的標注，如引數、回傳值等.</p>
	* @param args  接收從控制臺傳入的引數.
　　　　　* 
	*/	
	public static void main(String[] args)  {
		/*
		* 向控制臺中輸出name和age，并輸出一個空行
		* \t 的作用是輸出一個制表位
		* \n的作用是輸出一個換行符
		*/
		System.out.println("name\t\t\tage\n");
		//換行輸出LeiGe及18，并用制表位和上一行對齊
		System.out.println("LeiGe\t\t\t18");
		//換行輸出My name is LeiGe及18，并用制表位和上一行對齊
		System.out.println("My name is LeiGe\t18");

		
	}
}

練習三參考代碼

D:\javaProject>javadoc -d d:\javaProject\doc -author -version -windowtitle 我的第 一個API  *.java