常见注解积累（updating）

• Java内置注解

  • @Override ：重写，标识覆盖它的父类的方法
  • @Deprecated ：已过期，表示方法是不被建议使用的
  • @SuppressWarnings ：压制警告，抑制警告

• 元注解（作用在注解上的注解）

  • @Inherited ：使被它修饰的注解具有继承性，注意，仅针对类，成员属性、方法并不受此注释的影响
  • @Documented ：描述在使用 javadoc 工具为类生成帮助文档时是否要保留其注解信息
  • @Retention ：描述注解保留的时间范围
  • @Target ：描述注解的使用范围

• Spring中的注解

  • 声明bean的注解
    • @Component 组件，没有明确的角色
    • @Service 在业务逻辑层使用（service层）
    • @Repository 在数据访问层使用（dao层）
    • @Controller 在展现层使用，控制器的声明
  • 注入bean的注解
    • @Autowired 由Spring提供
  • @ConfigurationProperties 批量给bean绑定配置文件的配置
  • @Validated 对传入参数进行校验，具体校验注解如下图所示
    

• Swagger注解

  • @Api 用于修饰Controller类，生成Controller相关文档信息
  • @ApiOperation 用于修饰Controller类中的方法，生成接口方法相关文档信息
  • @ApiParam 用于修饰接口中的参数，生成接口参数相关文档信息
  • @ApiModelProperty 用于修饰实体类的属性，当实体类是请求参数或返回结果时，直接生成相关文档信息