Springboot学习记录day3--注解以及注解类

一、关于@Target和Retention

注解@Target和@Retention可以用来修饰注解，是注解的注解。

@Target :  即该注解可以声明在哪些目标元素之前，也可理解为注释类型的程序元素的种类。

ElementType.PACKAGE：该注解只能声明在一个包名前。 

ElementType.ANNOTATION_TYPE：该注解只能声明在一个注解类型前。 

ElementType.TYPE：该注解只能声明在一个类前。

ElementType.CONSTRUCTOR：该注解只能声明在一个类的构造方法前。

ElementType.LOCAL_VARIABLE：该注解只能声明在一个局部变量前。

ElementType.METHOD：该注解只能声明在一个类的方法前。

ElementType.PARAMETER：该注解只能声明在一个方法参数前。

ElementType.FIELD：该注解只能声明在一个类的字段前。

@Retention ：注解类的生命周期。 

RetentionPolicy.SOURCE  : 注解只保留在源文件，当Java文件编译成class文件的时候，注解被遗弃；

RetentionPolicy.CLASS  : 注解被保留到class文件，但jvm加载class文件时候被遗弃，这是默认的生命周期；

RetentionPolicy.RUNTIME  : 注解不仅被保存到class文件中，jvm加载class文件之后，仍然存在；
                        
以上文字来源：https://blog.youkuaiyun.com/Zero_uou/article/details/107819201

比如说，我在这个项目中写的：

@Target({ElementType.TYPE, ElementType.METHOD, ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface AccessRole {
    SysUser.Type[] value() default {};
}

我定义了一个注解类AccessRole，我用@Target来说明这个注解类可以在一个类前、一个类的方法前、一个类的字段前、一个方法的参数前被声明。用@Retention来表明，这个注解类不仅被保存到class文件中，jvm加载class文件后仍然存在。

二、关于注解类

关于@Documentd：是一个元注解，即可以修饰其他注解的注解。

它的作用是，如果有它，那么被@AccessRole修饰的类在最终生成的文档中就会显示@AccessRole；倘若这里没有@Documentd，则最终生成的文档就不会有@AccessRole这个标识

接口内语句的话得意思是：@AccessRole注解定义了一个名为value的元素，它可以接受SysUser.Type枚举的数组。default {}表示如果没有为@UserTypes注解的value元素提供值，那么它将默认为一个空的枚举数组。

三、关于@RestController和@Controller

@Controller：是用于定义控制器的注解，用于处理客户端请求，并负责返回适当的视图作为响应。在@Controller注解的类当中，通常需要在方法上使用@ResponseBody注解来指示该方法的返回值作为响应的主体内容，而不是解析为视图。（若没有@RespnseBody，则默认返回是以视图为格式）

@RestController：相当于@Controller和@ResponseBody注解功能的结合。若该类被标记，则每个方法的返回值都会以JSON or XML的形式写入HTTP响应体中，相当于每个方法上都加了@ResponseBody注解（默认返回是数据格式）

讲的特别清楚明白的：【SpringBoot】带你一文彻底搞懂RestController和Controller的关系与区别-优快云博客