輕松掌握Java注解，讓編程更智能、更優(yōu)雅

更新時間：2024年01月03日 08:31:27 作者：Java備忘錄

輕松掌握Java注解？沒問題！想要讓你的Java代碼更具可讀性、維護性,同時提升開發(fā)效率？本指南將帶你快速入門Java注解的世界,只需短短幾分鐘,你就能揭秘這個強大的編程工具,讓編寫有聲明性邏輯的代碼變得輕而易舉,趕快一起來探索吧！

一、什么是注解

定義：注解（Annotation），也叫元數據。一種代碼級別的說明。

它是JDK1.5及以后版本引入的一個特性，與類、接口、枚舉是在同一個層次。

它可以聲明在包、類、字段、方法、局部變量、方法參數等的前面，用來對這些元素進行說明，注釋。

二、內置注解

@Override： 標記在成員方法上，用于標識當前方法是重寫父類（父接口）方法，編譯器在對該方法進行編譯時會檢查是否符合重寫規(guī)則，如果不符合，編譯報錯。
@Deprecated： 用于標記當前類、成員變量、成員方法或者構造方法過時如果開發(fā)者調用了被標記為過時的方法，編譯器在編譯期進行警告。
@SuppressWarnings： 壓制警告注解，可放置在類和方法上，該注解的作用是阻止編譯器發(fā)出某些警告信息。

三、元注解

元注解即注解的注解。

在jdk的中java.lang.annotation包中定義了四個元注解。

@Target

指定被修飾的注解的作用范圍，如果不寫默認是任何地方都可以使用。

可選的參數值在枚舉類ElemenetType中包括：

TYPE： 用在類,接口上
FIELD：用在成員變量上
METHOD： 用在方法上
PARAMETER：用在參數上
CONSTRUCTOR：用在構造方法上
LOCAL_VARIABLE：用在局部變量上

@Retention

指定了被修飾的注解的生命周期。

可選的參數值在枚舉類型RetentionPolicy中包括:

SOURCE：注解只存在于Java源代碼中，編譯生成的字節(jié)碼文件中就不存在了。
CLASS：注解存在于Java源代碼、編譯以后的字節(jié)碼文件中，運行的時候內存中沒有，默認值。
RUNTIME：注解存在于Java源代碼中、編譯以后的字節(jié)碼文件中、運行時內存中，程序可以通過反射獲取該注解。

正常開發(fā)中我們自定義注解的時候無腦用 Runtime 就可以了。

@Documented

指定了被修飾的注解是可以Javadoc等工具文檔化。

@Inherited

指定了被修飾的注解修飾程序元素的時候是可以被子類繼承的。

四、自定義注解

定義格式

元注解
public @interface 注解名稱{
	屬性列表;
}

注解的屬性

格式1：數據類型屬性名();
格式2：數據類型屬性名() default 默認值;

示例如下：

public @interface Student {
  String name(); 
  int age() default 18; 
  String gender() default "男"; 
}

注意：沒有默認值的屬性是必填的，當屬性只有一個，且屬性名為 value 時，可以省略。

示例：

public class Test {
    @Student("zhangsan")
    public void test(){

    }
}
public @interface Student {
  String value(); 
}

反射解析注解

反射請移步：Java反射，看完就會用

如果反射懂了，注解懂了，那就不需要過多解釋直接看示例就行了。

自定義注解 Book

@Target({ElementType.METHOD,ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
public @interface Book {
    // 書名
    String value();
    // 價格
    double price() default 100;
    // 作者
    String[] authors();
}

BookStore類

@Book(value = "紅樓夢",authors = "曹雪芹",price = 998)
public class BookStore {
}

TestAnnotation類

public class TestAnnotation {
    public static void main(String[] args)  throws Exception{
        System.out.println("---------獲取類上注解的數據----------");
        test();
    }

    /**
     * 獲取BookStore類上使用的Book注解數據
     */
    public static void test(){
        // 獲得BookStore類對應的Class對象
        Class c = BookStore.class;
        // 判斷BookStore類是否使用了Book注解
        if(c.isAnnotationPresent(Book.class)) {
            // 根據注解Class對象獲取注解對象
            Book book = (Book) c.getAnnotation(Book.class);
            // 輸出book注解屬性值
            System.out.println("書名：" + book.value());
            System.out.println("價格：" + book.price());
            System.out.println("作者：" + Arrays.toString(book.authors()));
        }
    }
}

到此這篇關于輕松掌握Java注解，讓編程更智能、更優(yōu)雅的文章就介紹到這了,更多相關Java注解內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: