自学笔记 (一)-- 注解 Annotation

注解

前言 : 工作一年左右回顾之前发现好多基础知识学习的还是不够扎实,今天起开始每周的自学任务,并记录之。这篇笔记即是自学笔记,也可供大家翻阅查看。

什么是注解?
Java 注解(Annotation)又称 Java 标注,是 JDK5.0 引入的一种注释机制。
Java 语言中的类、方法、变量、参数和包等都可以被标注。和 Javadoc 不同,Java 标注可以通过反射获取标注内容。在编译器生成类文件时,标注可以被嵌入到字节码中。Java 虚拟机可以保留标注内容,在运行时可以获取到标注内容 。 当然它也支持自定义 Java 标注。

注解分类:
内置注解、元注解、自定义注解

注解详解

Java 定义了一套注解,共有 7 个,3 个在 java.lang 中,剩下 4 个在 java.lang.annotation 中。

内置注解:

作用在代码的注解是

@Override - 检查该方法是否是重写方法。如果发现其父类,或者是引用的接口中并没有该方法时,会报编译错误。
@Deprecated - 标记过时方法。如果使用该方法,会报编译警告。(被标注的方法将不推荐使用,展示为 test();
@SuppressWarnings - 指示编译器去忽略注解中声明的警告。(压制警告)

元注解:
作用在其他注解的注解(或者说 元注解)是:

@Retention - 标识这个注解怎么保存,是只在代码中,还是编入class文件中,或者是在运行时可以通过反射访问。(表示当前注解在什么情况下存在,分为 source(源代码)<class(编译时)<runtime(运行时))
@Documented - 标记这些注解是否包含在用户文档中。
@Target - 标记这个注解应该是哪种 Java 成员。
用于控制自定义注解生效的范围。

@Target(value = {ElementType.TYPE})
/**用于描述类、接口(包括注解类型) 或enum声明 Class, interface (including annotation type), or enum declaration */
TYPE,
/** 用于描述域 Field declaration (includes enum constants) */
FIELD,
/**用于描述方法 Method declaration */
METHOD,
/**用于描述参数 Formal parameter declaration */
PARAMETER,
/**用于描述构造器 Constructor declaration */
CONSTRUCTOR,
/**用于描述局部变量 Local variable declaration */
LOCAL_VARIABLE,
/**接口 Annotation type declaration */
ANNOTATION_TYPE,
/**用于描述包 Package declaration */
PACKAGE,
/**
* 用来标注类型参数 Type parameter declaration
* @since 1.8
*/
TYPE_PARAMETER,
/**
*能标注任何类型名称 Use of a type
* @since 1.8
*/
TYPE_USE

@Inherited - 标记这个注解是继承于哪个注解类(默认 注解并没有继承于任何子类)

从 Java 7 开始,额外添加了 3 个注解:

@SafeVarargs - Java 7 开始支持,忽略任何使用参数为泛型变量的方法或构造函数调用产生的警告。
@FunctionalInterface - Java 8 开始支持,标识一个匿名函数或函数式接口。
@Repeatable - Java 8 开始支持,标识某注解可以在同一个声明上使用多次。

自定义注解:

第一步
构建基本结构

    @interface test{

    }

第二步
添加作用域,以及作用对象

    @Target(ElementType.TYPE)
    @Retention(RetentionPolicy.RUNTIME)
    @interface test{

    }

第三步
添加参数

    @Target(ElementType.TYPE)
    @Retention(RetentionPolicy.RUNTIME)
    @interface test{
    
		String name() default "默认值";
        int age() default 24;

        String[] wife() default {"倩倩", "小龙女", "张佳宁", "and more"};    
    }

第四步
第四步就需要我们去调用这个注解了,但是通常在调用时我们要用到反射,所以我会在反射部分将注解的使用进行完善!!!


参考连接:
西部开源-B站课程
菜鸟教程-接口部分
站内文章

上一篇:SpringBoot中自定义注解


下一篇:Fatal message conversion error;message rejected;it will be dropped or routed to a dead letter exchan