关于@RequestBody,@PathVariable,无注解使用及说明

// 场景1：用户登录 - 敏感数据
@PostMapping("/login")
public Result<EmployeeLoginVO> login(@RequestBody EmployeeLoginDTO employeeLoginDTO) {
    // 原因：用户名密码敏感，需要在请求体中加密传输
}

// 场景2：新增员工 - 复杂对象
@PostMapping
public Result save(@RequestBody EmployeeDTO employeeDTO) {
    // 原因：多个字段的复杂对象，JSON格式更清晰
}

// 场景3：修改员工信息 - 更新操作
@PutMapping
public Result update(@RequestBody EmployeeDTO employeeDTO) {
    // 原因：修改操作通常用PUT，需要传递完整对象
}

// 场景4：批量操作
@PostMapping("/batch")
public Result batchSave(@RequestBody List<EmployeeDTO> employees) {
    // 原因：批量数据，数组/列表格式
}

// 场景1：根据ID查询 - 资源标识
@GetMapping("/{id}")
public Result<Employee> getById(@PathVariable Long id) {
    // URL: /admin/employee/123
    // 原因：ID是资源的唯一标识符
}

// 场景2：根据ID删除 - 资源操作
@DeleteMapping("/{id}")
public Result delete(@PathVariable Long id) {
    // URL: /admin/employee/123
    // 原因：明确指定要删除的资源
}

// 场景3：状态切换 - 动作+资源
@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：简单参数查询
@GetMapping("/search")
public Result<List<Employee>> search(String keyword, Integer status) {
    // URL: /admin/employee/search?keyword=张三&status=1
    // 原因：简单的过滤条件
}

// 场景3：可选参数查询
@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 (敏感数据)
    @PostMapping("/login")
    public Result<EmployeeLoginVO> login(@RequestBody EmployeeLoginDTO dto) {
        // POST /admin/employee/login + JSON
    }

    // 2. 新增 - @RequestBody (复杂对象)
    @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. 根据ID查询 - @PathVariable (资源标识)
    @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 + 无注解 (状态+ID)
    @PostMapping("/status/{status}")
    public Result startOrStop(@PathVariable Integer status, Long id) {
        // POST /admin/employee/status/1?id=123
    }

    // 7. 删除 - @PathVariable (资源标识)
    @DeleteMapping("/{id}")
    public Result delete(@PathVariable Long id) {
        // DELETE /admin/employee/123
    }
}

是否传输复杂对象或敏感数据？
├─ 是 → 使用 @RequestBody (POST/PUT + JSON)
└─ 否 → 是否资源标识符？
    ├─ 是 → 使用 @PathVariable (/{id})
    └─ 否 → 无注解 (URL参数，GET请求)

// 组合1：路径参数 + 查询参数
@GetMapping("/department/{deptId}/employees")
public Result getEmployeesByDept(@PathVariable Long deptId, 
                                String keyword, 
                                Integer page) {
    // GET /admin/department/10/employees?keyword=张&page=1
}

// 组合2：路径参数 + 请求体
@PutMapping("/{id}")
public Result update(@PathVariable Long id, 
                    @RequestBody EmployeeDTO dto) {
    // PUT /admin/employee/123 + JSON
    // ID确定资源，DTO包含更新数据
}