Java中如何使封裝自己的類，建立並使用自己的類庫？

該文轉載SmilingSunrise的文章：http://blog.csdn.net/luoweifu/article/details/7281494

一、先來明白一下關於classpath和path的概念

path是java中用來進行編譯和執行的程式所在的路徑，而classpath是類所在的路徑。安裝JDK之後，你應當設定好path和classpath路徑。現在假設你JDK是安裝在D:\IT\JDK6.0\java(TM) SE Development Kit下（因為我自己的是安裝在此目錄下），那麼你要設定的path路徑就是這個路徑下的bin資料夾，即D:\IT\JDK6.0\java(TM) SE Development Kit\bin，因為bin資料夾下里面有javac.exe和java.exe（就是java中用來進行編譯和執行的程式）。設定的方法如下：

1.開啟“我的電腦\高階\環境變數”，如果是win7，則是：““計算機\屬性\系統屬性\高階環境變數”,開啟如圖一，

圖一

雙擊“系統變數”下的path，把D:\IT\JDK6.0\java(TM) SE Development Kit設定進去，如圖二

圖二

開啟命令提示符，輸入javac，如果有一連串的文字，則說明設定成功。順便說一下常用的命令提示符：javac 編譯java檔案，java執行java檔案，java –version查詢JDK的版本，包路徑+“-cvf”+ className.java 打成Jar包，

2.接下來是接著設定classpath，假設你的java檔案是在E:java資料夾，則可這樣設定：如圖三，後面有一點表示當前路徑，這樣的話你可以再任何路徑下用javac編譯java檔案。

圖三

3.如果你現在又一個打包好的jar檔案（如何達成jar包後面會講），現在要使用jar包裡的類，則需要將jar包設定成classpath變數。假設你有一個自己tools.jar包，放在D:\IT\JDK6.0\java(TM) SE Development Kit\myJar，則需要將D:\IT\JDK6.0\java(TM) SE Development Kit\myJar\tools.jar設定到classpath中，如圖四

圖四

此時，你就可以在類中引用tools.jar中的類了，只需要在類中將其引入。以上操作在win7可能還出問題，還需要設定使用者變數裡的classpath(為什麼會這樣，我也不值得，希望共同探討)。注意在圖一中是有“Adiministrator使用者變數”和“系統變數的”，這是隻需按照圖四將D:\IT\JDK6.0\java(TM) SE Development Kit\myJar\tools.jar設定到使用者變數裡的classpath中去就行。

      二、在Eclipse中如何打成jar包？生自己的類庫

Eclipse和MyEclipse是目前最流行的java整合開發環境，如果你用的是其他的開發工具，建議你嘗試著用一下Eclipse進行開發，因為它功能很強大，很好用。下面就介紹一下如何在Eclipse下將自己寫好的類打成jar包，生成自己的類庫。

假設當前的文件結構這樣的：

圖五

右擊專案檔案Tool,選擇Export，開啟對話方塊，選擇Java\JAR file後下一步，如果你只需要打包cn.edu.jxau.tools下的類，只需要選擇該類即可，如圖六

圖六

在JAR file中選擇要匯出的路徑和檔名，如圖圖七

圖七

點選“下一步”、“下一步”，然後Main class中選擇包含main函式（如果有面函式的話），然後點選完成（finish）。

三、為自己的類生成註釋文件，即生成javadoc檔案。

第二的介紹可以生成自己的類庫了。但是時間久自己寫的類和方法就會忘記，生成一個高質量的註釋文件就很有必要的。慶幸的是Java自己就能很好的完成這一功能，能幫我們生成類似API的文件，即javadoc文件。下面介紹一下在Eclipse中如何生成javadoc文件：

1、對類進行註釋

在生成javadoc文件之前首先要對類進行註釋。註釋有如下三種方式：

a，//註釋內容；b，/*註釋內容*/；（快捷鍵：選中要註釋的內容後按“shift+Ctrl+/”,取消註釋是“shift+Ctrl+\”）

c，

/**

*註釋內容。

*/

其中只有c方式在生成javadoc中才有用。以我自己寫的ArrayQueue類為例說明一下幾種註釋，只需要對public方法和變數進行註釋，因為只有public型別才能被其他類訪問。

（1）、在類前面註釋類說明和創作者，如

/**

 * 檔案的複製，字串輸入到檔案中，將檔案內容列印到控制檯

 *

 * @author xiaoxu

 *

 */

（2）、在public方法前面註釋方法的說明，如public static String readFile(File file)方法註釋：

/**

    * 讀取一個檔案裡的內容

    *

    * @param file

    *            要讀的檔案

    * @return 返回讀取檔案的字串

 */

（3）、註釋對public變數進行註釋，假設有一表示視窗寬度的變數WIDTH，如下注釋

/**

    * 主視窗的寬度

    */

   public static final int WIDTH = 1000;

部分結果如下

圖八（1）

2、用Eclipse生成javadoc文件

選中要生成javadoc文件的專案，再在選單欄中的選擇菜project\Generate Javadoc…。開啟對話方塊後“javadoc command”的預設路徑是C:\jdk\bin\javadoc.exe，如果沒有該路徑就自己新增，找到自己安裝JDK的根目錄下的bin\javadoc.exe，如下圖

選擇要生成javadoc的檔案，然後選擇匯出的路徑，一般選擇預設的專案下的doc資料夾，改成其他路徑可能會有錯。如下：

圖8（3）

之後就一路next，最後點finish就OK了。在這期間可能會出現警告，如下圖

圖8（4）

選擇“Yes To All”。

四、如何使用自己建立的類庫？

通過一、二、三，已經能夠建立自己的類庫了。下面說明一下如何使用自己的類庫。

方法一：

假設現在要建立一個專案Test,裡面要用到自己類庫tools.jar中的S類。新建一個類Test.java,裡面的main方法是這樣的：

public static void main(String[] args) {

   S.pl("java");  //S類中的S.pl()封裝了System.out.println(obj);

}

這時Eclipse會報錯，會說S這個類不存在，是否要建立這個類。這是因為預設的JRE並不存在tools.jar這個包，如圖八。

圖八（5）

那麼如何將這個包夾道預設的JRE System Library中呢？

選擇Window\ Preferences,開啟對話方塊，選擇Java\Installed JREs，如圖九

圖九

接下來，點選“Add”新增一個新的JRE，選擇Standard VM後點擊下一步，在JRE home中點選Directory選擇JDK按鈕路徑下的jre資料夾（即包含rt.jar的資料夾，rt.jar是jdk的根資料夾，裡面包含了所有的基本類）如圖，然後點選“Add External JARs”選擇生成好的tools.jar檔案（最好先別tools.jar放在一個比較訪問，比較安全的資料夾內，我的是直接放在JDK安裝路徑下的D:\IT\JDK6.0\java(TM) SE Development Kit\myJar裡），如圖十

圖十

點選finish。

   然後，在Test專案中將預設的JRE System Library換成剛剛配置好的JRE，右擊Test選擇Build Path選擇Configure Build Path…,開啟對話方塊，將原有的JRE Remove掉，然後Add Library，選擇JRE System Library，下一步，點選“Installed JREs”後選擇剛剛配置好的那個JRE，點選finish。

現在就配置好了。此時的JRE就能看到tools.jar檔案，如下圖：

圖十一

方法二：

將剛剛生成的自己的類庫Tool.jar直接拷貝到JDK和JRE的安裝目錄中的jre/lib/ext/中，這時候我們需要重啟一下Eclipse，這樣才能將剛才的那個包載入進自動生成的系統庫中。

方法三：

當然除以上方法之外，也可以直接在單個專案中通過"bulid path"匯入External Jar，額外的jar包。