🔥码云GVP开源项目 12k star Uniapp+ElementUI 功能强大 支持多语言、二开方便! 广告
Spring Doc 可以自动生成 JSR303 文档,但不能约束,需要约束还要再引入坐标`spring-boot-starter-validation`。 ```xml <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-validation</artifactId> </dependency> ``` Spring Doc 的坐标`springdoc-openapi-starter-webmvc-ui`已自动引入 JSR303 规范。 ```xml <dependency> <groupId>org.springdoc</groupId> <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId> <version>2.2.0</version> </dependency> ``` <br/> 标记 JSR303 注解,即可自动生成 JSR303 文档。 ```java public class Student { @NotBlank(message = "学生姓名不能为空") private String name; @NotNull(message = "age不能为空") @Min(value = 0, message = "年龄不能小于0") @Max(value = 200, message = "年不能大于200") private Integer age; } ``` ![](https://img.kancloud.cn/1e/8e/1e8ed603cd0b86c712e007210b965df0_1608x306.png) >[info]提醒:实体只有被 controller 层引用才能生成文档。 ```java /** * Student 被 controller 层用做参数,或返回值 */ @PostMapping("/student/addStudent") public Student getStudent(@RequestBody Student student) { return student; } ```