重学java 83.Java注解

As a failure,I met my last sound.

—— 24.6.24

一、注解的介绍

1.引用数据类型:

类、数组、接口、枚举、注解

jdk1.5版本的新特性

一个引用数据类型

和类,接口,枚举是同一个层次的

引用数据类型:类、数组、接口、枚举、注解

2.作用:

① 说明：对代码进行说明,生成doc文档(API文档)

② 检查：检查代码是否符合条件 @override(重写) @FunctionalInterface（函数式接口）

③ 分析：对代码进行分析,起到了代替配置文件的作用(会用)

3.JDK中的注解:

        @override ——> 检测此方法是否为重写方法
                jdk1.5版本,支持父类的方法重写
                jdk1.6版本,支持接口的方法重写

@Deprecated ——>方法已经过时，不推荐使用

调用方法的时候,方法上会有横线,但是能用

@suppressWarnings ——> 消除警告 @suppressWarnings("all")

import java.util.ArrayList;
@SuppressWarnings("all")
public class Demo343Test01 {
    public static void main(String[] args) {
        Person person = new Person();
        person.eat();

        System.out.println("——————————————————————————");
        ArrayList list = new ArrayList();
        list.add(new Person());
    }
}

public class Person {
    @Deprecated
    public void eat(){
        System.out.println("人要吃饭");
    }
}

二、注解的定义以及属性的定义格式

注解属性：本质上是抽象方法

1.定义

public @interface 注解名{

}

2.定义属性（抽象方法）

增强注解的作用

数据类型属性名() ——> 此属性没有默认值，需要在使用注解的时候为其赋值

数据类型属性名()defaut值->此属性有默认值,如果有需要,还可以二次赋值

3.注解定义中的属性类型

a、八种基本类型

b、String类型,class类型,枚举类型，注解类型

c、以及以上类型的一维数组

public @interface Book {
    // 书名
    String bookName();
    // 作者
    String[] author();
    // 价格
    int price();
    // 数量 default 默认值 10本
    int count() default 10;
}

三、注解的使用

1.注解的使用:

为注解中的属性赋值

2.使用位置上:

在类上使用,方法上使用,成员变量上使用,局部变量上使用,参数位置使用等

3.使用格式:

a、@注解名(属性名=值,属性名=值...)
b、如果属性中有数组：@注解名(属性名={元素1,元素2...})

@Book(bookName = "云边有个小卖部",author = "张嘉译",price = 10,count = 11)
public class BookShelf {
}

4.注解注意事项:

① 空注解可以直接使用 --> 空注解就是注解中没有任何的属性

② 不同的位置可以使用一样的注解,但是同样的位置不能使用一样的注解

③ 使用注解时,如果此注解中有属性,注解中的属性一定要赋值,如果有多个属性，用，隔开
如果注解中的属性有数组，使用{}

④ 如果注解中的属性值有默认值,那么我们不必要写,也不用重新赋值,反之必须写上

⑤ 如果注解中只有一个属性,并且属性名叫value，那么使用注解的时候，属性名不用写，直接写值(包括单个类型，还包括数组)

@Book(bookName = "云边有个小卖部",author = "张嘉译",price = 10,count = 11)
public class BookShelf {
}

四、注解的解析 ——> AnnotatedElement接口

注解的解析：说白了就是将注解中的属性值获取出来

1.注解解析涉及到的接口:

AnnotatedElement接口

实现类：AccessibleObject、Class、Constructor、 Executable、 Field、 Method、 Package、Parameter

2.解析思路：

先判断指定位置上有没有使用指定的注解,如果有,获取指定的注解,获取注解中的属性值

a、boolean isAnnotationPresent(class<? extends Annotation> annotationClass) ——> 判断指定位置上有没有指定的注解

比如：判断Bookshelf上有没有Book注解

Class bookshelf=Bookshelf.classbookshelf.isAnnotationPresent(Book.class)
b、getAnnotation(Class<T> annotationclass) ——> 获取指定的注解,返回值类型为获取的注解类型

比如：获取Bookshelf上的Book注解
Class bookshelf = Bookshelf.class

boolean result = bookshelf.isAnnotationPresent(Book.class)

如果resut为true,证明Bookshelf上有Book注解，那就获取

Book book =bookshelf.getAnnotation(Book.class)

BOOK接口

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Target({ElementType.TYPE,ElementType.METHOD,ElementType.FIELD, ElementType.PARAMETER,ElementType.LOCAL_VARIABLE,ElementType.ANNOTATION_TYPE})
@Retention(RetentionPolicy.RUNTIME)
public @interface Book {
    // 书名
    String bookName();
    // 作者
    String[] author();
    // 价格
    int price();
    // 数量 default 默认值 10本
    int count() default 10;
}

书籍信息类

@Book(bookName = "云边有个小卖部",author = "张嘉译",price = 27,count = 11525)
public class BookShelf {
}

主函数

import java.util.Arrays;

public class Demo344Test {
    public static void main(String[] args) {
        // 1.获取BookShelf的class对象
        Class<BookShelf> bookShelfClass = BookShelf.class;
        // 2.判断bookShelf上有没有Book注解
        boolean b = bookShelfClass.isAnnotationPresent(Book.class);
        // 如果b为true，就获取
        if (b){
            Book book = bookShelfClass.getAnnotation(Book.class);
            System.out.println(book.bookName());
            System.out.println(Arrays.toString(book.author()));
            System.out.println(book.price());
            System.out.println(book.count());
        }
    }
}

以上代码没有解析出来

原因：Book注解有可能就没有在内存中出现

五、元注解

1.概述:

元注解就是管理注解的注解

2.管理注解的方式：

a、控制注解的使用位置

① 控制注解是否能在类上使用

② 控制注解是否能在方法上使用

③ 控制注解是否能在构造上使用等

b、控制注解的加载位置(生命周期)

① 控制注解是否能在源码中出现

② 控制注解是否能在class文件中出现控制

③ 注解是否能在内存中出现

3.使用

a、@Target：控制注解的使用位置

属性：ElementType[] value();

ElementType是一个枚举,里面的成员可以类名直接调用

ElementType中的成员：

TYPE：控制注解能使用在类上

FIELD：控制注解能使用在属性上

METHOD：控制注解能使用在方法上

PARAMETER：控制注解能使用在参数上

CONSTRUCTOR：控制注解能使用在构造上

LOCAL_VARIABLE：控制注解能使用在局部变量上

b、@Retention：控制注解的生命周期(加载位置)

属性：RetentionPoicy value();

RetentionPolicy是一个枚举,里面的成员可以类名直接调用

RetentionPolicy中的成员:

SOURCE：控制注解能在源码中出现 ——> 默认

CLASS：控制注解能在class文件中出现

RUNTIME：控制注解能在内存中出现

BOOK接口

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Target({ElementType.TYPE,ElementType.METHOD,ElementType.FIELD, ElementType.PARAMETER,ElementType.LOCAL_VARIABLE,ElementType.ANNOTATION_TYPE})
@Retention(RetentionPolicy.RUNTIME)
public @interface Book {
    // 书名
    String bookName();
    // 作者
    String[] author();
    // 价格
    int price();
    // 数量 default 默认值 10本
    int count() default 10;
}

书籍信息类

@Book(bookName = "云边有个小卖部",author = "张嘉译",price = 27,count = 11525)
public class BookShelf {
}

主函数

import java.util.Arrays;

public class Demo344Test {
    public static void main(String[] args) {
        // 1.获取BookShelf的class对象
        Class<BookShelf> bookShelfClass = BookShelf.class;
        // 2.判断bookShelf上有没有Book注解
        boolean b = bookShelfClass.isAnnotationPresent(Book.class);
        // 如果b为true，就获取
        if (b){
            Book book = bookShelfClass.getAnnotation(Book.class);
            System.out.println(book.bookName());
            System.out.println(Arrays.toString(book.author()));
            System.out.println(book.price());
            System.out.println(book.count());
        }
    }
}