l 編程的一個(gè)最新趨勢,尤其是 Java 編程,就是使用元數據
l 元數據可以用于創(chuàng )建文檔,跟蹤代碼中的依賴(lài)性,甚至執行基本編譯時(shí)檢查
l 許多元數據工具(如 Xdoclet)將這些功能添加到核心 Java 語(yǔ)言中,暫時(shí)成為 Java 編程功能的一部分
l Javadoc是元數據工具,但除了生成文檔之外,沒(méi)有固定、實(shí)用、標準化的方式將數據用于其他用途,而且HTML代碼經(jīng)?;烊氲?/span>Javadoc輸出中,更進(jìn)一步降低了其用于任何其它目的的價(jià)值
l JSR 175,Java編程語(yǔ)言的元數據工具,為將元數據合并到核心 Java 語(yǔ)言中提供了正式理由和說(shuō)明
l Tiger 增加了Annotation的新功能,將一個(gè)更通用的元數據工具合并到核心 Java 語(yǔ)言中
l Annotation是可以添加到代碼中的修飾符,可以用于包聲明、類(lèi)型聲明、構造函數、方法、域變量、參數和變量
l Tiger包含內置的Annotation,還支持自己編寫(xiě)的定制Annotation
l 本部分將概述元數據的優(yōu)點(diǎn),并介紹Tiger的內置Annotation
2、元數據的價(jià)值
一般來(lái)說(shuō),元數據的好處分為三類(lèi):文檔編制、編譯器檢查和代碼分析
(1)文檔編制
l 代碼級文檔最常被引用,但對于將元數據添加到 Java 語(yǔ)言中來(lái)說(shuō),文檔編制可能是最不相關(guān)的理由
l 因為Javadoc已經(jīng)提供了非常容易理解和健壯的方法來(lái)文檔化代碼
(2)編譯時(shí)檢查
l 元數據更重要的優(yōu)點(diǎn)是編譯器可以使用它來(lái)執行基本的編譯時(shí)檢查
l 具體情況請參看后面介紹的Tiger內置Annotation:@Override
(3)代碼分析
l 元數據工具的最好功能就是可以使用額外數據來(lái)分析代碼
l 簡(jiǎn)單的案例就是:許多時(shí)候,方法的參數類(lèi)型或返回類(lèi)型實(shí)際上不是該方法想要的類(lèi)型;例如,參數類(lèi)型可能是Object,但方法可能僅使用Integer,這在覆蓋超類(lèi)的方法時(shí)很容易發(fā)生;元數據可以指示代碼分析工具:雖然參數類(lèi)型是 Object,但 Integer 才是真正需要的
l 復雜的案例就是:即使是簡(jiǎn)單EJB系統中也具有很強的依賴(lài)性和復雜性,要具有 Home和Remote接口,以及本地的Home 和Remote接口,以及一個(gè)實(shí)現類(lèi),保持所有這些類(lèi)同步非常困難;好的工具(如XDoclet)可以管理所有這些依賴(lài)性,并確保這些沒(méi)有“代碼級”聯(lián)系,但有“邏輯級”聯(lián)系的類(lèi)保持同步;元數據在這里確實(shí)可以發(fā)揮它的作用
3、Annotation基礎
l Annotation的格式是:@Annotation名
l 在Annotation需要數據時(shí),通過(guò)name=value的形式提供
l 代碼中可以用很多Annotation,有些Annotation會(huì )具有相同的Annotation類(lèi)型
l Annotation類(lèi)型和Annotation的概念類(lèi)似于類(lèi)和對象的概念
l Annotation有三種基本種類(lèi):
Ø 標記Annotation:只有Annotation名,不包含數據,如@MarkerAnnotation
Ø 單值Annotation:只有單一的數據,可以簡(jiǎn)化name=value的形式為value形式,如@SingleValueAnnotation("my data")
Ø 完整格式的Annotation:有多個(gè)數據成員,如@FullAnnotation(var1="data value 1", var2="data value 2", var3="data value 3")
l 可以使用花括號向Annotation變量提供值數組,如
@TODOItems({ // Curly braces indicate an array of values is being supplied @TODO( severity=TODO.CRITICAL, item="Add functionality to calculate the mean of the student‘s grades", assignedTo="Brett McLaughlin" ), @TODO( severity=TODO.IMPOTANT, item="Print usage message to screen if no command-line flags specified", assignedTo="Brett McLaughlin" ), @TODO( severity=TODO.LOW, item="Roll a new website page with this class‘s new features", assignedTo="Jason Hunter" )})
4、Tiger內置Annotation
(1)@Override
l @Override只用于方法,指明改方法覆蓋超類(lèi)中的對應方法
l 簡(jiǎn)單例子:
public class OverrideTester { public OverrideTester() { } @Override public String toString() {
return super.toString() + " [Override Tester Implementation]"; } @Override public int hashCode() {
return toString().hashCode(); }}l @Override可以檢查輸入錯誤導致無(wú)法覆蓋超類(lèi)方法的問(wèn)題,例如hashCode()錯誤的輸入為hasCode(),在編譯時(shí)就會(huì )報錯:
The method hasCode() of type OverrideTester must override a superclass methodl 這個(gè)便捷的小功能將幫助快速捕獲打字錯誤
(2)@Deprecated
l 同樣只用于方法,指明該方法不應該再使用了
l 簡(jiǎn)單例子:
public class DeprecatedClass { @Deprecated public void doSomething() {
System.out.println("Deprecated method!"); // some code } public void doSomethingElse() { // This method presumably does what doSomething() does, but better }}l 單獨編譯正常通過(guò),如果通過(guò)覆蓋或調用Deprecated的方法,編譯器會(huì )給出警告信息
l 注:本人在Eclipse 3.1M4環(huán)境中測試,根本不起作用(即使是改了編譯參數,why?),在命令行下使用-Xlint:deprecated參數,JAVAC只給出警告信息,編譯還是通過(guò)的
(3)@SuppressWarnings
l Tiger的泛型功能使得編譯器對類(lèi)型的安全性進(jìn)行檢查,特別是Java集合,如下面的例子:
public void nonGenericsMethod() { List wordList = new ArrayList(); // no typing information on the ListwordList.add("foo"); // causes error on list addition
}l 編譯器會(huì )給出下面的警告信息:
Type safety: The method add(Object) belongs to the raw type List. References to generic type List<E> should be parameterizedl 這對于Tiger的代碼是很有幫助的,但對于JDK1.4及以前版本,不斷的收到無(wú)關(guān)的警告信息是很煩人的
l 可以使用@SuppressWarnings來(lái)阻止指定類(lèi)型的警告信息,如:
@SuppressWarnings(value = { "unchecked" }) public void nonGenericsMethod() { List wordList = new ArrayList(); // no typing information on the List wordList.add("foo"); // causes error on list addition }l 傳遞給@SuppressWarnings的類(lèi)型值是一個(gè)數組,因此可以同時(shí)阻止多種類(lèi)型的警告信息
l 類(lèi)型值是由編譯器廠(chǎng)商所指定的,所以上面的例子我在Eclipse 3.1M4環(huán)境和命令行中測試,都不起作用,大概是類(lèi)型值沒(méi)有指定對吧
聯(lián)系客服