基本特性

1、jdk 1.5之后才引入的。

2、用來(lái)說(shuō)明程序的。(注釋是給程序員看的，注解就是給電腦看的)

java注解的作用分類

1、編寫(xiě)文檔：通過(guò)代碼標(biāo)識(shí)的注解生成文檔?！旧蒬oc文檔】

2、代碼分析：通過(guò)代碼標(biāo)識(shí)的注解對(duì)代碼進(jìn)行分析?！臼褂梅瓷洹?/p>

3、編譯檢查：通過(guò)代碼標(biāo)識(shí)的注解讓編譯器能夠?qū)崿F(xiàn)基本的編譯檢查?！緊verride】

測(cè)試類：

/**
 * 我的javadoc測(cè)試
 */
public class TestCode {
  /**
   * 計(jì)算兩個(gè)數(shù)的和
   * @param a 整數(shù)a
   * @param b 整數(shù)b
   * @return 返回兩個(gè)數(shù)的和
   */
  public int add(int a, int b){
    return a+b;
  }
}

對(duì)于2、3兩點(diǎn)我們應(yīng)該是知道的。盡管可能不知道里面的原理。但是是平時(shí)都在用的。但是對(duì)于1點(diǎn)還可以生成doc文檔？

測(cè)試操作如下：

D:\soft\jdk\bin\javadoc.exe .\TestCode.java -encoding utf-8 -docEncoding utf-8 -charset utf-8

生成了一大堆的東西：

打開(kāi)TestCode.html可以發(fā)現(xiàn)，我們的java api手冊(cè)就是這樣生產(chǎn)的。

注解來(lái)源分類

1、jdk自帶的注解,如常見(jiàn)的override(重寫(xiě)校驗(yàn))，deprecated（表示棄用）

2、自定義的注解

1）格式, 以override為例：

2）注解的本質(zhì)

我們編寫(xiě)一個(gè)簡(jiǎn)單的注解

MyAnnotation.java

public @interface MyAnnotation {}

我們通過(guò)編譯和反編譯看下最終是什么樣的結(jié)果：

D:\soft\jdk\bin\javac.exe MyAnnotation.java

D:\soft\jdk\bin\javap.exe MyAnnotation.class

結(jié)果如下：

public interface MyAnnotation extends java.lang.annotation.Annotation {

}

可以發(fā)現(xiàn)注解的本質(zhì)就是接口，這個(gè)接口繼承了jdk里面的Annotation接口。

3）注解的屬性

由于注解本質(zhì)為接口，那么里面可以定義未實(shí)現(xiàn)的方法。這些稱為注解的“屬性”。

屬性的返回類型有（返回值不能為void）：

• 基本數(shù)據(jù)類型
• String
• 枚舉
• 注解
• 以及以上四種類型的數(shù)組

例子：

public enum Person {
  PS;
}
public @interface Annotation2 {
}
public @interface MyAnnotation {
  String stringValue();
  int integerValue();
  Person personValue();
  Annotation2 myAnnotationValue();
  String[] stringArrayValue();
}

屬性的使用，需要注意幾點(diǎn)：

• 定義了屬性在使用的時(shí)候就要給屬性賦值，除非設(shè)置default值。如：String stringValue() default "aaa";
• 如果屬性為value且屬性只有這一個(gè)，那么value可以省略，直接填寫(xiě)屬性值。
• 如果是數(shù)組，需要用{}包含起來(lái)。

public @interface MyAnnotation {
  String stringValue() default "xxx";
  int integerValue();
  String[] stringArrayValue();
}

public @interface Annotation2 {
  String value();
}

@MyAnnotation(integerValue = 1, stringArrayValue = {"aaa", "bbb"})
@Annotation2("default")
public class TestCode {
  /**
   * 計(jì)算兩個(gè)數(shù)的和
   * @param a 整數(shù)a
   * @param b 整數(shù)b
   * @return 返回兩個(gè)數(shù)的和
   */
  public int add(int a, int b){
    return a+b;
  }

  @Override
  public String toString() {
    return super.toString();
  }
}

元注解

元注解是你在編寫(xiě)注解的時(shí)候，上面加的注解，就是注解的注解。主要有4個(gè)。

• @target, 用于指定注解的使用位置。如@Target(ElementType.ANNOTATION_TYPE)，@Target(value = {ElementType.TYPE, ElementType.FIELD, ElementType.METHOD})。
• @Inherited，表示父類加了這個(gè)注解，子類也自動(dòng)加上。
• @Documented, 表示這個(gè)注解的信息在執(zhí)行javadoc的時(shí)候是否抽取到api文檔中。
• @Retention，表示注解被保留的階段，java類，class文件，以及被jvm讀取。總共三種。RetentionPolicy.SOURCE, RetentionPolicy.CLASS, RetentionPolicy.RUNTIME
  

元注解的內(nèi)容，可以到j(luò)dk源碼里面看一下，更有利于理解。

解析注解

這個(gè)是最關(guān)鍵了，以上加了這么多的屬性，并且還為這些屬性附了值，那么是希望程序讀取這些值，進(jìn)行使用的。那其實(shí)就是要看如何拿到這些注解配置的值。

測(cè)試：

MyAnnotition.java:

package annotation_;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
  String stringValue() default "xxx";
  int integerValue();
}

TestCode.java:

package annotation_;
@MyAnnotation(integerValue = 1)
public class TestCode {
  public static void main(String[] args) {
    Class<TestCode> testCodeClass = TestCode.class;
    MyAnnotation myAnnotation = testCodeClass.getAnnotation(MyAnnotation.class);
    int i = myAnnotation.integerValue();
    String s = myAnnotation.stringValue();
    System.out.printf("i = %d, s = %s\n", i, s);
  }
}

輸出結(jié)果：

Connected to the target VM, address: '127.0.0.1:49586', transport: 'socket'
i = 1, s = xxx
Disconnected from the target VM, address: '127.0.0.1:49586', transport: 'socket'

Process finished with exit code 0

是不是感覺(jué)可以當(dāng)配置文件使用。但是最主要的問(wèn)題是myAnnotation.integerValue()，myAnnotation.stringValue()為什么可以拿到對(duì)應(yīng)的值，這個(gè)也是最核心的問(wèn)題。

那就是getAnnotation里面返回了一個(gè)實(shí)現(xiàn)了MyAnnotation注解(注解的本質(zhì)是接口)的實(shí)例。這個(gè)類大概是長(zhǎng)這樣的。

package annotation_;

import java.lang.annotation.Annotation;

public class MyAnnotationImpl implements MyAnnotation{
  public String stringValue() {
    return "xxx";
  }
  public int integerValue() {
    return 0;
  }
  public Class<? extends Annotation> annotationType() {
    return null;
  }
}

所以就可以通過(guò)抽象方法獲取到對(duì)應(yīng)的值。(如何生成這樣的一個(gè)類，只是學(xué)習(xí)注解，可以不關(guān)心。要不然，只能看里面的源碼。因?yàn)槿绻远x注解，你只會(huì)用到這一步，去獲取值。)

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評(píng)論