<dependencies>
        <!-- Spring Web 核心依賴 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!-- 測試依賴 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <!-- Knife4j OpenAPI3 適配SpringBoot3.x(Jakarta) -->
        <dependency>
            <groupId>com.github.xiaoymin</groupId>
            <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
            <version>4.3.0</version>
        </dependency>
        <!-- Lombok 簡化實(shí)體代碼 -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
    </dependencies>

# 服務(wù)器端口（可選，默認(rèn)8080）
server:
  port: 8080
# SpringDoc 核心配置
springdoc:
  info:
    title: "用戶管理系統(tǒng)API" # 接口文檔標(biāo)題
    version: "v1.0.0" # 接口文檔版本
    description: "基于SpringDoc+Knife4j的接口文檔示例，集成數(shù)據(jù)校驗(yàn)功能" # 接口文檔描述
# Knife4j 增強(qiáng)配置
knife4j:
  enable: true # 開啟Knife4j所有增強(qiáng)功能（核心）
  setting:
    language: zh_cn # 界面默認(rèn)語言：中文
    enable-footer: false # 關(guān)閉底部版權(quán)信息（可選，美化界面）
    enable-request-cache: false # 關(guān)閉請(qǐng)求緩存（可選）

import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.Min;
import jakarta.validation.constraints.Max;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
/**
 * 用戶信息實(shí)體
 */
@Schema(name = "User", description = "用戶信息實(shí)體，包含用戶名、年齡核心字段")
@Data // 生成get/set/toString等方法
@AllArgsConstructor // 全參構(gòu)造
@NoArgsConstructor // 無參構(gòu)造
public class User {
    @Schema(description = "用戶名", required = true, example = "張三")
    @NotBlank(message = "用戶名不能為空") // 非空校驗(yàn)：字符串不能為null、空字符串、純空格
    private String name;
    @Schema(description = "用戶年齡", required = false, example = "25", minimum = "1", maximum = "120")
    @NotNull(message = "年齡不能為null") // 非null校驗(yàn)
    @Min(value = 1, message = "年齡不能小于1歲") // 最小值校驗(yàn)
    @Max(value = 120, message = "年齡不能大于120歲") // 最大值校驗(yàn)
    private Integer age;
}

import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.v3.oas.annotations.Parameters;
import io.swagger.v3.oas.annotations.enums.ParameterIn;
import io.swagger.v3.oas.annotations.media.Content;
import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.v3.oas.annotations.responses.ApiResponse;
import io.swagger.v3.oas.annotations.tags.Tag;
import jakarta.validation.Valid;
import com.ruangong.springbootdemo2.pojo.User;
import org.springframework.web.bind.annotation.*;

// 1. @Tag:Controller 級(jí)別的接口分類
@Tag(name = "用戶管理接口", description = "用戶新增、查詢、修改、刪除操作")
@RestController
@RequestMapping("/user")
public class UserController {

    // 2. @Operation:方法級(jí)別的接口描述
    @Operation(
        summary = "新增用戶", // 接口簡短描述
        description = "傳入用戶信息，新增一條用戶記錄（用戶名不能為空）", // 詳細(xì)描述
        // 3. @ApiResponse:定義接口響應(yīng)結(jié)果
        responses = {
            @ApiResponse(responseCode = "200", description = "新增成功",
                content = @Content(schema = @Schema(implementation = String.class))),
            @ApiResponse(responseCode = "400", description = "參數(shù)校驗(yàn)失敗")
        }
    )
    @PostMapping
    public String addUser(@Valid @RequestBody User user) {
        return "新增用戶成功:" + user.getName();
    }

    // 4. @Parameters/@Parameter:描述路徑/請(qǐng)求參數(shù)
    @Operation(summary = "根據(jù)ID查詢用戶")
    @Parameters({
        @Parameter(name = "id", description = "用戶ID", required = true, in = ParameterIn.PATH, example = "1001")
    })
    @GetMapping("/{id}")
    public User getUserById(@PathVariable Long id) {
        User user = new User();
        user.setName("張三");
        user.setAge(25);
        return user;
    }
}