swagger jsr304

### 如何在 Swagger 中实现 JSR304 Bean Validation 1.1 规范支持

为了使 Swagger 支持并展示基于 JSR304 (Bean Validation 1.1) 的验证规则，在 Spring Boot 应用程序中除了常规的 Swagger 配置外，还需要引入特定依赖项以及适当配置。

#### 添加 Maven 或 Gradle 依赖
确保项目包含了 `spring-boot-starter-validation` 和 `springfox-swagger2` 及其 UI 组件的相关依赖。对于 Maven 用户来说，应该像这样添加到 pom.xml 文件：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

<!-- 如果尚未包含 -->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>${springfox.version}</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>${springfox.version}</version>
</dependency>

#### 导入必要的配置类
在 Swagger 配置类上需导入用于处理 BeanValidation 插件的配置文件，这可以通过使用 `@Import` 注解来完成[^1]。

@Configuration
@EnableSwagger2
@Import(BeanValidatorPluginsConfiguration.class)
public class SpringFoxConfig {
}

#### 使用注解进行字段级约束
通过应用来自 javax.validation.constraints 包下的各种注解（例如 @NotNull, @Size 等），可以为 DTO 类中的属性指定验证条件。这些注解会自动被 Hibernate Validator 解析，并且当 API 文档生成时也会反映出来。

public class UserDTO {

    @NotBlank(message = "用户名不能为空")
    private String username;

    @Email(message = "邮箱地址格式不正确")
    @Size(max=50,message="长度不能超过50个字符")
    private String email;
    
    // getters and setters omitted...
}

一旦完成了上述设置之后，启动应用程序访问 `/v2/api-docs` 接口即可看到详细的 API 文档信息，其中也包括了由 Bean Validation 定义的数据校验规则描述[^3]。