## Java編程那些事兒73——JDK文檔使用 陳躍峰 出自：[http://blog.csdn.net/mailbomb](http://blog.csdn.net/mailbomb) ### 第九章 JDK文檔使用 前面提到過，一個程序設計語言主要包含三個部分：語言的語法、開發工具和一套基礎的功能。Java語言的語法以及開發工具JDK前面都已經介紹過了，本章就將介紹Java語言提供的這套基礎的功能。 對于任何一個程序設計語言來說，都將提供一套已經編寫完成的基礎功能，這種和語言一起發布的這套基礎功能一般被稱作API(Application Programming Interface,應用編程接口)，在面向過程的語言中也被稱為函數庫(FunctionLibrary)，在面向對象的語言中也被稱作類庫(ClassLibrary)。 這套功能都會以專門的文檔來進行提供，在J2SE開發中，這套文檔稱之為JDK文檔。例如Windows操作系統的基本功能稱為WindowsAPI，而和VB、VC開發相關的功能組成的文檔稱之為MSDN等。 這套功能就是在學習程序設計過程中需要學習的基本開發技術。 ### 9.1 JDK文檔概述 JDK文檔中包含了JDK中開放給程序員的所有通用類結構的說明，該文檔是學習J2SE編程的必備參考資料，該文檔由SUN公司以免費的HTML文檔的形式進行提供，當然也可以下載到其他人制作的CHM格式的文檔。 JDK文檔沒有隨JDK一起發布，如果需要使用該份文檔，則需要到SUN公司的網站專門進行下載，最新版本的JDK文檔下載地址為： [http://java.sun.com/javase/downloads/?intcmp=1281](http://java.sun.com/javase/downloads/?intcmp=1281) 選擇“Java SE 6 Documentation”項目下載即可。 在06年初，SUN公司組織專人將JDK5.0的文檔翻譯成了中文，如果英文閱讀比較困難，則可以使用中文文檔，其下載地址為： [http://gceclub.sun.com.cn/chinese_java_docs.html](http://gceclub.sun.com.cn/chinese_java_docs.html) 說明：建議閱讀英文文檔，因為這樣既可以鍛煉英文閱讀能力，也可以閱讀到最新的文檔。 注意：使用的文檔的版本最好和使用的JDK的版本匹配。 JDK的文檔以網頁文件壓縮包的形式提供，下載完成以后，只需要解壓縮即可，可以根據需要解壓縮到任意的路徑。 ### 9.2 JDK文檔結構 打開JDK文檔所在目錄下api目錄中的index.html即可打開文檔結構，打開以后的界面如下圖所示： JDKAPI文檔圖 在該文檔中，頁面的左上角區域顯示JDK API中所有包名的列表，右下角區域默認顯示所有類結構，如果選擇對應的包名，則只顯示該包中的接口、類、異常和錯誤等信息。頁面右側區域顯示詳細信息，當選擇對應的類時，則顯示該類的詳細信息。 例如選擇java.lang包中的String類時，顯示的界面如下圖： String類的文檔結構 在類的文檔中主要包含以下幾部分內容：類的繼承和被繼承關系，類的聲明、類的功能說明、屬性列表、構造方法列表和方法列表等。類內部結構中的屬性、構造方法和方法每個都包含一個超鏈接，通過點擊該鏈接可以查看更詳細的說明。 ### 9.3 類和接口使用語法 在JDK文檔中，可以很方便的查閱到每個類的作用和類內部的結構，如構造方法、屬性和方法等，在實際的開發過程中，則需要根據項目的要求使用對應類。 具體該使用哪個類或接口，以及如何使用類或接口，這些是開發技術的要求，本部分只是總結一下和類和接口使用相關的語法知識。 無論使用類還是接口，首先需要引入該結構，使用的語法格式為： import包名.類名|*; 說明：這里的“|”表示或者的關系。 注意：java.lang包中的類和接口，系統會自動引入，所以該包中的類和接口無需引用即可使用。 ### 9.3.1 類使用語法 對于從JDK文檔中查閱出的類，使用的方法一般只有三種：繼承該類、使用該類的對象和調用該類中的靜態屬性或靜態方法。下面一一介紹這三種使用方式相關的語法。 #### 9.3.1.1繼承類的語法 如果以繼承的方式使用JDK文檔中提供的類，則對應的語法格式如下： 1、構造方法 首先需要說明的是，構造方法不被繼承。也就是說子類中的構造方法和父類中的構造方法的參數列表沒有關聯。 如果被繼承的類，也就是JDK文檔中提供的類，有默認的構造方法(也就是無參數的構造方法)，則子類的構造方法內部會自動調用，不需要編寫特殊的代碼。 如果被繼承的類中沒有默認的構造方法，則必須在子類中書寫構造方法，而且需要在子類的構造方法中的第一行使用super關鍵字調用父類中對應的構造方法，在使用super調用時也必須傳入對應的參數。 如果父類中沒有提供public或protected修飾的構造方法，則該類不能被繼承。 2、屬性和方法 繼承了一個類以后，該類中的所有屬性和方法都被繼承下來，在子類中可以像使用自己聲明的屬性和方法一樣使用這些結構。 說明：在JDK文檔中只將被覆蓋的方法單獨列舉在文檔中，未被覆蓋的屬性和方法則顯示在屬性和方法列表的下面。 最后一個和繼承有關的語法是，如果繼承的類是抽象類，則必須覆蓋父類中的抽象方法，否則聲明的類則必須聲明為抽象類。 #### 9.3.1.2使用類的對象 如果通過創建對象對類進行使用，這種方式是最常用的方式，則相關的語法格式如下： 1、構造方法 首先聲明對象，然后使用new關鍵字和構造方法來創建對象。當構造方法比較多時，根據需要調用合適參數列表的構造方法，調用時仔細閱讀參數列表即可。 格式為： 類名對象名 = new 構造方法(參數); 2、屬性和方法 當對象創建完成以后，則可以通過該對象調用類提供的屬性和方法了。 調用屬性和方法的語法格式為： 對象名.屬性? 或? 對象名.方法(參數) #### 9.3.1.3調用類的靜態屬性和靜態方法 調用類中的靜態屬性和靜態方法，語法中提供了簡單的格式： 類名.靜態屬性名???? 和???? 類名.靜態方法名(參數) 注意：對于類內部的靜態屬性和靜態方法，不推薦使用對象名.靜態屬性名和對象名.靜態方法名進行調用。 ### 9.3.2 接口使用語法 對于JDK文檔中提供的接口，其使用方式一般有兩種：聲明該接口的對象、實現該接口和繼承接口。接口的使用比類要簡單一些，下面一一介紹相關的語法格式。 #### 9.3.2.1 聲明接口對象 對于一部分接口，需要聲明一個接口對象，然后使用JDK中提供的方法或對應的子類構造方法進行創建，但是需要首先聲明接口的對象。 語法格式為： 接口名對象名; #### 9.3.2.2 實現接口 另外一種更常見的使用接口的方式是聲明一個類實現接口，一個類可以實現任意多個接口，使用implements關鍵字實現，如果接口中包含抽象方法，則必須覆蓋抽象方法，否則必須聲明為抽象類。 #### 9.3.2.3 繼承接口 也可以聲明一個接口，繼承JDK文檔中已有的接口，接口繼承接口支持多重繼承，使用extends關鍵字繼承即可。 ?