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