java基礎之註解示例詳解

Posted on by

定義

註解也叫原數據，它是JDK1.5及之後版本引入的一個特性，它可以聲明在類、方法、變量等前面，用來對這些元素進行說明。

作用

生成文檔：通過代碼裡標識的註解生成doc文檔【生成doc文檔】

代碼分析：通過代碼裡標識的註解對代碼進行分析【反射】

編譯檢查：通過代碼裡標識的註解讓編譯器能夠實現基本的編譯檢查【Override】

註解與註釋的區別

註解是給編譯器看的，註釋是給程序員看的。

JDK內置的標準註解

@Override

表示該方法是覆蓋父類的，如果某個方法父類中並沒有，且該方法使用瞭@Override，則會報錯

@Deprecated

表示該方法已經過時，但還是可以用

@SuppressWarnings

壓制警告

一般用在類的前面，傳遞參數”all”，表示壓制該類的所有警告

這是父類代碼

public class Fu {
    public void eat(){
        System.out.println("Fu 吃......");
    }
}

這是子類代碼

@SuppressWarnings("all")//壓制該類下的所有警告
public class Zi extends Fu{

    @Override			//表示該方法是重寫父類的
    public void eat(){
        System.out.println("Zi eat......");
    }
    @Deprecated			//表示該方法已經過時
    public void work(){				

    }
}

下面是主類

在這裡插入圖片描述

自定義註解

格式：

​ 元註解

​ public @interface 註解名稱{

​ 屬性列表

​ }

註解本質其實上是一個接口，該接口默認繼承Annotation接口

public interface 註解名稱extends java.lang.annotation.Annotation {}

元註解

註解的註解就是元註解

下面是@Override註解的源碼，我們可以看到在@Override的前面還有一些註解，下面我們來介紹一下這些註解

在這裡插入圖片描述

我們需要掌握5種元註解：

@Target

指明瞭註解可以在哪裡使用

參數ElementType取值

​ TYPE：指明註解可以使用在類上

​ METHOD：指明註解可以使用在方法上

​ FIELD：指明註解可以使用在成員變量上

@Target({ElementType.TYPE, ElementType.FIELD, ElementType.METHOD})	//當{}裡面的內容隻有一個時，{}可以省略
public @interface PersonWrite {
        int age();
        String name() default "22";
}

@Retention（）

指明註解被保留的階段:

註解保留到源代碼階段

@Retention(RetentionPolicy.SOURCE)

註解保留到編譯階段

@Retention(RetentionPolicy.CLASS)

註解1保留到運行階段

@Retention(RetentionPolicy.RUNTIME)

@Documented

標識註解被抽取到doc文檔中

@Inherited

標識註解被子類繼承

屬性

註解中的屬性其實是抽象方法

屬性的返回類型隻能是下面幾種類型：

基本數據類型

String

枚舉

註解

以上類型的數組

如果註解裡面定義瞭屬性（接口），在使用時要給屬性賦值

如果定義屬性時使用default給屬性賦值，則在使用註解時可以不給該屬性賦值（當然也可以重新賦值）如果註解隻有一個，且註解的名稱是value，則使用時傳參直接寫參數即可，不用寫屬性名數組賦值時，使用{}包裹，如果數組中隻有一個值，則{}可以省略

下面是自定義的註解：

@Target({ElementType.TYPE, ElementType.FIELD, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
public @interface PersonWrite {
        int age();
        String name() default "李四";
}

下面是該註解的使用：

package Java高級特性.註解;

@PersonWrite(age = 222)
public class Main {

    public static void main(String[] args) {
        Zi zi = new Zi();
        zi.work();
    }
}

到此這篇關於java基礎之註解示例詳解的文章就介紹到這瞭,更多相關java註解內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet！

推薦閱讀：