常见注解说明(补充中...)

---

@API

使用在类上，表明是swagger资源，
@API拥有两个属性:value、tags，生成的api文档会根据tags分类,

直白的说就是这个controller中的所有接口生成的接口文档都会在tags这个list下；tags如果有多个值，会生成多个list，每个list都显示所有接口

value的作用类似tags,但是不能有多个值 同样是swagger包下的注解

@ApiOperation

描述一个类的一个方法，或者说一个接口;

参数说明 :@ApiOperation(value = “接口说明”, httpMethod = “接口请求方式”, response = “接口返回参数类型”, notes = “接口发布说明”； 它不是spring自带的注解, 而是swagger里的,
( import io.swagger.annotations.ApiOperation;)

@Autowired

@Component

@Configuration

@Controller

@Data

相当于 @Getter@Setter @RequiredArgsConstructor @ToString @EqualsAndHashCode @Value几个注解的集合,
主要作用是提高代码的简洁，一般用于实体类上,使用这个注解可以省去代码中大量的get ()、set ()、toString ()等方法；
要使用 @Data 注解要先引入lombok，
(import lombok.Data;)

@Documented

指示具有某种类型的注释在默认情况下将由javadoc和类似工具进行文档记录. 
这种类型应该用于注释类型的声明,这些类型的注释会影响客户端对已注释元素的使用. 如果类型声明使用该注解注释,
那么他的注释	将成为注释元素的公共Api的一部分	 

@EqualsAndHashCode(callSuper=false)

这个注解的作用就是自动的给model bean实现equals方法和hashcode方法。

1. 此注解会生成equals(Object other) 和 hashCode()方法。
2. 它默认使用非静态，非瞬态的属性
3. 可通过参数exclude排除一些属性
4. 可通过参数of指定仅使用哪些属性
5. 它默认仅使用该类中定义的属性且不调用父类的方法
6. 可通过callSupe