java中的注解

1、概述
2、内置注解
---2.1Override注解
---2.2Deprecated注解
3、元注解
---3.1关于Target注解
---3.2关于Retention注解
4、注解中定义属性
5、反射注解
6、通过反射获取注解对象属性的值
7、注解在开发中的作用
更多关于注解见：
链接一
链接二

概述

1、注解：Annotation是一种引用数据类型。编译之后也是生成xx.class文件。
2、语法格式为：
[修饰符列表] @interface 注解类型名{}
3、注解怎么使用？
注解使用时的语法格式是：@注解类型名
Annotation可被用于 packages、types（类、接口、枚举、Annotation类型）、类型成员（方法、构造方法、成员变量、枚举值）、方法参数和本地变量（如循环变量、catch参数）。（默认情况下，注解可以出现在任意位置。）
4、例：

@DemoAnno
public class Demo {
    @DemoAnno
    private int no;
    @DemoAnno
    public Demo() {
    }
    @DemoAnno
    private void m(){
        @DemoAnno
        int a = 1;
    }
}

@DemoAnno
interface MyInterface{
}

@DemoAnno
enum S {
    ANN
}

@DemoA
public @interface DemoAnno {
}

5、一些内置注解
Deprecated
注释@Deprecated的程序元素是程序员不鼓励使用的程序元素，通常是因为它是危险的，或者因为存在更好的替代方法。
FunctionalInterface
使用的信息注释类型，以指示在接口类型声明旨在是一个 功能接口由Java语言规范所定义的。
Override
表示方法声明旨在覆盖超类型中的方法声明。
SafeVarargs
程序员断言注释方法或构造函数的正文不会对其varargs参数执行潜在的不安全操作。
SuppressWarnings
表示在注释元素（以及注释元素中包含的所有程序元素）中应该抑制命名的编译器警告。

内置注解

Override注解

1、源代码：
public @interface Override {}
2、是一个标识性注解，给编译器做参考。
方法上有这个注解的时候，编译器会自动检查该方法是否重写了父类的方法。如果没有重写会报错。这个注解只是在编译阶段起作用，和运行期无关。
3、只能注解方法，因为被Target限制了：
@Target(ElementType.METHOD)

Deprecated注解

1、被其标识后，表示被标识的元素已过时，告知程序员已过时，有更好的方案存在。
2、图例（其中过时的方法会加横杠）：

运行后：

但是会有警告：

元注解

• 概述
  1、用来标注“注解类型”的“注解”，称为元注解。
  2、常见元注解：
  @Retention
@Target

关于Target注解

1、Target注解用来标注“被标注的注解”可以出现在哪些位置上。
2、@Target(ElementType.METHOD)
表示“被标注的注解“只能出现在方法上。

关于Retention注解

1、Retention注解用来标注“被标注的注解”最终保存在哪里。
2、@Retention(RetentionPolicy.SOURCE)
表示该注解只被保留在java源文件中。
@Retention(RetentionPolicy.CLASS)
表示该注解被保存在class文件中
@Retention(RetentionPolicy.RUNTIME)
表示该注解被保存在class文件中，并且可以被反射机制所读取。

注解中定义属性

• 属性类型
  属性的类型可以是：byte、short、int、long、float、double、boolean、char、string、class、枚举类型，以及它们的每一种的数组形式。
• 代码示例

public @interface DemoAnno {
    //定义name属性
    String name();
    //定义age属性
    int age();
    //定义性别（指定属性的默认值）
    String sex() default "男";
}

public class Demo {
    /*报错的原因：注解中有属性，没有给属性赋值。
    * （除非该属性使用default指定了默认值）*/
    /*@DemoAnno()
    public void doSome(){ }*/

    //@DemoAnno(属性名=属性值,属性名=属性值...)
    @DemoAnno(name = "zhangsan",age = 1)
    public void doSome(){
        
    }
}

• 属性是value时可以省略
  1、限制条件：有且只有一个属性名叫value。
  2、代码示例：

public @interface DemoAnno {
    //定义value属性
    String value();
}

public class Demo {

    @DemoAnno(value = "v")
    public void doSome(){
    }

    //省略了“value = ”
    @DemoAnno("vv")
    public void doOther(){
    }
}

3、不止有value一个属性时：

public @interface DemoAnno {
    //定义value属性
    String value();
    //再加一个属性
    String name();
}

public class Demo {

    //此时就不能省略value
    @DemoAnno(value = "v", name = "zhangsan")
    public void doSome(){
    }
}

• 属性是数组时

public enum Season {
    SPRING, SUMMER, AUTUMN, WINTER
}

public @interface DemoAnno {
    String name();
    String[] hobby();
    //枚举数组
    Season[] seasonArr();
}

public class Demo {

    //数组中只有一个元素时，大括号可以省略
    @DemoAnno(name = "v",
            hobby = "zhangsan",
            seasonArr = Season.SUMMER)
    public void doSome(){
    }

    @DemoAnno(name = "v",
            hobby = {"111@qq.com","222@qq.com"},
            seasonArr = {Season.SPRING, Season.AUTUMN})
    public void doOther(){
    }
}

反射注解

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})
//该注解可以被反射
@Retention(RetentionPolicy.RUNTIME)
public @interface DemoAnno {
    String value() default "zhangsan";
}

@DemoAnno("lisi")
public class Demo {
    @DemoAnno
    public void doSome(){
        int i;
    }
}

public class DemoTest {
    public static void main(String[] args) throws Exception{
        Class c = Class.forName("Demo");
        /*判断类上面是否有@DemoAnno
        * 输出：true*/
        //System.out.println(c.isAnnotationPresent(DemoAnno.class));
        if (c.isAnnotationPresent(DemoAnno.class)){
            //获取该注解对象
            DemoAnno demoAnno = (DemoAnno)c.getAnnotation(DemoAnno.class);
            System.out.println("类上的注解对象是："+ demoAnno);
            //获取注解对象的属性
            String s = demoAnno.value();
            System.out.println(s);
        }
    }
}

输出：

、

通过反射获取注解对象属性的值

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

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface DemoAnno {
    String username();
    String password();
}

import java.lang.reflect.Method;

public class Demo {
    @DemoAnno(username = "admin", password = "123")
    public void doSome(){
    }

    public static void main(String[] args) throws Exception{
        //获取Demo的doSome()方法上面的注解信息
        Class c = Class.forName("Demo");
        //获取doSome()方法
        Method doSomeMethod = c.getDeclaredMethod("doSome");
        //判断该方法上是否存在这个注解
        if (doSomeMethod.isAnnotationPresent(DemoAnno.class)){
            DemoAnno demoAnno = doSomeMethod.getAnnotation(DemoAnno.class);
            System.out.println(demoAnno.username());
            System.out.println(demoAnno.password());
        }
    }
}

输出：

注解在开发中的作用

1、假如以这样一个需求：
有一个注解叫：@DemoAnno。这个注解只能出现在类上面，当这个类上有这个注解的时候，要求这个类中必须有一个int类型的id属性。如果没有这个属性就报异常，如果有这个属性则正常执行。
2、代码示例：

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)
public @interface DemoAnno {
}

@DemoAnno()
public class Demo {
    //int id;
    String name;
    String psw;
}

/*自定义异常*/
public class No_Id_Exception extends RuntimeException{
    public No_Id_Exception() {
    }

    public No_Id_Exception(String message) {
        super(message);
    }
}

import java.lang.reflect.Field;

public class DemoTest {
    public static void main(String[] args) throws Exception{
        Class demoClass = Class.forName("Demo");
        //布尔标记
        boolean isOk = false;
        if (demoClass.isAnnotationPresent(DemoAnno.class)){
            /*有注解的话，要求必须存在int类型的id属性*/
            //获取类的属性
            Field[] fields = demoClass.getDeclaredFields();
            for (Field field:fields) {
                if ("id".equals(field.getName())
                        && "int".equals(
                                field.getType().getSimpleName())){
                    //合法
                    isOk = true;
                    break;
                }
            }
            if (!isOk) {
                throw new No_Id_Exception(
                        "没有int类型的id属性");
            }
        }
    }
}

有int id时（无异常）：

没有int id时：