App下載

帶你深入了解Java中的注解以及常用注解的使用

酒鞭名馬 2021-08-17 11:55:05 瀏覽數(shù) (1860)
反饋

一、注解是什么

Java 注解用于為 Java 代碼提供元數(shù)據(jù),看完這句話也許你還是一臉懵逼,用人話說就是注解不直接影響你的代碼執(zhí)行,僅提供信息。接下我將從注解的定義、元注解、注解屬性、自定義注解、注解解析JDK 提供的注解這幾個方面再次了解注解(Annotation)

二、jdk支持的注解有哪些

2.1 三種常用的注解:

@SuppressWarnings     該注解的作用是阻止編譯器發(fā)出某些警告信息。它可以有以下參數(shù):  

deprecation :過時的類或方法警告。    
unchecked:執(zhí)行了未檢查的轉(zhuǎn)換時警告?!   ?allthrough:當Switch程序塊直接通往下一種情況而沒有Break時的警告。    
path:在類路徑、源文件路徑等中有不存在的路徑時的警告?!   ?nbsp;   
serial:當在可序列化的類上缺少serialVersionUID定義時的警告?!?nbsp;   
finally:任何finally子句不能完成時的警告?!  ?nbsp;   
all:關于以上所有情況的警告

@Deprecated       該注解的作用是標記某個過時的類或方法。

@Override     該注解用在方法前面,用來標識該方法是重寫父類的某個方法。

2.2 元注解

元注解主要是用來注解自定義注解的注解,分別有@Retention、 @Target、 @Document、 @Inherited和@Repeatable(JDK1.8加入)五種。

下面講兩個平常最常用的注解:

@Retention 注解的生命周期,主要有

RetentionPolicy.SOURCE 僅存在于源碼中
 
RetentionPolicy.CLASS 默認的策略,在class字節(jié)碼文件中存在,但運行時無法獲得
 
RetentionPolicy.RUNTIME 在運行時可以通過反射獲取到,也是最常用的。

@Target 注解的作用目標,主要有

 ElementType.TYPE  作用接口、類、枚舉、注解
 
 ElementType.FIELD 作用屬性字段、枚舉的常量
 
 ElementType.METHOD 作用方法
 
 ElementType.PARAMETER 作用方法參數(shù)
 
 ElementType.CONSTRUCTOR 作用構(gòu)造函數(shù)
 
 ElementType.LOCAL_VARIABLE 作用局部變量
 
 ElementType.ANNOTATION_TYPE 作用于注解(@Retention注解中就使用該屬性)
 
 ElementType.PACKAGE 作用于包
 
 ElementType.TYPE_PARAMETER 作用于類型泛型,即泛型方法、泛型類、泛型接口 (jdk1.8加入)

三、注解實例

在枚舉中編譯器只會限制枚舉的名字不能重復,在開發(fā)中經(jīng)常會遇到枚舉Id 重復的問題,因為每個人在開發(fā)功能的時候一般只會專注于自己的功能,做完只會直接提交代碼,不會注意到枚舉Id沖突,這個時候可以使用下面的代碼進行枚舉自檢,在項目的開發(fā)階段就能及時發(fā)現(xiàn)代碼的問題。下面的代碼稍微修改下就可以在項目中使用,拿走不寫。

1、自定義注解

檢測枚舉的key 是否有重復

package org.pdool.anno;
 
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
/**
* @author 香菜
*/
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface CheckEnum {
}

2、在對應的方法上增加注解

package org.pdool.anno;
/**
* 資源枚舉類
* @author 香菜
*/
public enum ResType {
   GOLD(1),
   DIAMOND(2),
   //注意:此處重復
   SILVER(2);
   int type;
 
   @CheckEnum
   public int getType() {
       return type;
  }
 
   ResType(int type) {
       this.type = type;
  }
}

3、在項目啟動的時候檢查注解的枚舉

package org.pdool.anno;
 
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import java.util.HashSet;
import java.util.Set;
 
/**
* @author 香菜
*/
public class Aain {
   public static void main(String[] args) throws InvocationTargetException,IllegalAccessException {
       // 獲取有注解的方法
       Method[] declaredMethods = ResType.class.getDeclaredMethods();
       Method annoMethod = null;
       for (Method declaredMethod : declaredMethods) {
           CheckEnum  annotation = declaredMethod.getAnnotation(CheckEnum.class);
           if (annotation != null){
               annoMethod = declaredMethod;
              break;
          }
      }
       Set<Object> set = new HashSet<>();
       // 遍歷每個枚舉的id
       Object[] oo = ResType.class.getEnumConstants();
       for (Object o : oo) {
           Object invoke = annoMethod.invoke(o);
           if (!set.contains(invoke)){
               set.add(invoke);
          }else {
               System.out.println("重復的key "+ o +" -- "+ invoke);
          }
      }
  }
}

2021050714471269

注:上面的代碼只是簡單的實例,只是為了展示核心代碼,在項目中使用時可以修改類的獲取為掃描項目下的包,遍歷所有的枚舉,就可以在項目中使用了。

四、總結(jié)

注解雖然不影響代碼的運行,但是可以為運行中的程序提供更多的信息,注解也是很多框架的基本技術切入點,比如Spring 的注解,Lombok 的各種注解,都是使用了注解做了很多事,明白了注解是怎么回事,理解框架也會輕而易舉。

關于Java注解的內(nèi)容以及使用方法的文章就介紹到此結(jié)束了,如果您覺得本篇文章還不錯,對學習或是工作由所幫助,還希望大家能夠多多支持W3Cschool!


0 人點贊