请问用japidocs生成接口文档,请求体没值,是有加注释的
该回答引用GPTᴼᴾᴱᴺᴬᴵ
确保在使用 Japidocs 生成接口文档时,已经正确地添加了请求体的注释。
通常,Japidocs 使用类注释中的 @param 标签生成请求体。例如,如果您有一个 POST 请求并且需要一个 JSON 对象作为请求体,则可以在请求处理方法中添加类似以下注释:
/**
* 创建用户
*
* @param user 用户对象
* @return 成功则返回创建的用户对象,否则返回错误信息
*/
@PostMapping("/users")
public ResponseEntity<?> createUser(@RequestBody User user) {
// 处理创建用户的逻辑
}
在这个例子中,@RequestBody 注解告诉 SpringMVC,要将请求体中的 JSON 对象映射到 User 对象中,而 @param 注释告诉 Japidocs 要在接口文档中显示一个 JSON 请求体示例。
如果您的请求体没有显示在 Japidocs 生成的接口文档中,请检查您的注释是否正确,并确保您已经正确地指定了请求体的格式。
关闭自动生成config.setAutoGenerate(Boolean.FALSE),使用@ApiDoc 来一个个接口导出排查问题。