【Java】注解详解编程语言

介绍

注解（Annotation ），有标记、注释的意思，也被称为元数据，他为我们在代码中添加信息提供了一种形式化的方法，使我们可以在稍后某个时刻非常方便地使用这些数据。在 Java 中注解是一个很重要的知识点。

Java 注解是从 Java SE5 引入的。他可以提供用来完整描述程序所需的信息，为程序的元素（类、方法、成员变量）加上更直观更明了的说明，这些说明信息是与程序的业务逻辑无关，并且是供指定的工具或框架使用的。
Annontation像一种修饰符一样，应用于包、类型、构造方法、方法、成员变量、参数及本地变量的声明语句中。

标准注解

注解的语法比较简单，[email protected]，基本与Java固有语法无异。JDK5内置了三种，定义在java.lang中的注解：

@Override，表示当前方法定义将覆盖超类中方法。如果将这个单词拼写错误，或者方法签名对应不上被覆盖的方法，那么编译器就会发出错误提示。 @Deprecated，如果使用了注解为这个单词的元素，那么编译器就会发出警告。 @SuppressWarnings，关闭不当的编译器警告信息。 元注解

元注解专职负责注解其他注解，Java5.0定义了4个标准的meta-annotation类型，它们被用来提供对其它 annotation类型作说明。

@Target：用于描述该注解的适用范围：

取值(ElementType)有： 

 1.CONSTRUCTOR:用于描述构造器 

 2.FIELD:用于描述域（包括enum实例） 

 3.LOCAL_VARIABLE:用于描述局部变量 

 4.METHOD:用于描述方法 

 5.PACKAGE:用于描述包 

 6.PARAMETER:用于描述参数 

 7.TYPE:用于描述类、接口(包括注解类型) 或enum声明 

@Retention：表示需要在什么级别保存该注解信息 (生命周期)

某些Annotation仅出现在源代码中，而被编译器丢弃；而另一些却被编译在class文件中；编译在class文件中的Annotation可能会被虚拟机忽略，而另一些在class被装载时将被读取（请注意并不影响class的执行，因为Annotation与class在使用上是被分离的）。使用这个meta-Annotation可以对 Annotation的“生命周期”限制。

取值（RetentionPoicy）有： 

 1.SOURCE:在源文件中有效（即源文件保留），会被编译器丢弃 

 2.CLASS:在class文件中有效（即class保留），但会被VM丢弃 

 3.RUNTIME:在运行时有效（即运行时保留），可以通过反射机制读 取注解的信息 

@Documented：包含在Javadoc中

描述其它类型的annotation应该被作为被标注的程序成员的公共API，因此可以被例如javadoc此类的工具文档化

@Inherited：允许子类继承父类中的注解

如果一个超类被 @Inherited 注解过的注解进行注解的话，那么如果它的子类没有被任何注解应用的话，那么这个子类就继承了超类的注解。

注意：@Inherited annotation类型是被标注过的class的子类所继承。类并不从它所实现的接口继承annotation，方法并不从它所重载的方法继承annotation。

[email protected] [email protected].RUNTIME，则反射API增强了这种继承性。如果我们使用java.lan[email protected] annotation类型的annotation时，反射代码检查将展开工作：检查class和其父类，直到发现指定的annotation类型被发现，或者到达类继承结构的顶层。

自定义注解

定义注解格式： 

 public @interface 注解名 {

 定义体} 

关于Annotation类型里面的参数该怎么设定:
第一,只能用public或默认(default)这两个访问权修饰.例如,String value();这里把方法设为defaul默认类型；
第二,参数成员只能用基本类型byte,short,char,int,long,float,double,boolean八种基本数据类型和 String,Enum,Class,annotations等数据类型,以及这一些类型的数组.例如,String value();这里的参数成员就为String。

注解的使用

刚接触注解时，我想很多人都会有一个疑问，这个东西有什么用呢？官方文档给了我们答案：

注解是一系列元数据，它提供数据用来解释程序代码，但是注解并非是所解释的代码本身的一部分。注解对于代码的运行效果没有直接影响。

注解有许多用处，主要如下：

提供信息给编译器： 编译器可以利用注解来探测错误和警告信息 编译阶段时的处理： 软件工具可以用来利用注解信息来生成代码、Html文档或者做其它相应处理。 运行时的处理： 某些注解可以在程序运行的时候接受代码的提取
值得注意的是，注解不是代码本身的一部分。

在Spring中大量使用了注解，[email protected]@Service等，这些注解大大简化了方法的配置工作。

在此我用上述作用的第一个：提供信息给编译器，来做一个示范。

假设我在一个类里面定义了很多方法，我需要检查每一个方法是否有异常，并将其一一打印，那么我就可以在需要检查的方法上加一个注解，然后用反射的方法来调用方法并获取其注解，判断并打印之。

首先是注解类：

/** 

 * Created by makersy on 2019 

@Target(ElementType.METHOD) 

@Retention(RetentionPolicy.RUNTIME) 

public @interface CheckException {

 public String description() default "no description"; 

然后是方法类：

/** 

 * Created by makersy on 2019 

public class SomeMethods {


 int cnt = 0; //异常计数 

 for (Method method : SomeMethods.class.getDeclaredMethods()) {

 if (method.isAnnotationPresent(CheckException.class)) {

 //判断注解是否为我们定义的那个 

 CheckException anno = method.getAnnotation(CheckException.class); //获取CheckException注解 

 System.out.println(anno.description() + ":"); //打印方法注解的描述 

 try {

 method.invoke(someMethods, null); //调用方法 

 } catch (IllegalAccessException | InvocationTargetException e) {

 System.out.println(method.getName() + " has error. Caused By: " + e.getCause().getClass().getSimpleName()); 

 System.out.println(e.getCause().getMessage()); 

 cnt++; //异常计数+1 

 System.out.println(someMethods.getClass().getSimpleName() + " has " + cnt + " error!"); 

下面是结果展示：

原创文章，作者：ItWorker，如若转载，请注明出处：https://blog.ytso.com/19363.html

cjavaxml