springmvc 自动生成接口文档

Spring MVC提供了一种自动生成接口文档的方式，可以通过注解来实现。以下是一个示例：

@RestController
@RequestMapping("/api")
public class UserController {
    
    @ApiOperation(value = "获取用户信息", notes = "根据用户ID获取用户信息")
    @ApiImplicitParam(name = "userId", value = "用户ID", required = true, dataType = "Long", paramType = "path")
    @GetMapping("/users/{userId}")
    public User getUser(@PathVariable Long userId) {
        // 根据用户ID查询用户信息
        // ...
    }
    
    @ApiOperation(value = "创建用户", notes = "根据传入的用户信息创建用户")
    @ApiImplicitParam(name = "user", value = "用户信息", required = true, dataType = "User", paramType = "body")
    @PostMapping("/users")
    public User createUser(@RequestBody User user) {
        // 创建用户
        // ...
    }
    
    // 其他接口...
}

在上面的示例中，我们使用了`@ApiOperation`注解来描述接口的功能和说明，使用`@ApiImplicitParam`注解来描述接口的参数信息。这些注解可以帮助生成接口文档，并提供给前端、测试等人员查看和使用。

需要注意的是，为了能够自动生成接口文档，你需要在项目中引入相应的依赖，例如`springfox-swagger2`和`springfox-swagger-ui`。具体的配置和使用方法可以参考Springfox Swagger的官方文档。