觸摸Java中的包和文檔

2019-11-18 15:45:43

字體：大中小

來源：轉載

供稿：網友

什么是包

　　java中的包（Package）其實指的就是目錄，它是為了更好地治理Java類（Class）和接口（Interface）。Java語言的包可以被另一個Java開發包所使用。假如我們要引用某個包中的類，用import要害字來標明即可。比如：

import java.util.
date=new Date
　　提示：import java.util.表示java.util中的所有公有類和接口被引入到當前包。這里的匹配符可以調入多個類名。

　　常用的Java標準包

　　JDK為我們提供了很多標準的Java類和接口，這些包是寫Java程序所必需的，知道了每種包所包含的類和接口，并且熟悉這些類和接口是每個Java編程人員都應該把握的基本技能。

　　Java中常用的包有：Java.applet、java.awt、java.i、java.lang、java.net和java.util等等。其中java.applet包含了一些設計小應用程序（Applet）的類和接口；java.awt是一個窗口工具箱包（awt Abstract Window Toolkit），里面是一些GUI界面相關的類；java.io包支持輸入輸出，比如文件輸入流類：FileInputStream等；java.lang包含線程、異常、系統、整數等相關的類，是Java程序中默認加載的一個包；java.net這個類支持TCP/ip網絡協議，并包含Socket類及URL相關的類，是網絡編程中要使用的；java.util包含一些程序的公用類，如DateDictionary等等。

　　除了上面提到的一些標準包之外，還有很多其它的包，比如數據庫編程時我們可能需要使用java.sql包，寫網絡程序還會用到java.rmi包（RMI Remote Method Invocation）等。另外，Javax.包是一些標準包的擴展，常用的包有：javax.swing、javax.sound。

　　自己動手創建包

　　Java中的包是可以自己創建的。我們可以將很多功能相近的類和接口放在同一個包中，以方便治理和使用。

　　創建包的基本方法

　　1.定義Public類；

　　2.首句加“Package 包名”；

　　3.將Java文件生成的Class放在以包名為目錄名的目錄中

　　4.在其它程序中用“import 包名”就可以存取此包中的所有Public類。

　　包的創建和使用

//filename B.java
package com.chen.test　//定義一個包
public class B //定義一個類
public void addint iint j //兩個數求和，并輸出
System.out.PRintlni+j
　　上面的代碼便是為了創建一個簡單的包：com.chen.test，我們將這個文件命名為B.java。現在運行javac -d C/ B.java編譯該包（該命令在C盤下生成com/chen/test目錄，并將編譯結果保存在B.class中）。現在我們進入C/com/chen/test目錄可以看到編譯生成的Class文件也包含在內了。

　　OK，現在這個包已經創建好了，這時需要你做的是把C/com/chen/test設置在你的環境變量classpath里。

　　如何調用包

　　現在我們再用一個小程序來調用上面創建的包：

//filename A.java
import com.chen.test.//引入剛才創建的包
public class A
public static void mainString args
B test = new B
test.add68 //用add調用自定義包
　　將上面的Java代碼保存為C/A.java然后編譯：javac C/A.java。

　　提示：對于包文件B.java，你可以不編譯而只將它放到C/com/chen/test目錄下即可。要注重的是，A.java和B.java兩個文件不可以放在相同目錄下，這樣就會出錯。

　　Java文檔及Javadoc

　　除了包之外，Java文檔也是Java編程中非常重要的一個概念。Java文檔就是Java程序的幫助文檔。一般情況下，我們先寫好幫助文檔，再利用工具Javadoc來生成相應的文檔。Javadoc是JDK提供的一個文檔生成工具，它利用Java編譯程序Javac對程序代碼源文件中的聲明和文檔注釋進行語法分析，并在默認情況下生成一組Html文檔來描述類、內部類、接口、構造函數、方法和域。Javadoc注釋以“/”開始，以“/”結束，里面可以包含普通文本、HTML標記和Javadoc標記。Javadoc只處理源文件中在類/接口定義、方法、域、構造器之前的注釋，忽略其它地方的注釋。

　　把握Javadoc

　　現在我們先用一個例程來說明Javadoc標記的意義：

/
我的JavaDoc測試程序--JavaDocTest
@author <a href=http//www.csdn.net>warton2003 西安</a>
 test<--這里可以嵌入HTML本句為HTML注釋-->
@version 0.1 2004/01/01
/
public class JavaDocTest

/
在main 中要使用字符串
@see #mainjava.lang.String
/
static String SDisplay
/
顯示Javadoc測試
@param args 命令行參數
@return 沒有返回值
/
public static void mainString args

SDisplay = ″Javadoc測試″ 
System.out.println SDisplay 
　　在這個Java程序里面，使用了大量的Javadoc標記、文本以及HTML標記。Javadoc標記以“/”開始，表明這些都是Java代碼的注釋。“@”開頭的標記就是Javadoc標記。

　　Javadoc標記有兩種：獨立（Standalone）標記和內聯（Inline）標記。獨立標記也就是那些常見的標記，如@param、@return和@author等；另一種類型的標記是內聯標記這種標記采用@tag的形式 它答應開發者創建超級鏈接從注釋部分鏈接到其它的Javadoc頁面或者本頁面的其它地方。

　　提示：在Java源程序里正確使用Javadoc標記是非常必要的注釋習慣，將有助于Javadoc自動以源代碼文件生成完整的格式化API文檔。

　　OK，那么我們先看看Javadoc是如何生成漂亮的文檔!將上面的代碼保存到JavaDocTest.java并編譯。

　　運行：javadoc -private -d doc -auth
or -version JavaDocTest.java

　　這時，Javadoc程序會根據JavaDocTest.java生成一個doc目錄，里面有很多HTML文件，這些就是Javadoc生成的API幫助文檔。

　　Javadoc命令行語法

　　光會使用標記還不能很好利用Javadoc提供的功能，必須能使用它的命令行才行。最后向大家介紹一下簡單的Javadoc命令。

　　Javadoc的命令行語法如下：

上一篇：X3D實戰基礎講座之十二

下一篇：書評：Java的盛宴(上)