自定義工具庫
掌握前述的知識後,接下來就可以開始創建自己的工具庫,以便減少或者完全消除重復的代碼。例如,可為System.out.println()創建一個別名,減少重復鍵入的代碼量。它可以是名為tools的一個包(package)的一部分:
//: P.Java
// The P.rint & P.rintln shorthand
package com.bruceeckel.tools;
public class P {
public static void rint(Object obj) {
System.out.print(obj);
}
public static void rint(String s) {
System.out.print(s);
}
public static void rint(char[] s) {
System.out.print(s);
}
public static void rint(char c) {
System.out.print(c);
}
public static void rint(int i) {
System.out.print(i);
}
public static void rint(long l) {
System.out.print(l);
}
public static void rint(float f) {
System.out.print(f);
}
public static void rint(double d) {
System.out.print(d);
}
public static void rint(boolean b) {
System.out.print(b);
}
public static void rintln() {
System.out.println();
}
public static void rintln(Object obj) {
System.out.println(obj);
}
public static void rintln(String s) {
System.out.println(s);
}
public static void rintln(char[] s) {
System.out.println(s);
}
public static void rintln(char c) {
System.out.println(c);
}
public static void rintln(int i) {
System.out.println(i);
}
public static void rintln(long l) {
System.out.println(l);
}
public static void rintln(float f) {
System.out.println(f);
}
public static void rintln(double d) {
System.out.println(d);
}
public static void rintln(boolean b) {
System.out.println(b);
}
} ///:~
所有不同的數據類型現在都可以在一個新行輸出(P.rintln()),或者不在一個新行輸出(P.rint())。
大家可能會猜想這個文件所在的目錄必須從某個CLASSPATH位置開始,然後繼續com/bruceeckel/tools。編譯完畢後,利用一個import語句,即可在自己系統的任何地方使用P.class文件。如下所示:
ToolTest.Java
所以從現在開始,無論什麼時候只要做出了一個有用的新工具,就可將其加入tools目錄(或者自己的個人util或tools目錄)。
CLASSPATH的陷阱
P.java文件存在一個非常有趣的陷阱。特別是對於早期的Java實現方案來說,類路徑的正確設定通常都是很困難的一項工作。編寫這本書的時候,我引入了P.java文件,它最初看起來似乎工作很正常。但在某些情況下,卻開始出現中斷。在很長的時間裡,我都確信這是Java或其他什麼在實現時一個錯誤。但最後,我終於發現在一個地方引入了一個程序(即第17章要說明的CodePackager.java),它使用了一個不同的類P。由於它作為一個工具使用,所以有時候會進入類路徑裡;另一些時候則不會這樣。但只要它進入類路徑,那麼假若執行的程序需要尋找com.bruceeckel.tools中的類,Java首先發現的就是CodePackager.Java中的P。此時,編譯器會報告一個特定的方法沒有找到。這當然是非常令人頭疼的,因為我們在前面的類P裡明明看到了這個方法,而且根本沒有更多的診斷報告可為我們提供一條線索,讓我們知道找到的是一個完全不同的類(那甚至不是public的)。
乍一看來,這似乎是編譯器的一個錯誤,但假若考察import語句,就會發現它只是說:“在這裡可能發現了P”。然而,我們假定的是編譯器搜索自己類路徑的任何地方,所以一旦它發現一個P,就會使用它;若在搜索過程中發現了“錯誤的”一個,它就會停止搜索。這與我們在前面表述的稍微有些區別,因為存在一些討厭的類,它們都位於包內。而這裡有一個不在包內的P,但仍可在常規的類路徑搜索過程中找到。
如果您遇到象這樣的情況,請務必保證對於類路徑的每個地方,每個名字都僅存在一個類。