Java注解

Java注解是什麼？

在Java中的注解允許將元數據與程式元素相關聯。
程式元素可以是包，類，介面，類的字段，局部變數，方法，方法的參數，枚舉，注解，通用類型/方法聲明中的類型參數等等。

可以在Java程式中注解任何聲明或類型。注解在任何其他修飾符(public，private，final，static等)的程式元素的聲明中用作修飾符。與修飾符不同，注解不會修改程式元素的含義。它是程式元素的注解。

聲明注解類型

聲明注解類型類似於聲明介面類型。注解類型是一種特殊類型的介面類型。使用前面帶有@符號的interface關鍵字來聲明注解類型(注意與聲明介面的區別)。
以下是聲明注解類型的一般語法：

<modifiers> @interface <annotation-type-name>  {
    // Annotation type body
}

注解聲明的<modifiers>修辭符與介面聲明的相同。可以將注解類型聲明為public或package級別。@符號與interface關鍵字之間可以用空格分隔，也可以連接在一起。按照慣例，它們一般是連接放在一起，如：@interface。interface關鍵字後面是注解類型名稱。 它應該是有效的Java識別字。

注解類型正文放在大括弧中。以下代碼創建注解以使用版本資訊注解程式元素。

public  @interface  Version {
    int  major();
    int  minor();
}

在上面代碼中的Version注解類型中聲明了兩個抽象方法：major()和minor()。注解類型中的抽象方法稱為元素。注解可以聲明零個或多個元素，它們被聲明為抽象方法。抽象方法名稱是注解類型的元素的名稱。
在上面的代碼中，Version注解類型聲明了兩個元素：major和minor。 兩個元素的數據類型都是int。

如果要導入一個注解類型，那麼它應該就像導入任何其他類型一樣。

注解實例

要創建注解類型的實例並使用它來注解程式元素，使用以下語法：

@annotationType(name1=value1,  name2=value2, names3=values3...)

注解類型前面帶有一個@符號，後面是用括弧括起來的逗號分隔的name = value對列表。name = value對中的名稱是在注解類型中聲明的元素的名稱和值，它由用戶提供。name = value對不必按照在注釋類型中聲明的順序出現。
以下代碼使用Version類型的注解，主要元素值設置為1(major=1)，次要元素值設置為0(minor=0)。

@Version(major=1, minor=0)

也可以使用注釋類型的完全限定名，如下代碼 -

@com.java2s.annotation.Version(major=0,  minor=1)

可以將類聲明注釋為 -

@Version(major=1, minor=0)
public  class  VersionTest {

}

可以將程式元素的注釋與其他修飾符混合使用。

@Version(major=1, minor=0)  public  class  VersionTest {
}

public  @Version(major=1, minor=0)  class  VersionTest {
}

完整的源代碼

@interface Version {
  int major();

  int minor();
}

@Version(major = 1, minor = 0)
public class Main {
  @Version(major = 1, minor = 1)
  private int xyz = 110;

  @Version(major = 1, minor = 0)
  public Main() {
  }

  @Version(major = 1, minor = 1)
  public Main(int xyz) {
    this.xyz = xyz;
  }

  @Version(major = 1, minor = 0)
  public void printData() {
  }

  @Version(major = 1, minor = 1)
  public void setXyz(int xyz) {

    @Version(major = 1, minor = 2)
    int newValue = xyz;

    this.xyz = xyz;
  }
}