@ApiParam使用

@ApiParam 是一个 Swagger 注解，它用于对 API 接口的参数进行描述。通常情况下，我们会在 Controller 类中的方法参数中使用 @ApiParam 注解。

例如：

@PostMapping("/user")
public User addUser(@ApiParam(value = "用户对象", required = true) @RequestBody User user) {
    return userService.addUser(user);
}

在这个例子中，@ApiParam 注解用于描述 addUser 方法的参数 user，value 属性用于描述参数的作用，required 属性用于描述参数是否必须。

使用 @ApiParam 注解可以使 API 接口文档更加清晰易懂，方便开发者理解接口的用途和参数的含义。同时，也可以提高接口的可读性和可维护性。