REST接口开发中怎么使用 @DeleteMapping 处理删除请求-java教程-PHP中文网

@deletemapping是spring mvc中用于映射http delete请求的快捷注解，语义清晰、代码简洁，本质为@requestmapping(method = requestmethod.delete)的特化；常通过@pathvariable接收路径id或@requestparam接收批量id实现资源删除，需遵循幂等性与权限校验。

rest接口开发中怎么使用 @deletemapping 处理删除请求

@DeleteMapping 是 Spring MVC 提供的注解，用于将 HTTP DELETE 请求映射到控制器方法，常用于实现资源删除逻辑。它本质是 @RequestMapping(method = RequestMethod.DELETE) 的快捷写法，语义更清晰、代码更简洁。

基本用法：绑定路径和参数

最常见的是根据路径变量（如 ID）删除单个资源：

使用 {id} 占位符接收 URL 中的路径参数，配合 @PathVariable 获取值
返回值通常为 void、ResponseEntity> 或简单状态对象，便于前端判断结果

示例：

@DeleteMapping("/users/{id}")
public ResponseEntity<string> deleteUser(@PathVariable Long id) {
    boolean deleted = userService.removeById(id);
    if (deleted) {
        return ResponseEntity.ok("用户已删除");
    } else {
        return ResponseEntity.notFound().build();
    }
}</string>

处理批量删除（多个 ID）

DELETE 请求通常不带请求体（虽 HTTP 规范允许），但实际开发中常通过以下方式传多个 ID：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

路径参数数组：如 /users/{id1}/{id2}/{id3} —— 不推荐，灵活性差
查询参数：如 DELETE /users?id=1&id=2&id=3，用 @RequestParam List<long> id</long> 接收
请求体（JSON）：需显式配置支持（Spring Boot 2.6+ 默认禁用），并在方法中用 @RequestBody 接收对象（如 List<long></long> 或封装类）

推荐使用查询参数方式，语义明确且兼容性好：

@DeleteMapping("/users")
public ResponseEntity<void> deleteUsers(@RequestParam List<long> id) {
    userService.removeBatchByIds(id);
    return ResponseEntity.noContent().build();
}</long></void>

注意 REST 设计规范与安全性

DELETE 应该是幂等的（多次调用效果相同），且不应用于影响非目标资源的操作：

避免在 DELETE 方法中执行“软删转硬删”“级联清理日志”等副作用过大的操作，除非业务明确要求
务必校验权限，例如当前用户是否有权删除该资源（可用 @PreAuthorize 或手动检查）
建议返回合适的状态码：200 OK（含响应体）、204 No Content（成功无返回）、404 Not Found（资源不存在）、403 Forbidden（无权限）

前端调用 DELETE 的常见方式

AJAX 请求需显式指定 method 为 DELETE，并注意跨域和认证头：

Fetch API 示例：fetch('/api/users/123', { method: 'DELETE', headers: { 'Authorization': 'Bearer xxx' } })
Axios 示例：axios.delete('/api/users/123', { headers: { ... } })
确保后端 CORS 配置允许 DELETE 方法（如 allowedMethods = ["GET", "POST", "PUT", "DELETE"]）