javaSE-注解

注解介绍

注解是java5引进的一种语法，注解与注释有着差不多的作用，只不过注释是给人看的，注解是给java编译器与java虚拟机看的。

使用场景

注解都是配合反射技术去使用的，如果没有了java的反射技术，注解也就失去了它存在的意义。

原生注解

在java中，自带了好几个注解，其中五种注解是给我们用来创建自定义注解时使用的，成为五大元注解。剩下的都是应用级注解，即我们可以注解拿来使用的注解。

1. 三种常见应用级注解

注解名	应用场景	意义
SuppressWarnings	除了包与注解之外的场景	压制警告
Deprecated	全部	将该项标记为过时
Override	重写的方法	标记该方法为重写发放

测试代码如下

/**
 * @Classname Demo1
 * @Date 2020/11/21 10:16
 * @author hzq
 * 测试原生三大注解
 */
package com.hzq.annotation;

import java.util.HashMap;

public class Demo1 {
    /**
     * 覆盖方法的注解
     * 用来标注该方法是从父类或者接口继承来的方法
     * 在子类中进行重写
     * @return
     */
    @Override
    public String toString() {
        return "Demo1{}";
    }

    /**
     * 用来压制警告
     */
    @SuppressWarnings("all")
    public void test1(){
        HashMap<Object, Object> map = new HashMap<>();
    };

    /**
     * 标记该方法已过时
     * 不推荐使用
     */
    @Deprecated
    public void test2(){

    }

    public static void main(String[] args) {
        Demo1 demo1 = new Demo1();
        demo1.test2();
    }
}

五种元注解

底层注解是在我们创建自定义注解时所使用的注解

注解名	应用场景	意义
Target	注解	表示新建注解的应用场景
Retention	注解	表示新建注解的生命周期
Documented	注解	表示该注解也会被输出到文档中
Inherited	注解	表示新建注解会被标注的类的子类所继承
Repeatable	注解	表示该注解可以在同一位置多次使用

测试代码如下：

/**
 * @Classname Demo2
 * @Date 2020/11/21 10:41
 * @author hzq
 */
package com.hzq.annotation;

import java.lang.annotation.*;
@MyAnnotation("myAnnotation1")
@MyAnnotation("myAnnotation2")
public class Demo2 {
}

/**
 * @author admin
 */
//表示新创建的注解可以应用的场景
@Target(ElementType.TYPE)
//表示注解的生命周期(我们自定义注解一般都设为Runtime)
@Retention(RetentionPolicy.RUNTIME)
//表示该注解也会被输出到文档上(需要配合javadoc使用,基本上没啥用)
@Documented
//表示新建的注解,可以被标注的类的子类所继承过去
@Inherited
//表示该注解可以在同一个位置标记多次
@Repeatable(MyAnnotations.class)
@interface MyAnnotation{
    String value();
}

/**
 * @author admin
 */
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@interface MyAnnotations{
    MyAnnotation[] value();
}

注解的语法

1. 新建注解时应该使用@interface来创建，注解是一个特殊的接口，它会自动继承Annotation接口。
2. 在注解内部可以定义注解的属性，如String value();。
3. 注解的属性除了String类型外还可以基本数据类型，枚举类型，Classl类型等类型以及他们的数组类型。
4. 还可以给属性设置默认值，语法为String value() default "笑笑";，这样，当使用注解并且没有给属性赋值时，会有一个默认的值。
   示例代码如下：

/**
 * @Classname Demo3
 * @Date 2020/11/21 11:13
 * @author hzq
 */
package com.hzq.annotation;

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

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
//创建注解使用@interface
public @interface Demo3 {
    String value() default "笑笑";
    int age();
    String[] names = new String[10];
}