元數據從metadata一詞譯來，就是“關於數據的數據”的意思。越來越的開源框架都提供了“元數據”支持了，其實也就是注釋支持。今天系統學習一下Java注釋（Java元數據）。本文內容不限於Javadoc的注釋。
1.什麼是Java元數據，有什麼作用？
元數據，就是“關於數據的數據”。功能也有很多啦。你可能用過Javadoc的注釋自動生成文檔。這就是元數據功能的一種。總的來說，元數據可以用來創建文檔，跟蹤代碼的依賴性，執行編譯時格式檢查，代替已有的配置文件（如Hibernate也提供了注釋配置）
注釋有3中基本類型
a.標記注釋 --沒有變量，只有名稱標識。例如 @annotation
b.單一值注釋 --在標記注釋的基礎上提供一段數據。如 @annotation（“data”）
c.完整注釋 --可以包括多個數據成員，每個數據成員由名稱和值構成。
@annotation(val1="data1",val2="data2")
2.Java的“注釋”
Java中提供3個內置注釋類型
a. Override ，只能用於方法（不能用於類，包聲明或者其他構造）
作用：可以保證編譯時候Override函數的聲明正確性
用法：@Override
public void fun(){..}
b.Deprecated 同樣只能作用與方法
作用：對不應再使用的方法進行注解
用法：@Deprecated public void fun{...} //它們說這個注釋跟函數要同一行
c.SupressWarnings 可以注釋一段代碼
作用：關閉特定的警告信息，例如你在使用泛型的時候未指定類型
用法： @SupressWarnings(value={"unchecked"})
..代碼
Java中還提供了四種元注釋，專門負責注釋其他的注釋
@Target 表示該注釋可以用於什麼地方。可用的ElementType參數包括：
CONSTRUCTOR : 構造器的聲明
FIELD : 域聲明（包括enum實例）
LOCAL_VARIABLE : 局部變量聲明
METHOD : 方法聲明
PACKAGE : 包聲明
PARAMETER : 參數聲明
TYPE : 類、接口 （包括注解類型) 或enum聲明
@Retention 表示需要在什麼級別保存該注釋信息。可選的RetentionPoicy參數包括：
SOURCE : 注釋將被編譯器丟掉
CLASS : 注釋在class文件中可用，但會被VM丟棄
RUNTIME : VM將在運行時也保留注釋，因此可以通過反射機制讀取注釋的信息。
@Documented 將注釋包含在JavaDoc中
@Inheried 允許子類繼承父類中的注釋。
3. 在Java中定義自己的注釋
Java語言支持一種新的類型——注釋類型（annotation type），跟普通類差不多，在類中以符號（ @ ）的形式注釋其他 Java 代碼
下面將通過一個簡單的例子來實現（代碼是Brett McLaughlin 的）
@interface 申明
i.簡單的注釋類型
package com.oreilly.tiger.ch06;
/**
* Marker annotation to indicate that a method or class
* is still in progress.
*/
public @interface InProgress { }
ii.使用定制的注釋類型
@com.oreilly.tiger.ch06.InProgress
public void calculateInterest(float amout,float rate)
{
//Need to finish this method later
}
iii.添加成員
package com.oreilly.tiger.ch06;
/**
* Marker annotation to indicate that a method or class
* is still in progress.
*/
public @interface InProgress {
String value();
}
@com.oreilly.tiger.ch06.InProgress
@TODO("Figure out the amount of interest per month")
//或者@TODO(value="Figure out the amount of interest per month")
public void calculateInterest(float amount,float rate)
{
}
iv.設置默認值
package com.oreilly.tiger.ch06;
public @interface GroupTODO {
public enum Serverity { CRITICAL,IMPORTANT,IRIVIAL,DOCMENTATION };
Severity severity()
default Severity.IMPORTANT;
String item ();
String assignedTo();
String dateAssigned();
}
}
v.使用默認值
@com.oreilly.tiger.ch06.InProgress
@GroupTODO(
item="Figure out the amount of interest per month",
assignedTo = "Brett McLaughlin",
dateAssigned = "08/04/2004"
)
public void calculateInterest(float amount, float rate)
{
//Need to finish this method later
}
vi.改寫默認值
@com.oreilly.tiger.ch06.InProgress
@GroupTODO
{
severity = GroupTODO.Severity.DOCUMENTATION,
item = "Need to explain how this rather unusal method works",
assignedTo = "Jon Stevens",
dateAssigned = "07/30/2004"
}
這樣就對Java元數據/Java注釋進行了總結。
