4.1.2 注解分类

àì夳堔傛蜴生んèń 2021-10-14 00:50 194阅读 0赞

**目录**

1.内建注解

（1）@OVerride 注解

（2）@Deprecated 注解

（3）@SuppressWarnings 注解

注意：

2.元注解

（1）@Target 注解

（2）@Retention 注解

（3）@Documented注解

（4）@Inherited 注解

--------------------

在 Java中，根据注解的使用方法和用途，可将注解分为3类，分别是内建注解、

元注解以及自定义注解。

# 1.内建注解 #

在JDK 5.0 版本的 java.lang包下提供了 3 种标准的注解类型，成为内建注解，分别

是 @Override 注解、@Deprecated 注解以及 @SuppressWarnings注解。

### （1）@OVerride 注解 ###

@Override 注解被用来标注方法，它用来表示该方法是重写父类的某方法。@Override

注解的用法非常简单，只要在重写的子类方法前加上@Override即可。如下程序中就使用

了@Override 注解来标识子类 Apple 的 getObjectInfo() 方法是重写的父类的方法。

package sz.com.Annotation;
    
    /**
     * @author Darren
     * @create Darren  QQmailbox:395648542@qq.com  Blog address:https://blog.csdn.net/weixin_44129498
     * @create 2019/8/17
     * @create 4:56
     */
    public class Fruit {
        public void getObjectInfo(){
            System.out.println("水果的getObjectInfo方法");
        }
    }

package sz.com.Annotation;
    
    /**
     * @author Darren
     * @create Darren  QQmailbox:395648542@qq.com  Blog address:https://blog.csdn.net/weixin_44129498
     * @create 2019/8/17
     * @create 4:59
     */
    public class Apple extends Fruit {
        //使用 @Override 指定下面的方法必须重写父类方法
        @Override
        public void getObjectInfo(){
            System.out.println("苹果重写水果的 getObjectInfo方法");
        }
    }

### （2）@Deprecated 注解 ###

@Deprecated 注解表示程序元素已过时。如果一个程序元素被@Deprecated注解修

饰，则表示此程序元素已经过时，编译器将不再鼓励使用这个被标注的程序元素。如果使

用，编译器会在该程序元素上画一条斜线，表示此程序已过时。例如下面的代码中，

getObjectInfo() 方法将被表示为已过时的方法。

//使用@Deprecated 指定下面的方法已过时
        @Deprecated
        public void getObjectInfo() {
            System.out.println("苹果重写水果的 getObjectInfo方法");
        }

### （3）@SuppressWarnings 注解 ###

@SuppressWarnings  注解标识阻止编译器警告，被用于有选择地关闭编译器对类、

方法和成员变量等程序元素及其子元素的警告。@SuppressWarnings注解会一直作用于

该程序元素的子元素。例如下面的代码中，使用 @SuppressWarnings("unchecked")

注解来标识Fruit 类取消类型检查的编译器警告。

//使用@SuppressWarnings 抑制编译器警告信息
    
        @SuppressWarnings(value = "unchecked")
        public void getObjectInfo() {
            System.out.println("苹果重写水果的 getObjectInfo方法");
        }

上述代码中，“unchecked” 是  @SuppressWarnings 注解的参数    @SuppressWarnings

注解常用的参数如下。

1.  deprecation:使用了过时的程序元素。
2.  unchecked:执行了未检查的转换。
3.  unused:有程序元素未被使用。
4.  fallthrough:switch 程序块直接通往下一种情况而没有 break。
5.  path:在类路径、源文件路径等中有不存在的路径。
6.  serial:在课序列化的类上缺少 serialVersionUID 定义。
7.  finally:任何 finally 子句不能正常完成。
8.  all:所有情况。

### 注意： ###

当注解类型里只有一个 value 成员变量，使用该注解时可以直接在注解后的

括号中指定 value 成员变量的值，而无须使用 name=value 结构对的形式。在@

SuppressWarnings 注解类型中只有一个 value 成员变量，所有可以把 "value="省

略掉，例如：

@SuppressWarnings({"unchecked","fallthrough"});

如果  @SuppressWarnings 注解所声明的被禁止的警告个数只有一个时，则可

不用大括号，例如：

@SuppressWarnings("unclecked");

# 2.元注解 #

java.lang.annotation 包下提供了 4个元注解，它们用来修饰其他的注解定义。这4个

元注解分别是 @Target 注解、@Retention 注解、@Documented 注解以及@Inherited注解。

### （1）@Target 注解 ###

@Target 注解用于指定被其修饰的注解能用于修饰那些程序元素，@Target注解类型有

唯一的 value 作为成员变量。这个成员变量是 java.lang.annotation.ElementType类型，

ElementType 类型是可以被标注的程序元素的枚举类型。@Target的成员变量 value 为如下值时，

则可指定被修饰的注解只能按如下声明进行标注，当 value 为FIELD时，被修饰的注解

只能用来修饰成员变量。

1.  ElementType.ANTOTATION\_TYPE:注解声明。
2.  ElementType.CONSTRUCTOR:构造方法声明。
3.  ElementType.FIELD:成员变量声明。
4.  ElementType.LOCAL\_VARIABLE:局部变量声明。
5.  ElementType.METHOD:方法声明。
6.  ElementType.PACKAGE:包声明。
7.  ElementType.PARAMETER:参数声明。
8.  ElementType.TYPE:类、接口（包括注解类型）或枚举声明。

### （2）@Retention 注解 ###

@Retention 注解描述了被其修饰的注解是否被编译器丢弃或者保留在 class 文件中。

默认情况下，注解被保存在 class 文件中，但在运行时并不能被反射访问。

@Retention 包含一个 RetentionPolidy 类型的 value 成员变量，其取值来自 java.lang.

annotation.RetentionPolicy 的枚举类型值，有如下 3 个取值。

1.RetentionPolicy.CLASS:@Retention 注解中 value 成员变量的默认值，表示编译

器把被修饰的注解记录在  class 文件中，但当运行 Java 程序时，Java 虚拟机不再

保留注解，从而无法通过反射对注解进行访问。

2.RetentionPolicy.RUNTIME:表示编译器将注解记录在 class 文件中，当运行 Java

程序时，Java 虚拟机会保留注解，程序可以通过反射获取该注解。

3.RetentionPolicy.SOURCE:表示编译器将直接丢弃被修饰的注解。

下面是定义 @Retention注解类型的示例代码，通过将value 成员变量的值设为

RetentionPolicy.RUNTIME,指定 @Retention 注解在运行时可以通过反射进行访问。

@Retention(RetentionPolicy.RUNTIME)
        @Target(ElementType.ANNOTATION_TYPE)
        public @interface Retention{
            RetentionPolicy value();
        }

### （3）@Documented注解 ###

@Documented 注解用于指定被其修饰的注解将被 JavaDoc 工具提取成文档，如果

在定义某注解时使用了 @Documented 修饰，则所有使用该注解修饰的程序元素的 API

文档中都将包含该注解说明。另外，@Documented 注解类型没有成员变量。

### （4）@Inherited 注解 ###

@Inherited 注解用于指定被其修饰的注解将具有继承性。也就是说，如果一个使用

了@Inherited 注解修饰的注解被用于某个类，则这个注解类型没有成员变量。

3.自定义注解

前面介绍了 JDK 提供的 3 种内建注解及  4 种元注解。下面介绍自定义注解。

注解类型是一种接口，但它又不同于接口，定义一个新的注解类型与定义一个接口

非常相似，定义新的注解类型要使用 @interface 关键字，如下代码定义了一个简单的注

解类型。