注解总汇

一、@Configuration

@Configuration注解该类，等价于XML中配置beans；

二、@Bean

@Bean标注方法等价于XML中配置bean。

三、@EnableSwagger2

在类上加上@EnableSwagger2的注解开启swagger

四、VO字段验证

@AssertFalse

验证的数据类型 ：Boolean,boolean
说明 ：验证注解的元素值是false

@AssertTrue

验证的数据类型 ：Boolean,boolean
说明 ：验证注解的元素值是true

@NotNull

验证的数据类型 ：任意类型
说明 ：验证注解的元素值不是null

@Null

验证的数据类型 ：任意类型
说明 ：验证注解的元素值是null

@Min(value=值)

验证的数据类型 ：BigDecimal，BigInteger, byte,short, int, long，等任何Number或CharSequence（存储的是数字）子类型
说明 ：验证注解的元素值大于等于@Min指定的value值

@Max（value=值）

验证的数据类型 ：和@Min要求一样
说明 ：验证注解的元素值小于等于@Max指定的value值

@DecimalMin(value=值)

验证的数据类型 ：和@Min要求一样
说明 ：验证注解的元素值大于等于@ DecimalMin指定的value值

@DecimalMax(value=值)

验证的数据类型 ：和@Min要求一样
说明 ：验证注解的元素值小于等于@ DecimalMax指定的value值

@Digits(integer=整数位数, fraction=小数位数)

验证的数据类型 ：和@Min要求一样
说明 ：验证注解的元素值的整数位数和小数位数上限

@Size(min=下限, max=上限)

验证的数据类型 ：字符串、Collection、Map、数组等
说明 ：验证注解的元素值的在min和max（包含）指定区间之内，如字符长度、集合大小

@Past

验证的数据类型 ：java.util.Date，java.util.Calendar，Joda Time类库的日期类型
说明 ：验证注解的元素值（日期类型）比当前时间早

@Future

验证的数据类型 ：与@Past要求一样
说明 ：验证注解的元素值（日期类型）比当前时间晚

@NotBlank

验证的数据类型 ：CharSequence子类型
说明 ：验证注解的元素值不为空（不为null、去除首位空格后长度为0），不同于@NotEmpty，@NotBlank只应用于字符串且在比较时会去除字符串的首位空格

@Length(min=下限, max=上限)

验证的数据类型 ： CharSequence子类型
说明 ：验证注解的元素值长度在min和max区间内

@NotEmpty

验证的数据类型 ：CharSequence子类型、Collection、Map、数组
说明 ：验证注解的元素值不为null且不为空（字符串长度不为0、集合大小不为0）

@Range(min=最小值, max=最大值)

验证的数据类型 ：BigDecimal,BigInteger,CharSequence, byte, short, int, long等原子类型和包装类型
说明 ：验证注解的元素值在最小值和最大值之间

@Email(regexp=正则表达式,flag=标志的模式)
验证的数据类型 ：CharSequence子类型（如String）
说明 ：验证注解的元素值是Email，也可以通过regexp和flag指定自定义的email格式

@Pattern(regexp=正则表达式,flag=标志的模式)

验证的数据类型 ：String，任何CharSequence的子类型
说明 ：验证注解的元素值与指定的正则表达式匹配

@Valid

验证的数据类型 ：任何非原子类型
说明 ：指定递归验证关联的对象；如用户对象中有个地址对象属性，如果想在验证用户对象时一起验证地址对象的话，在地址对象上加@Valid注解即可级联验证

五、@Controller @Service @Controller和 @Component

注册一个action 到spring 上下文中，bean 的ID 默认为类名称开头字母小写。
@Repository、@Service 和@Controller。这 3 个注解和 @Component 是等效的，但是从注解类的命名上，很容易看出这 3 个注解分别和持久层、业务层和控制层（Web 层）相对应。虽然目前这 3 个注解和 @Component 相比没有什么新意，但 Spring 将在以后的版本中为它们添加特殊的功能。所以，如果 Web 应用程序采用了经典的三层分层结构的话，最好在持久层、业务层和控制层分别采用@Repository、@Service 和 @Controller 对分层中的类进行注解，而用 @Component 对那些比较中立的类进行注解。

@Autowired

以byType的方式对类成员变量、方法及构造函数进行标注，完成自动装配的工作。Spring 将直接采用 Java 反射机制对 类 中的 私有成员变量进行自动注入。所以对成员变量使用 @Autowired 后，可将它们的getter和setter 方法删除。

@Resource

@Resource 的作用相当于 @Autowired，只不过 @Autowired 按 byType 自动注入，而 @Resource 默认按 byName 自动注入。@Resource 有两个属性是比较重要的，分别是 name 和 type，Spring 将 @Resource 注解的 name 属性解析为 Bean 的名字，而 type 属性则解析为 Bean 的类型。所以如果使用 name 属性，则使用 byName 的自动注入策略，而使用 type 属性时则使用 byType 自动注入策略。如果既不指定 name 也不指定 type 属性，这时将通过反射机制使用 byName 自动注入策略。

@PostConstruct 和 @PreDestroy

只需要在方法前标注 @PostConstruct 或 @PreDestroy，这些方法就会在 Bean 初始化后或销毁之前被 Spring 容器执行， 常用于对静态变量的处理。

@ResponseBody

将Controller的方法返回的对象，通过适当的HttpMessageConverter转换为指定格式后，写入到Response对象的body数据区。

@RequestMapping

将URL映射到类或方法上。

@FeignClient

使用Spring Cloud搭建各种微服务之后，服务可以通过@FeignClient使用和发现服务场中的其他服务。

@RequestHeader

— value ：参数名称

— required ：是否必须，默认为true，表示请求参数中必须包含对应的参数，否则抛出异常。

— defaultValue：当请求参数缺少或者有请求参数但值为空时，值采用该设置值。

请求头包含若个属性，服务器可根据请求头属性信息获取客户端的信息，通过@RequestHeader既可以将请求头的属性值绑定到处理方法的入参中