欧美bbbwbbbw肥妇,免费乱码人妻系列日韩,一级黄片

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

 更新時(shí)間：2015年10月24日 09:22:08   作者：簡(jiǎn)一  
這篇文章主要介紹了從HelloWorld和文檔注釋開始入門Java編程,涉及到Javadoc工具的使用,需要的朋友可以參考下

HelloWorld

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

運(yùn)行上面程序如圖所示

2015102491959527.png (680×301)

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

1、注釋：

      Java的注釋分為三種：?jiǎn)涡凶⑨?/  多行注釋/*…*/  文檔注釋

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

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

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

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

2、Java的組織形式

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

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

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

    3）Java語(yǔ)言是嚴(yán)格區(qū)分大小寫的語(yǔ)言。因?yàn)樵次募奈募４娴臅r(shí)候也應(yīng)注意大小寫

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

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

文檔注釋

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

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

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

1、API文檔首頁(yè)如圖

2015102492033785.png (851×524)

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

2015102492055088.png (861×468)

2015102492116807.png (527×660)

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

下面我們通過(guò)一個(gè)演示程序來(lái)說(shuō)明文檔注釋

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

2015102492140499.png (532×270)

除此之外，如果我們希望 javadoc工具生成更詳細(xì)的文檔信息，例如為方法參數(shù)、方法返回值等生成詳細(xì)的說(shuō)明信息，則可利用javadoc標(biāo)記。常用的javadoc標(biāo)記如下。

  •   @author:指定程序的作者 
  •   @version:源文件的版本
  •   @deprecated:不推薦使用的方法
  •   @param:方法的參數(shù)說(shuō)明信息
  •   @return:方法的返回值說(shuō)明信息
  •   @see: “參見(jiàn)”用于指定交叉參考的內(nèi)容
  •   @exception:拋出異常的類型
  •   @throws:拋出的異常,和exception同義。

javadoc工具默認(rèn)不會(huì)提取@author和@version兩個(gè)標(biāo)記信息，如果需要提取這兩個(gè)標(biāo)記應(yīng)該使用javadoc工具指定的-author和－version兩個(gè)版本

相關(guān)文章

最新評(píng)論