從HelloWorld和文檔注釋開始入門Java編程

2019-11-26 14:54:23

字體：大中小

供稿：網(wǎng)友

HelloWorld

public class HelloWorld{  public static void main(String args[])  {  System.out.println("Hello World!");  //向控制臺輸出一條語句，同時必須以;結(jié)尾  }   }

運行上面程序如圖所示

2015102491959527.png (680×301)

我們通過上面的程序開始分析并學(xué)習(xí)Java語言的基礎(chǔ)知識；

1、注釋：

Java的注釋分為三種：單行注釋// 多行注釋/*…*/ 文檔注釋

像上面的HelloWorld程序分別用到了多行注釋和單行注釋。

Java還提供了另外一種注釋叫文檔注釋，如果編寫Java源代碼時添加了合適的文檔注釋，然后通過JDK提供的javadoc工具可以直接將源代碼里的文檔注釋提取成一份系統(tǒng)的API文檔。API文檔就是用以說明應(yīng)用程序接口的文檔。對于Java而言，API文檔通常說細(xì)說明了每個類、每個方法的功能及用法。

Java語言的API文檔的下載地址：http://www.oracle.com/technetwork/java/javase/downloads/index.html

關(guān)于文檔注釋，我會在后面專門有一篇文章

2、Java的組織形式

//Java程序必須是以類class形式存豐，類class是Java程序的最小程序單位class 類名{ /*Java解釋器規(guī)定：如需某個類能被解釋器直接解釋執(zhí)行，則這個類必須包含main方法，而且main方法必須使用pulbic static void來修飾，且main方法的形參必須是字符串?dāng)?shù)組類型(String args[]是字符串?dāng)?shù)組的形式) 也就是說main方法基本上固定不變的*/  public static void main(String args[])  {   }   }

3、Java源文件的命名規(guī)則
1)Java程序源文件的后綴必須是.java，不能是其他文件后綴名

2）一個Java源文件可以包含多個類定義，但最多只能包含一個public類定義；如果Java源文件里包含public類定義，則該源文件的文件名必須與這個public類的類名相同

3）Java語言是嚴(yán)格區(qū)分大小寫的語言。因為源文件的文件名保存的時候也應(yīng)注意大小寫

4）Java程序中的關(guān)鍵字全部是小寫的

總結(jié)：通過上面的程序簡單地說了一下Java程序的框架結(jié)構(gòu)。

文檔注釋

Java語言提供了一種功能更強大的注釋形式：文檔注釋。如果編寫Java源代碼時添加了合適的文檔注釋，然后通過JDK提供的javadoc工具可以直接將源代碼里的文檔注釋提取成一份系統(tǒng)的API文檔。API是應(yīng)用程序接口的意思，API是Java提供的基本編程接口，當(dāng)使用Java語言進(jìn)行編程時，不可能把所有的Java類、所有方法全部記下來，那么如果我們遇到一個不確定的地方時，必須通過API文檔來查看某個類、某個方法的功能和用法。

Java API文檔的下載地址：http://www.oracle.com/technetwork/java/javase/downloads/index.html

下載完成之后，打開DOCS/api文件夾里面的index.html文件，

1、API文檔首頁如圖

2015102492033785.png (851×524)

2、類說明區(qū)格局如下圖

2015102492055088.png (861×468)

2015102492116807.png (527×660)

由于只有以public或protected修飾的內(nèi)容才是希望暴露給別人使用的內(nèi)容，而API文檔主要是向使用者提供信息，因此javadoc工具默認(rèn)只處理public或protected修飾的內(nèi)容。如果開發(fā)者確實希望javadoc工具可以提取private修飾的內(nèi)容，則可以在使用javadoc工具時增加-private選項來實現(xiàn)

下面我們通過一個演示程序來說明文檔注釋

package Gee;/** 網(wǎng)站:<a >作者博客站</a> <br/>這是一個javadoc工具演示的程序 <br/>程序名：javadoc演示程序 <br/>程序文件名:JavaDocDemo @author Gee @version 1.0 */ public class JavaDocDemo {   /** 簡單的測試Field   */   protected String name;   /** 主方法，程序的入口 */   public static void main(String[] args)   {       System.out.println("Hello World!");   } }

2015102492140499.png (532×270)