java第一章學(xué)習(xí)與復(fù)習(xí)要點(diǎn)-資料下載頁(yè)
2025-01-12 07:19本頁(yè)面
【正文】 ?文檔注釋 單行注釋 ： // 多行注釋 ： /* */ 文檔注釋 ： /** *文檔注釋 *可以生成 API文檔 */ API接口 API接口 —— 應(yīng)用程序接口 API文檔 —— 用來(lái)說(shuō)明這些應(yīng)用程序接口的文檔，對(duì)于 Java語(yǔ)言來(lái)說(shuō)， API文檔通常詳細(xì)說(shuō)明了每個(gè)類、每個(gè)方法的功能。 API文檔生成 可以使用 Javadoc工具生成 API文檔， Javadoc工具只處理在類、接口、方法、屬性、構(gòu)造器和內(nèi)部類之前的注釋，忽略其它地方的文檔注釋，而且 Javadoc工具默認(rèn)只處理以 public、protected修飾的類、接口、方法、屬性、構(gòu)造函數(shù)之前的注釋，如果希望可以提取 private修飾的內(nèi)容，則可以在使用 Javadoc工具時(shí)增加 private選項(xiàng)。 Javadoc命令的基本用法如下： javadoc 選項(xiàng) Java源文件 /包 javadoc的常用選項(xiàng)有如下幾個(gè)： d directory:該選項(xiàng)指定一個(gè)路徑，用于將生成的 API文檔放到指定目錄下。 windowtitletext:該選項(xiàng)指定一個(gè)字符串，用于設(shè)置 API文檔的瀏覽器窗口標(biāo)題。 doctitlehtmlcode： 該選項(xiàng)指定一個(gè) HTML格式的文本，用于指定概述頁(yè)面的標(biāo)題。（如果有多個(gè)包下的源文件來(lái)生成 API文檔時(shí)，才有概述頁(yè)面）。 headerhtmlcode： 該選項(xiàng)指定一個(gè) HTML格式的文本，包含每個(gè)頁(yè)面的頁(yè)眉。 標(biāo)記語(yǔ)法 作用 適用范圍 @author 作者名 標(biāo)明開發(fā)該類的作者 類 @deprecated 不推薦說(shuō)明 標(biāo)明此類或者方法不再推薦使用 類 、 方法 、 屬性 @exception 異常類名 說(shuō)明 對(duì)方法可能拋出的異常進(jìn)行說(shuō)明 方法 @param 參數(shù)名 描述 對(duì)方法中的參數(shù)說(shuō)明 方法 @return 描述 對(duì)方法的返回值說(shuō)明 方法 @see 參見處 相關(guān)主題的參見處 類 、 方法 、 屬性 @throws 類名 描述 對(duì)方法可能拋出的異常進(jìn)行說(shuō)明 方法 @version 版本號(hào) 標(biāo)明當(dāng)前該類的版本號(hào) 類 @since 版本號(hào) 標(biāo)明起始版本號(hào) 類 、 方法 、 屬性 Javadoc常用標(biāo)記 上述標(biāo)記的使用是有位置限制的， 在類或接口文檔注釋中的有：@see,@deprecated,@author,@version等； 在方法或構(gòu)造器文檔注釋中的有@see,@deprecated,@param,@return,@throw和 @exception等； 在屬性文檔注釋中的有： @see,@deprecated等。 為了能提取文檔中的 @author和 @version等標(biāo)記， 在使用 javadoc工具時(shí)增加 author和 version兩個(gè)選項(xiàng) 注意： 關(guān)于 EditPlus 1．配置 EditPlus的用戶工具 單擊 EditPlus的 【 工具 】 菜單 【 配置用戶工具 】 ，彈出“首選項(xiàng)” 對(duì)話框，點(diǎn)擊其中的 【 組名稱 】 按鈕可對(duì)用戶工具命名，然后單 擊 【 添加工具 】 按鈕，添加編譯和運(yùn)行 Java程序的 JDK工具 javac和 java。 （ 1）添加 javac工具 單擊 【 添加工具 】 按鈕之后選擇“程序”，然后在其對(duì)話框中的“菜單文本”項(xiàng)中填寫“ javac工具”（可隨意命名）；在“命令”項(xiàng)中填寫本機(jī) javac工具的路徑，如 D:\Java\\bin\；在“參數(shù)”項(xiàng)中選擇“文件名”即 $(FileName)；在“初始目錄”項(xiàng)中選擇“文件目錄”即$(FileDir)。然后點(diǎn)擊 【 應(yīng)用 】 按鈕保存 （ 2）添加 java工具 在“菜單文本”項(xiàng)中填寫 java工具（可隨意命名）；在“命令”項(xiàng)中填寫 java工具在本機(jī)的具體路徑如D:\Java\\bin\；在“參數(shù)”項(xiàng)中選擇“不帶擴(kuò)展名的文件名”即 $(FileNameNoExt)，在“初始目錄”項(xiàng)中選擇“文件目錄”即 $(FileDir) 知識(shí)回顧： 一、 JDK的安裝和配置： 安裝的路徑： 修改路徑， 不要安裝在帶空格的路徑 下，如： c:\program file\... 配置環(huán)境變量： 記得放在最前段，并且用分好分割。 第一個(gè)應(yīng)用程序： HelloWorld 書寫 HelloWorld 類名不能包含空格，如： public class Hello World 其余嚴(yán)格按照 HelloWorld的書寫規(guī)范，注意： public static void main(String[ ] args) 存放路徑： 路徑不要太深，如可放在 d:\test下，則編譯和運(yùn)行的時(shí)候需要首先轉(zhuǎn)到 d盤的 test文件夾下，命令行輸入如下： d: //轉(zhuǎn)到 d盤下面 cd test //轉(zhuǎn)到 d盤下面的 test文件夾下 cd java //轉(zhuǎn)到 d盤下面的 test文件夾下的 java文件夾下 cd .. //退出 java文件夾，回到 test文件夾下。 類名與文件名一致！ 會(huì)查看文件存放的位置。
教學(xué)課件相關(guān)推薦
鄂ICP備17016276號(hào)-1