一、注解那些事

1.什么是注解

  • 它提供了一种安全的类似注释的机制,用来将任何的信息或元数据(metadata)与程序元素(类、方法、成员变量等)进行关联。
  • Java 注解是附加在代码中的一些元信息,用于一些工具在编译、运行时进行解析和使用,起到说明、配置的功能。
  • 注解是框架的核心之一

2.java中的注解

Java给一个方法加上超时异常 java方法过时是什么意思_Java

  • @Override 表示覆盖或重写父类的方法;
  • @Deprecated 表示该方法已经过时了。(当方法或是类上面有 @Deprecated 注解时,说明该方法或是类都已经过期不能再用,但不影响以前项目使用,提醒你新替代待的方法或是类。如果程序员不小心使用了它的元素,那么编译器会发出警告信息。)
  • @SuppressWarnings 表示忽略指定警告,比如 @Suppvisewarnings (“Deprecation”)

3.常见的第三方注解

Java给一个方法加上超时异常 java方法过时是什么意思_元注解_02


二、注解的分类

按运行机制(注解存在于程序的那个阶段)将注解分为三类:

  • 源码注解 (只在源码存在)、
  • 编译注解 (在 class 文件中也存在)
  • 运行时注解 (在运行阶段仍然起作用)

Java给一个方法加上超时异常 java方法过时是什么意思_自定义注解_03

Java给一个方法加上超时异常 java方法过时是什么意思_Java_04

按照功能来分的,还有,元注解 —— 注解的注解。


按照来源来分的话,有如下三类:
1:JDK 自带的注解(Java 目前只内置了三种标准注解:@Override、@Deprecated、@SuppressWarnings,以及四种元注解:@Target、@Retention、@Documented、@Inherited)
2:第三方的注解 —— 这一类注解是我们接触最多和作用最大的一类
3:自定义注解 —— 也可以看作是我们编写的注解,其他的都是他人编写注解


三、自定义注解

1、自定义注解的语法要求

Java给一个方法加上超时异常 java方法过时是什么意思_自定义注解_05


2、元注解

Java给一个方法加上超时异常 java方法过时是什么意思_Java给一个方法加上超时异常_06


@Target 是注解的作用域 :表示该注解可以用于一个类中的哪些属性及方法上,如果作用域类型有多个用英文逗号分隔下面是注解的作用域的列表:

Java给一个方法加上超时异常 java方法过时是什么意思_Java_07


@Retention:表示该注解的生命周期

注解按声明周期有个分类:

Java给一个方法加上超时异常 java方法过时是什么意思_自定义注解_08


@Inherited: 此注解是标识性的元注解,表示当前注解可以由子注解来继承

@Documented: 表示生成 javadoc 的时候会包含注解


3、使用自定义注解

Java给一个方法加上超时异常 java方法过时是什么意思_元注解_09

Java给一个方法加上超时异常 java方法过时是什么意思_自定义注解_10

注解的定义看起来很像接口的定义,事实上,与其他任何 Java 接口一样,注解也将会编译成 class 文件。

定义注解时,会需要一些元注解(meta-annotation),如 @Target 和 @Retention。@Target 用来定义你的注解将用于什么地方(例如是一个方法或一个域)。@Retention 用来定义该注解在哪一个级别可用,在源代码(SOURCE)、类文件中(CLASS)或者运行时(RUNTIME)。


4、解析注解

概念:通过反射获取类、函数或成员上运行时注解信息,从而实现动态控制程序运行的逻辑。

Java给一个方法加上超时异常 java方法过时是什么意思_Java_11


使用 forName () 方法加载类,并使用 isAnnotationPresent (Description.class) 检查该类是否带有 @Description 注解。

注解的继承只能作用在类上,方法上的注解不会被继承,Interface 中的所有注解不会被继承。