Java中的注解详讲

1 什么是注解

jdk5提供了一个新的应用 Annotation，注解，注释
与之前所学的注释的区别
- 之前的注释：是给程序员看，让程序员知道程序（代码）有什么用，实现了什么功能
- 今天的注解：是给编辑器或jvm看的。在编译和运行时提供一些信息，按照信息完成后续的工作
  
  我们在开发中经常使用注解作为配置信息的载体。类似于xml配置文件的作用。

2 注解的分类

普通注解，在编程中经常用来作为配置的注解，包括jdk自带的注解和自定义注解
- @Override 告诉编译，当前方法按照重写的规则检查。
- @Deprecated 告诉编译器，当前说明的内容是过时的，不建议使用的。但可以继续使用
- @SuppressWarnings 告诉编译，当前说明的内容相关的警告可以忽略
元注解，用来说明注解的注解。未来还有一个概念：元数据

用户信息：dmy ， 18 ，男， 30000

元数据：姓名，字符串类型，最长10个字符，性别，年龄，工资

元注解有4个
- @Target 用来说明当前注解都可以作用在哪些内容上

@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE})
public @interface SuppressWarnings {}

2.@Retention 用来说明当前注解存活范围，有3个范围，只能3选1

RetentionPolicy.SOURCE;  //表示在原码到字节码编译过程中有效。编译后消失
RetentionPolicy.CLASS;	//表示在类加载过程中有效，加载完消失。
RetentionPolicy.RUNTIME；//表示在jvm运行时都有效。

3.@Documented 用来说明当前注解在生成api文档时，会一同出现在文档中。
4.@Inherited 用来说明当前注解在类继承的过程中，可以一同被继承。

3 注解语法结构

注解是一个特殊的类，使用@interface 定义注解

public @interface A{}

使用元注解，在普通注解头上来说明注解特性。至少要使用@Retention 和 @Target

@Target({ElementType.FIELD,ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
public @interface A {}

注解里只能写一种内容（可以称为属性也可以称为方法）

public @interface A{String i();
}

该内容类型只能是以下几种
- String
- 8种基本类型
- Class
- 其他注解类型，当注解作为类型时，不需要加前面的@
- 枚举类型
- 上述所有类型的数组类型

可以使用default关键字，为注解中的属性设置默认值

public @interface A{String name() default "dmy"  ;String[] names() default {"dmy","zs","ls"};
}

4 注解的使用

使用注解，提供配置信息
- 根据Target元注解的指定，可以在对应的类的内容上使用注解
- 如果注解中有属性，可以在使用注解时，类似于传参的方式为属性赋值
- 属性赋值时，需要指定属性名和其对应的属性值
- 如果属性是数组类型，多个属性值要使用{}包含

@A(name="zhangsan",names={"zs","ls","ww"})
class B{}

特殊情况说明

如果注解不需要传递属性值（没有属性，都有默认值），后面的括号可有可无

@A()
@A
class B{}

如果注解中只有一个属性需要赋值，且这个属性名叫value。赋值时可以只写值，不写名

@interface A{String value();
}

如果注解属性是数组类型，且传参赋值时只赋予一个值，可以省略{}

@A(name="zs",names={"dmy"})
@A(name="zs",names="dmy")
class B{}

使用注解，获得配置信息

注解在使用时，也是类的一部分
可以通过反射获得注解，进而获得注解中配置的信息
反射中常用的对象（Class，Field ， Method ， Constructor）都提供了获得注解对象的方法

@Target({ElementType.FIELD,ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
public @interface A {String value() ;
}

public class Test3 {public static void main(String[] args) throws NoSuchFieldException, NoSuchMethodException, InvocationTargetException, IllegalAccessException {Class<B> c = B.class;A a = c.getAnnotation(A.class);System.out.println(a.value());Field i = c.getDeclaredField("i");Annotation[] annotations = i.getAnnotations();for(Annotation annotation : annotations){Method value = annotation.getClass().getMethod("value");Object v = value.invoke(annotation);System.out.println(v);}}
}@A("dmy")
class B{@A(value="dongmingyu",i="zs")@SuppressWarnings("all")int i ;
}

补充：所有的注解，都默认继承Annotation父注解类型

5 特殊情况的注解使用

注解的重复使用
- 默认情况下，无法使用两个相同的注解，修饰同一个类信息
- 以前解决方案是定义一个新注解，新注解中有一个数组属性，可以包含多个所需要注解

@Target({ElementType.FIELD,ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
public @interface AS {A[] value();
}

@AS({@A("zs") ,@A("ls") , @A("ww")
})
class B{}

现在可以在注解上使用另一个注解@Repeatable(AS.class) 指定当前注解重复出现的时候，会自动的将重复的注解组成指定的那个@AS注解

@AS还需要正常定义

@Target({ElementType.FIELD,ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Repeatable(AS.class)
public @interface A {}@Target({ElementType.FIELD,ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
public @interface AS {A[] value();
}

@A("zs")
@A("ls")
@A("ww")
class C{}

函数式接口

这是lambda表达式相关的一个概念
lambda表达式针对的必须是接口，而且只能有一个抽象方法。这样的接口就称为函数式接口
函数式接口，可以使用@FunctionalInterface声明。在编译就会按照函数式接口的特点进行检测

@FunctionalInterface
interface A{void t1();
}

使用注解声明，必须是函数式接口
函数式接口，不一定使用注解声明