Swagger注解及参数细节的正确书写。

今天新开了一个api文件，结果怎么搞也在swagger里显示不出来，浪费半天后，去问老员工了。

一般有俩原因，

1.idea缓存，重启idea即可。

2.注解和参数上的修饰有问题，或者请求method不对。

下面说一下在书写上几个需要注意的点。

1.对于无参方法（一般是后端调用的inner方法），一般不会出错。

2.首先区分get请求还是post请求

 

 

入参是dto对象的都用post请求，即@PostMapping，这样才能解析json格式数据。在参数前面加上 @RequestBody注解，注意dataType要写对应的dto类型，name要与参数名一致。

还要加上这个值 paramType = "body"。　　

 

 注意在controller层中也要加，@RequestParam 不用在controller中加了。

3.对于list<>列表型入参，也需要用 @RequestBody注解修饰，dataType一般是String

 

 4.对于get请求，@GetMapping，一般是单个入参，

 

 在参数前面加@RequestParam（），其实get请求加@RequestBody还是@RequestParam（）都行。

5.最后要在controller和service层impl里加上对应的注解

@RestController和  @Service