Java注解的学习之元注解说明

Doyle 发布于2019-08-19 10:16 / 1602人阅读

摘要：那到底是怎么定义的呢它还能用在什么地方是如何在编译的时候遇到这个注解就马上发出一个提示的呢带着这些疑问，一步一步学习的注解。

最近在学习Spring Boot，发现真的是一个靠注解搭起来的框架，Spring从使用XML到现在使用注解，大概是终于发现绝大多数人所写的项目，都不需要XML的松耦合，快速上线、快速丢弃、快速接手，在一切都要求快的互联网公司里，XML这样的松耦合浪费太多的学习成本了，划不来。

之前一直没有系统学习过Java的注解，学习起Spring Boot来总是用得不明所以，想想还是从基础学起，方不至于浪费大量的时间去查找Spring Boot各个注解的使用文档。

Java的注解，实际上包含三方面的内容，一个是Java注解本身的定义，一个是Java注解的使用，一个是如何利用Java的反射功能实现功效。本文也将从这三个方面逐一讲解，主要参考文章JAVA 注解的基本原理和 Java语法标准。

Java 内置了许多的注解，在Java Annotation可以找到内置的所有注解，我们最常见的注解应该是@Deprecated，一旦一个方法使用了这个注解，别人此后再使用这个方法时，就会提示这个方法已经被废弃了，建议不再使用。

那@Deprecated到底是怎么定义的呢？它还能用在什么地方？JDK是如何在编译的时候遇到这个注解就马上发出一个提示的呢？带着这些疑问，一步一步学习Java的注解。

一、如何创建一个注解

所有的注解本身都继承于java.lang.annotation.Annotation, 每一个注解本身就是一个interface，但是注解这种interface有其特殊性，所以，所有的注解都是这样定义的：

publice @interface xxxx {}

@Deprecated的实现代码如下：

import java.lang.annotation.*;
import static java.lang.annotation.ElementType.*;

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})
public @interface Deprecated {
}

多了@Documented， @Retention，@Target三个注解，这三个注解分别是什么呢？又有什么作用呢？

用于方法的方法，叫做元方法，所以用于注解的注解，就叫做元注解，这三个都是JDK提供的元注解。

@Documented标记这个注解@Deprecated将会出现在Java Doc之中

@Rentention标明这个注解的生命周期，RententionPolicy里面定义了三种生命周期，分别是SOURCE,CLASS，RUNTIME三种，SOURCE表示在编译阶段抛弃，CLASS表示会被记录到class文件里面，但不会出现在vm里面运行，RUNTIME表示在运行期里面存活。

@Target表示这个注解可以用在何处，比如@Deprecated的定义，表明它可以用在构造函数，字段，本地变量，方法，包，参数，类

@Deprecated
public class TestDeprecated {
    @Deprecated
    public String name;

    @Deprecated
    public TestDeprecated(String name){ }

    @Deprecated
    public String getName() {
        return name;
    }

    public void testDeprecatedParam(@Deprecated String name, String sex){
        @Deprecated
        String test = "test";
        System.out.println(name + sex + test);
    }
}

如上是@Deprecated在类、字段、构造函数、方法、参数和本地变量的使用方式。不过本地变量和参数的@Deprecated似乎是不起作用的。另外，package级别的注解使用，需要使用package-info.java, 比如package-info.java文件如下：

@Deprecated
package com.shahuwang;

这样子就标记了整个包都是要废弃的了。

目前Java 10 提供了 @Documented， @Inherited，@Native，@Repeatable，@Retention， @Target 共六个元注解，除了上面已讲解过的三个，剩余三个的用途：

@Inherited 表示使用了它的注解，再用到类上面时，可被子类继承此注解。

   @Inherited
   publice @interface Test{}
   
   @Test  
   public class Parent{}
   
   public class Child extends Parent{}

如上，Child类也继承了@Test 这个注解，可以使用它的功能。

@Native 表示定义常量值的字段可以被native代码引用，当native代码和java代码都需要维护相同的常量时，如果java代码使用了@Native标志常量字段，可以通过工具将它生成native代码的头文件。目前对Java的native代码研究比较少，后面再对它进行研究

@Repeatable 表示注解可以重复使用，是Java 8引进的特性。之前注解只能在同一个地方用一次，用了@Repeatable，注解就可以在同一个地方使用多次了，可以参考这篇文章https://blog.csdn.net/aitangy...

私有云混合云 java切面注解 java注解概念 java注解列表 java注解种类

文章版权归作者所有，未经允许请勿转载,若此文章存在违规行为，您可以联系管理员删除。

转载请注明本文地址：https://www.ucloud.cn/yun/75716.html

Java基础知识整理之注解

摘要：注解提供了一种安全的类似注释的机制，用来将任何的信息或元数据与程序元素类方法成员变量等进行关联。为程序的元素类方法成员变量加上更直观更明了的说明，这些说明与程序的业务逻辑无关，并且提供给指定的工具或框架使用。什么是注解？ Annotation 是 Java5 之后开始引入的新特性，中文为注解。注解提供了一种安全的类似注释的机制，用来将任何的信息或元数据（metadata）与程序元素（...

blastz 2019-08-19 10:57 评论0 收藏0
java注解初步学习

摘要：定义注解，也叫元数据。它可以声明在包类字段方法局部变量方法参数等的前面，用来对这些元素进行说明，注释。方法返回该程序元素上存在的所有注解。与此接口中的其他方法不同，该方法将忽略继承的注释。定义：注解（Annotation），也叫元数据。一种代码级别的说明。它是JDK5.0及以后版本引入的一个特性，与类、接口、枚举是在同一个层次。它可以声明在包、类、字段、方法、局部变量、方法参数等...

KnewOne 2019-08-14 11:54 评论0 收藏0
Java注解-元数据、注解分类、内置注解和自定义注解

摘要：注解有以下几个知识点元数据注解的分类内置注解自定义注解注解处理器本文先介绍前面个知识点元数据注解的分类内置注解自定义注解。注解相当于是一种嵌入在程序中的元数据，可以使用注解解析工具或编译器对其进行解析，也可以指定注解在编译期或运行期有效。大家好，我是乐字节的小乐，上次说过了Java多态的6大特性|乐字节，接下来我们来看看Java编程里的注解。showImg(https://segme...

Yujiaao 2019-08-19 10:12 评论0 收藏0
第12章元编程与注解、反射《Kotlin 项目实战开发》

摘要：第章元编程与注解反射反射是在运行时获取类的函数方法属性父类接口注解元数据泛型信息等类的内部信息的机制。本章介绍中的注解与反射编程的相关内容。元编程本质上是一种对源代码本身进行高层次抽象的编码技术。反射是促进元编程的一种很有价值的语言特性。第12章元编程与注解、反射反射（Reflection）是在运行时获取类的函数（方法）、属性、父类、接口、注解元数据、泛型信息等类的内部信息的机...

joyqi 2019-08-15 12:29 评论0 收藏0
java第三方包学习之lombok

摘要：不久前发现有一个第三方库可以在一定程度上帮助我们从体力劳动中解救出来，它就是。来看自动生成的方法中对于数组采用的是。检查传入对象是否为，若为，则抛出异常。比如自动抛受检异常，而无需显式在方法上使用语句。前言 Laziness is a virtue！每当写pojo类时，都会重复写一些setter/getter/toString方法等大量的模版代码，无聊繁琐却又不得不做，这会让这个类变...

GitCafe 2019-08-14 17:06 评论0 收藏0