swagger使用记录

1. 自定义下拉列表

@ApiImplicitParam注解和@ApiModelProperty注解中都有allowableValues属性, 都可以产生下拉列表.

不同之处在于:

1. @ApiImplicitParam注解中allowableValues生成下拉列表的顺序在其他类型产生的下拉列表之后,会覆盖其他类型产生的下拉列表,如enum类. 而@ApiModelProperty注解中的allowableValues生成的下拉列表会被enum类生成的下拉列表覆盖. 

2. @ApiImplicitParam注解有属性allowMultiple,当其等于true时 ,allowableValues产生的下拉列表是多选的, 而@ApiModelProperty没有allowMultiple属性.

 

2.在Controller层的接口参数中加@NotNull注解后, 参数的类型变成了body

在使用中, 需要加上@RequestParam注解之后再加@NotNull注解.

@RequestParam注解的作用是传递参数, 用于将请求参数区数据映射到功能处理方法的参数上。默认属性required=true,也就是说,如果我们在参数中不传被该注解修饰的参数,则无法访问到该接口.