快捷導(dǎo)航

深入Java注解原理Annotation

更新時間：2023年10月02日 10:15:52 作者：JackeyJobs

這篇文章主要介紹了深入Java注解原理Annotation,注解可以附加在package,class,method,field等上面,可相當于添加了額外的輔助信息,可以通過反射機制編程實現(xiàn)對這些元數(shù)據(jù)的訪問,需要的朋友可以參考下

Annotation注解

jdk1.5開始引入的新技術(shù)
作用：不是程序本身，可以對程序作出解釋，可以被其他程序讀取，如編譯器
格式："@注釋名"，可以添加參數(shù)值
例如@SuppressWarnings(value=“unchecked”)
使用：可以附加在package，class，method，field等上面，可相當于添加了額外的輔助信息，可以通過反射機制編程實現(xiàn)對這些元數(shù)據(jù)的訪問

內(nèi)置注解

@Override：定義在java.lang.Override中，只適用于修辭方法，表示一個方法聲明打算重寫超類中的另一個方法聲明
@Deprecated：定義在java.lang.Deprecated中，可用于修辭方法，屬性，類，不鼓勵使用，因為它很危險或存在更好的選擇
@SuppressWarnings：定義在java.lang.SuppressWarnings中，用來抑制編譯時的警告信息，選擇使用
@SuppressWarnings（“all”）
@SuppressWarnings（“unchecked”）
@SuppressWarnings（"value={“unchecked”,“deprecation”}）
等等…

元注解

作用：負責注解其他注解，java定義了4個標準的meta-annotation類型，被用來提供對其他annotation類型作說明，這些類型和他們所支持的類在java.lang.annotation包中可以找到（@Target，@Retention，
@Documented，@Inherited）
@Target：用于描述注解的使用范圍（即：可以用在什么地方）
@Retention：表示需要在什么級別保存該注釋信息，用于描述注解的生命周期
（SOURCE < CLASS < RUNTIME）
@Document：說明該注解將被包含在javadoc中
@Inherited：說明子類可以繼承父類中的該注解

import java.lang.annotation.*;
/**
 * @Description: 測試元注解
 */
public class Test02 {
    @MyAnnotation
    public void test(){
    }
}
//定義一個注解
//Target:表示我們的注解可以用在哪些地方
@Target(value = {ElementType.METHOD,ElementType.TYPE})
//Retention:表示我們的注解在什么地方還有效
//RUNTIME>CLASS>SOURCE
@Retention(value = RetentionPolicy.RUNTIME)
//Documented:表示是否將我們的注解生成在javadoc中
@Documented
//Inherited:子類可以繼承父類的注解
@Inherited
@interface MyAnnotation{
}

自定義注解

使用 **@interface **自定義注解時，自動繼承了java.lang.annotation.Annotation接口
分析
@interface 用來聲明一個注解，格式：public @interface 注解名{定義內(nèi)容}
其中的每一個方法實際上是聲明了一個配置參數(shù)
方法的名稱就是參數(shù)的名稱
返回值類型就是參數(shù)的類型（返回值只能是基本類型，Class，String，enum）
可以通過default來聲明參數(shù)的默認值
如果只有一個參數(shù)成員，一般參數(shù)名為value
注解元素必須要有值，我們定義注解元素時，經(jīng)常用空字符串，0作為默認值

import java.lang.annotation.*;
/**
 * @Description: 自定義注解
 */
public class Test03 {
    //注解可以顯示賦值，如果沒有默認值，就必須賦值
    @MyAnnotation2(name = "Java",schools = {"bilibili"})
    public void test(){}
    //只有一個值，并且為value時才可以省略
    @MyAnnotation3("")
    public void test2(){}
}
@Target(value = {ElementType.TYPE,ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation2{
    //注解的參數(shù)：參數(shù)類型 + 參數(shù)名 ();
    String name();
    int age() default 0; //設(shè)置默認值
    int id() default -1; //默認值為-1，代表不存在
    String[] schools();
}
@Target(value = {ElementType.TYPE,ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation3{
    String value();
}