通过 Spring RestTemplate 调用带请求体的 Delete 方法（Delete With Request Body）

最新推荐文章于 2025-04-29 09:18:42 发布

原创最新推荐文章于 2025-04-29 09:18:42 发布 · 2.2w 阅读

7 ·

CC 4.0 BY-SA版权

Java 同时被 2 个专栏收录

77 篇文章

订阅专栏

webservice

8 篇文章

订阅专栏

本文介绍Spring框架中RestTemplate的DELETE方法不支持请求体的原因及其解决方案。通过修改RequestFactory并自定义支持请求体的DELETE请求模型，可以实现在DELETE请求中发送请求体。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Spring 框架的RestTemplate 类定义了一些我们在通过 java 代码调用 Rest 服务时经常需要用到的方法，使得我们通过 java 调用 rest 服务时更加方便、简单。但是 RestTemplate 的 delete 方法并不支持传入请求体（Request Body）。经测试，通过调用 RestTemplate 类的exchange(String url, HttpMethod method, HttpEntity<?> requestEntity, Class<ResponseResult> responseType, Object... uriVariables) 方法，将 method 指定为 org.springframework.http.HttpMethod.DELETE，并传入 requestEntity（请求体）对象时，在服务端得到的 Request Body 仍然为 null。可见 RestTemplate 默认并不支持对 DELETE 方法使用请求体。

通过查阅资料发现 RestTemplate 默认是使用 spring 自身的 SimpleClientHttpRequestFactory 创建请求对象和对其进行相关设置（如请求头、请求体等），它只支持 PUT 和 POST 方法带请求体，RestTemplate 的 DELETE 方法不支持传入请求体是因为 JDK 中 HttpURLConnection 对象的 delete 方法不支持传入请求体（如果对 HttpURLConnection 对象的 delete 方法传入请求体，在运行时会抛出 IOException）。

我们可以通过修改 RestTemplate 的 RequestFactory 实现 delete 方法对请求体的支持，比如改成 Apache HTTPClient’s HttpComponents 的ClientHttpRequestFactory，由于 ClientHttpRequestFactory 默认的 DELETE 方法也不支持请求体，所以我们除了修改 RestTemplate 的 RequestFactory 之外，还需要定义一个支持传输请求的的 DELETE 请求模型，完整的代码如下：

RestTemplate restTemplate = new RestTemplate();
 
public static class HttpEntityEnclosingDeleteRequest extends HttpEntityEnclosingRequestBase {
 
    public HttpEntityEnclosingDeleteRequest(final URI uri) {
        super();
        setURI(uri);
    }
 
    @Override
    public String getMethod() {
        return "DELETE";
    }
}
 
@Test
public void bodyWithDeleteRequest() throws Exception {
    restTemplate.setRequestFactory(new HttpComponentsClientHttpRequestFactory() {
        @Override
        protected HttpUriRequest createHttpUriRequest(HttpMethod httpMethod, URI uri) {
            if (HttpMethod.DELETE == httpMethod) {
                return new HttpEntityEnclosingDeleteRequest(uri);
            }
            return super.createHttpUriRequest(httpMethod, uri);
        }
    });
 
    ResponseEntity<String> exchange = restTemplate.exchange(
            "http://example.com/file";,
            HttpMethod.DELETE,
            new HttpEntity<String>("some sample body sent along the DELETE request"),
            String.class);
    assertEquals("Got body: some sample body sent along the DELETE request", exchange.getBody());
}

服务端的 java 代码：

@RequestMapping(value = "/file", method = DELETE)
@ResponseBody
public String deleteSecci(@RequestBody String body) {
    return "Got body: " + body;
}