springboot详解--自定义注解

新增注解接口与新建class、interface一样，新建@interface即可。

形如下：

@Retention(RetentionPolicy.RUNTIME)
@Documented
@Target(ElementType.TYPE)
@Import(MmmAutoConfiguration.class)
public @interface EnableMmmClient {
}

@Retention(RetentionPolicy.RUNTIME)

运行时注解

1. RetentionPolicy.SOURCE：注解只保留在源文件，当Java文件编译成class文件的时候，注解被遗弃；
2. RetentionPolicy.CLASS：注解被保留到class文件，但jvm加载class文件时候被遗弃，这是默认的生命周期；
3. RetentionPolicy.RUNTIME：注解不仅被保存到class文件中，jvm加载class文件之后，仍然存在；

这3个生命周期分别对应于：Java源文件(.java文件) —> .class文件 —> 内存中的字节码。

@Documented

将此注解包含在 javadoc 中 ，它代表着此注解会被javadoc工具提取成文档。在doc文档中的内容会因为此注解的信息内容不同而不同。相当与@see,@param 等。

@Target

表示该注解用于什么地方，可能的值在枚举类 ElemenetType 中

1. ElemenetType.CONSTRUCTOR----------------------------构造器声明
2. ElemenetType.FIELD ---------------------------------域声明（包括 enum 实例）
3. ElemenetType.LOCAL_VARIABLE-------------------------局部变量声明
4. ElemenetType.METHOD --------------------------------方法声明
5. ElemenetType.PACKAGE -------------------------------包声明
6. ElemenetType.PARAMETER -----------------------------参数声明
7. ElemenetType.TYPE-----------------------------------类，接口（包括注解类型）或enum声明

@Import(MmmAutoConfiguration.class)

使用spring boot时，如果想自己实现一些初始设置比较复杂的bean时，可以在类上用@Configuration注解，然后类内部在返回具体bean的方法上使用@Bean注解。
那么如何让容器找到这个配置类呢？

1. 最简单的方法，当然是把它放到程序可以扫描到的package里，也就是@ComponentScan注解所指定的package里。
   平时自己创建的配置类通常用这种方法，简单明了。

2. 如果没有在package扫描路径里，比如引入的第三方包，可以通过META-INF/spring.factories里用org.springframework.boot.autoconfigure.EnableAutoConfiguration来制定。
   spring-boot-autoconfigure包里的配置类都是通过这种方式引入的。
   当然，这个方式需要程序使用@EnableAutoConfiguration注解，这个注解是通过AutoConfigurationImportSelector来扫描spring.factories文件，把定义的配置类引入的。

3. 使用@Import注解
   这个注解可以引入三种类
   a.使用了@Configuration注解的类：这个比较简单，如果明确知道需要引入哪个配置类，直接引入就可以。
   b.ImportSelector的子类
   c.ImportBeanDefinitionRegistrar的子类。

@Inherited

允许子类继承父类中的注解

一般使用@Import注解引入@Configuration注解的类即可实现功能，这样自定义注解就可以正常使用了。