自定义注解

什么是注解？

Java 注解（Annotation）又称 Java标注，是 JDK5.0 引入的一种注释机制。

定义：注解（Annotation），也叫元数据。一种代码级别的说明。它是JDK1.5及以后版本引入的一个特性，与类、接口、枚举是在同一个层次。它可以声明在包、类、字段、方法、局部变量、方法参数等的前面，用来对这些元素进行说明，注释。

注解分为哪几种？

注解又分为内置注解和自定义注解两种。内置注解就是JDK自带的注解，又名元数据。

内置注解
@Override - 检查该方法是否是重载方法。如果发现其父类，或者是引用的接口中并没有该方法时，会报编译错误。
@Deprecated - 标记过时方法。如果使用该方法，会报编译警告。
@SuppressWarnings - 指示编译器去忽略注解中声明的警告。
作用在其他注解的注解(或者说 元注解)是:
@Retention - 标识这个注解怎么保存，是只在代码中，还是编入class文件中，或者是在运行时可以通过反射访问。
@Documented - 标记这些注解是否包含在用户文档中。
@Target - 标记这个注解应该是哪种 Java成员。
@Inherited - 标记这个注解是继承于哪个注解类(默认 注解并没有继承于任何子类)
从 Java 7 开始，额外添加了 3 个注解:
@SafeVarargs - Java 7 开始支持，忽略任何使用参数为泛型变量的方法或构造函数调用产生的警告。
@FunctionalInterface - Java 8 开始支持，标识一个匿名函数或函数式接口。
@Repeatable - Java 8 开始支持，标识某注解可以在同一个声明上使用多次。

自定义注解
Spring框架中大量使用的注解大多数都是为自定义注解。

如何自定义一个注解？

自定义一个注解，需要创建一个annotation类型的类(Class)，如下所示。

public @interface MyAnnotation {
	// 自定义注解，类名前面是 “@+interface”
}

注解还不完整，没有表明能用在哪里，是否支持反射等等，我们继续给他添加一些JDK内置的注解，完善自定义注解。

// @Target 其实就是表示使用范围只能在方法上
@Target(ElementType.METHOD) 
/* @Retention 表示需要在什么级别保存该注释信息，
用于描述注解的生命周期（即：被描述的注解在什么范围内有效*/
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {

}

@Target 注解
@Target说明了Annotation所修饰的对象范围：Annotation可被用于 packages、types（类、接口、枚举、Annotation类型）、类型成员（方法、构造方法、成员变量、枚举值）、方法参数和本地变量（如循环变量、catch参数）。在Annotation类型的声明中使用了target可更加明晰其修饰的目标。

1. CONSTRUCTOR:用于描述构造器
2. FIELD:用于描述域
3. LOCAL_VARIABLE:用于描述局部变量
4. METHOD:用于描述方法
5. PACKAGE:用于描述包
6. PARAMETER:用于描述参数
7. TYPE:用于描述类、接口(包括注解类型) 或enum声明

我们自定义的注解就基本完成了，但是还不够完善，我们在开发SpringBoot项目当中使用到大量的注解，点开源码可以发现是可以传值的，比如@Service("userService")注解。

// 自定义注解类
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
	
	String value() default "";
	
	int order() default 0;
	
//	int max();
	
//	String[] arrays();
	
}

// 我在注解类中写了一个测试类（懒得重建个类演示）
class MainTest{
	
	@MyAnnotation("myAnnotation")
	public void testAnnotaion0() {
	
	}
	
	
//	@MyAnnotation(arrays = { "1" }, max = 100)
	public void testAnnotaion1() {
	
	}
	
//	@MyAnnotation(value="2", arrays = { "3","4" }, max = 200)
	public void testAnnotaion2() {
		
	}
	
}

这样