// 場景1：用戶登錄 - 敏感數(shù)據(jù)
@PostMapping("/login")
public Result<EmployeeLoginVO> login(@RequestBody EmployeeLoginDTO employeeLoginDTO) {
    // 原因：用戶名密碼敏感，需要在請求體中加密傳輸
}

// 場景2：新增員工 - 復(fù)雜對象
@PostMapping
public Result save(@RequestBody EmployeeDTO employeeDTO) {
    // 原因：多個(gè)字段的復(fù)雜對象，JSON格式更清晰
}

// 場景3：修改員工信息 - 更新操作
@PutMapping
public Result update(@RequestBody EmployeeDTO employeeDTO) {
    // 原因：修改操作通常用PUT，需要傳遞完整對象
}

// 場景4：批量操作
@PostMapping("/batch")
public Result batchSave(@RequestBody List<EmployeeDTO> employees) {
    // 原因：批量數(shù)據(jù)，數(shù)組/列表格式
}

// 場景1：根據(jù)ID查詢 - 資源標(biāo)識
@GetMapping("/{id}")
public Result<Employee> getById(@PathVariable Long id) {
    // URL: /admin/employee/123
    // 原因：ID是資源的唯一標(biāo)識符
}

// 場景2：根據(jù)ID刪除 - 資源操作
@DeleteMapping("/{id}")
public Result delete(@PathVariable Long id) {
    // URL: /admin/employee/123
    // 原因：明確指定要?jiǎng)h除的資源
}

// 場景3：狀態(tài)切換 - 動(dòng)作+資源
@PostMapping("/status/{status}")
public Result startOrStop(@PathVariable Integer status, Long id) {
    // URL: /admin/employee/status/1?id=123
    // 原因：status是操作類型，屬于URL路徑的一部分
}

// 場景4：多級資源路徑
@GetMapping("/department/{deptId}/employees/{empId}")
public Result getEmployeeInDept(@PathVariable Long deptId, @PathVariable Long empId) {
    // URL: /admin/department/10/employees/123
    // 原因：表示部門下的特定員工資源
}

// 場景1：分頁查詢 - 查詢條件
@GetMapping("/page")
public Result<PageResult> page(EmployeePageQueryDTO employeePageQueryDTO) {
    // URL: /admin/employee/page?name=張&page=1&pageSize=10
    // 原因：簡單查詢條件，支持緩存和書簽
}

// 場景2：簡單參數(shù)查詢
@GetMapping("/search")
public Result<List<Employee>> search(String keyword, Integer status) {
    // URL: /admin/employee/search?keyword=張三&status=1
    // 原因：簡單的過濾條件
}

// 場景3：可選參數(shù)查詢
@GetMapping("/list")
public Result<List<Employee>> list(String department, Integer level) {
    // URL: /admin/employee/list?department=IT&level=2
    // 原因：可選的查詢條件，可以為空
}

@RestController
@RequestMapping("/admin/employee")
public class EmployeeController {

    // 1. 登錄 - @RequestBody (敏感數(shù)據(jù))
    @PostMapping("/login")
    public Result<EmployeeLoginVO> login(@RequestBody EmployeeLoginDTO dto) {
        // POST /admin/employee/login + JSON
    }

    // 2. 新增 - @RequestBody (復(fù)雜對象)
    @PostMapping
    public Result save(@RequestBody EmployeeDTO dto) {
        // POST /admin/employee + JSON
    }

    // 3. 分頁查詢 - 無注解 (查詢條件)
    @GetMapping("/page")
    public Result<PageResult> page(EmployeePageQueryDTO dto) {
        // GET /admin/employee/page?name=張&page=1&pageSize=10
    }

    // 4. 根據(jù)ID查詢 - @PathVariable (資源標(biāo)識)
    @GetMapping("/{id}")
    public Result<Employee> getById(@PathVariable Long id) {
        // GET /admin/employee/123
    }

    // 5. 修改 - @RequestBody (更新對象)
    @PutMapping
    public Result update(@RequestBody EmployeeDTO dto) {
        // PUT /admin/employee + JSON
    }

    // 6. 啟用禁用 - @PathVariable + 無注解 (狀態(tài)+ID)
    @PostMapping("/status/{status}")
    public Result startOrStop(@PathVariable Integer status, Long id) {
        // POST /admin/employee/status/1?id=123
    }

    // 7. 刪除 - @PathVariable (資源標(biāo)識)
    @DeleteMapping("/{id}")
    public Result delete(@PathVariable Long id) {
        // DELETE /admin/employee/123
    }
}

是否傳輸復(fù)雜對象或敏感數(shù)據(jù)？
├─ 是 → 使用 @RequestBody (POST/PUT + JSON)
└─ 否 → 是否資源標(biāo)識符？
    ├─ 是 → 使用 @PathVariable (/{id})
    └─ 否 → 無注解 (URL參數(shù)，GET請求)

// 組合1：路徑參數(shù) + 查詢參數(shù)
@GetMapping("/department/{deptId}/employees")
public Result getEmployeesByDept(@PathVariable Long deptId, 
                                String keyword, 
                                Integer page) {
    // GET /admin/department/10/employees?keyword=張&page=1
}

// 組合2：路徑參數(shù) + 請求體
@PutMapping("/{id}")
public Result update(@PathVariable Long id, 
                    @RequestBody EmployeeDTO dto) {
    // PUT /admin/employee/123 + JSON
    // ID確定資源，DTO包含更新數(shù)據(jù)
}