Spring 注解

注解

0.注解定义

1.Annotation即注解（也被翻译为注释）

• 所有的注解会自动继承java.lang.annotation.Annotation（这个接口是一个常规接口，并非一个注解接口），并不能继承别的类或是接口
• 当一个注解的内部只有一个，且字段为value时，在使用的时候可以省略

2.自定义注解的使用：代码仓库见下

https://gitee.com/gqxm/gq-practice-glodon.git

• 自定义注解的简单使用：主要对ElementType.TYPE,METHOD,FIELD,PARAMETER等进行了测试和使用
• 自定义注解的简单使用：自定义NeedLogin注解，并且通过拦截器对其进行测试

1.jdk标准注解

1.元注解

JDK在java.lang.annotation包下提供了6个Meta注解（元注解），其中5个用于修饰其他的注解定义。

将一个注解应用到它自身上是合法的。例如，@Documented注解被自身为注解为@Documented。因此，针对注解的Javadoc文件可以表明它们是否可被归档。

1.@Target

ElementType

关于程序单元的枚举类型ElementType：

• TYPE：类、接口、注解、枚举
• FIELD：字段（含枚举值）
• METHOD：方法
• PARAMETER：形参（Formal parameter declaration）
• CONSTRUCTOR：构造方法
• LOCAL_VARIABLE：局部变量
• ANNOTATION_TYPE：注解类型
• PACKAGE：包
• TYPE_PARAMETER：类型参数
• TYPE_USE：类型用法

2.@Retention

RetentionPolicy

用于@Retention注解的保留策略：

3.@Inerited 详解

如果一个类具有继承注解（即被@Inherited修饰的注解），那么它的所有子类都自动具有相同的注解。

• 假设定义了一个继承注解@Persistent来指定一个类的对象可以存储到数据库中，那么该持久类的子类就会自动被注解为是持久性的。

  @Inherited
  @interface Persistent {
       
       
  }
  
  @Persistent
  class Employee {
       
       
  }
  
  class Manager extends Employee {
       
        // also @Persistent
  }
  

4.@Repeatable 详解

源码：

package java.lang.annotation;

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public @interface Repeatable {
   
   
    /**
     * Indicates the <em>containing annotation type</em> for the
     * repeatable annotation type.
     * @return the containing annotation type
     */
    Class<? extends Annotation> value();
}

对于Java SE 8来说，将同种类型的注解多次应用于某一项是合法的。为了向后兼容，可重复注解的实现者需要提供一个容器注解，它可以将这些重复注解存储到一个数组中

例子：

@Repeatable(TestRepeatables.class)
public @interface TestRepeatable {
   
   
    String content() default "请添加描述";
}

数组，用来存储

@Documented
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface TestRepeatables {
   
   
    TestRepeatable[] value();
}

@TestRepeatable(content = "张三")
@TestRepeatable(content = "李四")
@TestRepeatable(content = "王五")
public class Student {
   
   
}

@Slf4j
public class StudentTest {
   
   
    @Test
    public void testRepeatable() {
   
   
        Annotation[] annotations = Student.class.getAnnotations();
        for (Annotation annotation : annotations) {
   
   
            // 输出注解的名称
            log.info(annotation.annotationType().getName());
            TestRepeatables testRepeatables = (TestRepeatables) annotation;
            // 输出注解的内容
            for (TestRepeatable a : testRepeatables.value()) {
   
   
                System.out.println(a.content());
            }
        }
    }

}

2.用于编译的注解

6个基本的注解如下，除了@Generated位于javax.annotation包，其它均定义在java.lang包下：

3.用于管理资源的注解

2.Spring常用注解

1.@Required

The @Required annotation and RequiredAnnotationBeanPostProcessor are formally deprecated as of Spring Framework 5.1.

/** @deprecated */
@Deprecated
@Retention(RetentionPolicy.RUNTIME)
@Target({
    
    ElementType.METHOD})
public @interface Required {
    
    
}

The @Required annotation applies to bean property setter methods, as in the following example:

public class SimpleMovieLister {
   
   

    private MovieFinder movieFinder;

    @Required
    public void setMovieFinder(MovieFinder movieFinder) {
   
   
        this.movieFinder = movieFinder;
    }

    // ...
}

This annotation indicates that the affected bean property must be populated at configuration time, through an explicit property value in a bean definition or through autowiring.

2.@Autowired

很多情况下，JSR 330提供的@Inject注解可以替换@Autowired的作用。

@Autowired根据类型注入Bean，对应类型的Bean需要是单例的。

@Target({
   
   ElementType.CONSTRUCTOR, ElementType.METHOD, ElementType.