包的內容
包的內容應該仔細設計,使其只包含在功能上相關的類和接口。包中的類可以自由地訪問該包中其他類的非私有成員,有些類甚至可能有足夠的權限去訪問其他類的內部細節,為了避免這樣的類對類成員進行誤操作,我們需要對類成員進行保護。任何沒有被聲明為private的成員都可以被同一個包中的其他所有類型訪問,所以任何不相關的類之間的藕合程度都可能會比我們所期望的程度高。
包還為尋找有用的接口和類的程序員提供了邏輯分組的功能。由不相關的類組成的包使程序員很難分辨出哪些接口和類是有用的,而類的邏輯分組可以幫助程序員重用代碼,因為程序員通過邏輯分組能夠更容易地找到他們所需要的東西。如果包中只包含相關的、緊藕合的類型集,則意味著我們可以給類型取一些更直觀的名字,從而避免名字沖突。
包可以嵌套。例如,java.lang就是一個嵌套包,其中,包Lang嵌套在更大的包java中,而包j ava卻還包含一些其他的包。嵌套使得相關的包構成了具有層次結構的命名系統。
例如,為了創建一組包,用于諸如神經網絡和遺傳算法這樣的自適應系統,我們可以用以圓點分隔的名字來命名包,從而創建嵌套包:
1
|
package adaptive. neural Net; |
含有上面這條聲明語句的源文件位于adaptive.neuralNet包中,而adaptive.neuralNet包本身又是adaptive包的子包。adaptive包中可能包含一些與通用的自適應算法相關的類,例如泛化問題陳述類或基準測試類。在層次結構中處于更深位置的包(例如adaptive. neu-ralNet或adaptive.genetic)包含與特定類型的自適應算法相關的類。
包的嵌套僅僅是組織相關包的一種工具,它并不能提供包之間的任何特殊的訪問權限。
adaptive.genetic包中的類代碼無法訪問adaptive或adaptive.neuralNet包中具有包訪問權限的成員,包作用域只適用于特定的包。包的嵌套可以對相關的包進行分組,并幫助程序員更方便地在邏輯層次中找到想要的類,但是除此之外,它并未帶來其他的任何益處。
包的注解
包也可以有注解。但是問題在于,由于包是一種組織結構,沒有源代碼實體,它們并沒有實際的定義,所以不能像對類或方法那樣對它們進行注解,因此包的注解只能通過在源文件中對包的聲明語句進行注解來實現。然而,在每個包中只能有一個包聲明可以擁有作用于它的注解。
那么究竟如何對包進行注解呢?事實上,Java語言并沒有強制程序員必須使用某種方式來處理“單一注解的包語句”規則。所建議的方式是在包目錄中創建一個名為package一i nfo.java的文件,在這個文件中只存儲包語句和該包的注解,而不放置任何其他內容。例如,用于attr包的package一info.java文件看起來就是這樣的:
1
2
3
4
5
6
7
|
@PackageSpec (name二”Attr Project ",version=" 1.0 " @DevelopmentSite ( "attr.project.org" ) @DevelopmentModel ( "open一source" ) package attr; |
其中Packagespec,Developmentsite和Devel opmentmodel用來修飾注解類型,當然,它們具有運行時的保存策略。package一info.java文件應該和包中的其他源文件一起編譯。
我們推薦將所有與包相關的信息都放置在package一info. java文件中。如果你這樣做了,那么你就可以在文件的開頭放置文檔注釋,從而使這些文檔被注釋成包文檔。
包對象和規范
包通常會實現某種規范,并且通常是來自于某個組織的。Package對象與其他的反射類型不同,不能用來創建或操作包,而只能充當提供信息的知識庫,用來提供有關包所實現的規范的信息(規范的標題、供應商和版本號)和有關包的實現本身的信息(包的標題、供應商和版本號)。雖然包通常來自于單個的組織,但它所實現的規范(如統計分析庫)卻可能是其他組織已定義過的。使用包的程序可能需要知道該包所實現的規范的版本,從而可以使用只在某個版本中定義的功能。類似地,這些程序還可能需要知道提供給它的是哪個實現版本,這主要是為了處理在不同版本中可能存在的缺陷。Package類的一些主要方法允許訪問到這些信息:
- ·public Stri ng getName ():返回該包的名字。
- .public string getspecificationTitle p:返回該包所實現的規范的標題,如果標題未知,則返回null,
- .public string getspecificationversion():返回一個描述該包所實現的規范的版本信息的字符串,如果版本信息未知,則返回null,
- .public string getspecificationvendor Q:返回供應商的名字,這個供應商擁有并維護該包所實現的規范,如果供應商未知,則返回null,
- .public string getImplerentationTitle():返回該包所提供的實現的標題,如果標題未知,則返回null, ·public string getImplementationversion():返回一個描述該包所提供的實現的版本信息的字符串,如果版本信息未知,則返回null,
- ·public string getImplementationvendor():返回提供該實現的組織(供應商)的名字,如果該組織未知,則返回null,
例如,在我們的系統中提取java.lang包的這些信息,將會得到如下結果:'
1
2
3
4
5
6
7
8
9
10
11
|
Specification Title: Java Platform API Specification Specification Version: 1.4 Specification Vendor:Sun Microsystems,Inc. Implementation Title:Java Runtime Environment Implementation Version:1.5.0_02 Implementation Vendor: Sun Microsystems,Inc. |
規范版本號由句點分隔符分開的非負數字組成,如‘'2.0'‘或”11.0.12"。這種模式使得我們可以調用iscompatiblewith方法對遵循該模式的版本號與包的版本號進行比較。如果包的版本號大于等于傳人的版本號,那么該方法就返回true。這種比較每次只比較一個由句點分隔的數字,如果這些數字中任何一個小于傳遞進來的版本號中對應位置的值,那么這兩個版本就不兼容。如果其中一個版本號比另一個長,那么在短的版本號中缺少的部分將被認為是零。例如,如果包的規范版本號是”1.4",并且我們用iscompatiblewith方法將其與”1.2","1.3.1'.或”.1.81.進行比較時,那么將返回true;但是如果與''1.4.2'.或”.5"進行比較,那么將返回false。之所以得出這樣的結論,是因為這種比較機制假設規范版本是向后兼容的。
實現的版本號沒有規定的格式,因為提供實現的不同組織會對實現版本做不同的定義。在實現版本之間唯一能做的比較是測試版本是否相同,其中沒有向下兼容的假設。
包可以被密封起來,這意味著不能再向這個包中添加類了。未密封的包可以包含來自類搜索路徑中多個不同位置的類,而被密封的包的內容必須來自相同的位置—要么是某個特定的歸檔文件,要么是由某個URL指定的位置。有兩種方法可以確定一個包是否被密封了:
.public boolean issealed p:如果該包被密封了,則返回trueo
.public boolean issealed(URL url):如果該包對于給定的URL是密封的,則返回true,也就是說,該包中的類可以從這個給定的URL處加載。如果包中的類不能從給定的URL加載,或者包沒有被密封,則返回false,包的規范和實現信息通常是作為與包存儲在一起的清單文件的一部分而提供的—例如作為Java歸檔文件(jar)中的清單文件的一部分,就像25.9.2節“歸檔文件java.util.jar”中描述的那樣。當加載包中類時,這些信息就會被讀人。類加載器(ClassLoader)可以為它要加載的類動態地定義一個Package對象:
我們可以調用給定類的Class對象的getPackage方法來獲得這個類的Package對象。我們也可以用給定的包名調用靜態方Package.getPackage來獲得Package對象,或者調用靜態方Package.getPackages,它將返回由類加載器當前已知的所有包組成Package數組。這兩個方法都與調用它們的代碼的類加載器有關,因為這些代碼將調用其類加載器的get-Package或getPackages方法。這些類加載器的方法將搜索特定的類加載器及其所有父類加載器,如果對當前類加載器沒有做任何設置,那么此時就會使用系統類加載器。請注意,如果包未知,那么類加載器方法將返回null,因為此時還沒有加載包中的任何類型。