HTTP 客户端

DeepSeek V3 中英对照 HTTP Clients

Spring Boot 提供了多个与 HTTP 客户端相关的启动器。本节将回答与使用它们相关的问题。

配置 RestTemplate 使用代理

如RestTemplate 自定义所述，你可以使用 RestTemplateCustomizer 与 RestTemplateBuilder 来构建一个自定义的 RestTemplate。这是创建配置为使用代理的 RestTemplate 的推荐方法。

代理配置的具体细节取决于所使用的底层客户端请求工厂。

配置由基于 Reactor Netty 的 WebClient 使用的 TcpClient

当 Reactor Netty 存在于类路径时，一个基于 Reactor Netty 的 WebClient 会自动配置。为了自定义客户端对网络连接的处理，可以提供一个 ClientHttpConnector Bean。以下示例配置了 60 秒的连接超时，并添加了一个 ReadTimeoutHandler：

Java

import io.netty.channel.ChannelOption;
import io.netty.handler.timeout.ReadTimeoutHandler;
import reactor.netty.http.client.HttpClient;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.client.ReactorResourceFactory;
import org.springframework.http.client.reactive.ClientHttpConnector;
import org.springframework.http.client.reactive.ReactorClientHttpConnector;

@Configuration(proxyBeanMethods = false)
public class MyReactorNettyClientConfiguration {

    @Bean
    ClientHttpConnector clientHttpConnector(ReactorResourceFactory resourceFactory) {
        HttpClient httpClient = HttpClient.create(resourceFactory.getConnectionProvider())
                .runOn(resourceFactory.getLoopResources())
                .option(ChannelOption.CONNECT_TIMEOUT_MILLIS, 60000)
                .doOnConnected((connection) -> connection.addHandlerLast(new ReadTimeoutHandler(60)));
        return new ReactorClientHttpConnector(httpClient);
    }

}

java

Kotlin

import io.netty.channel.ChannelOption
import io.netty.handler.timeout.ReadTimeoutHandler
import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration
import org.springframework.http.client.reactive.ClientHttpConnector
import org.springframework.http.client.reactive.ReactorClientHttpConnector
import org.springframework.http.client.ReactorResourceFactory
import reactor.netty.http.client.HttpClient

@Configuration(proxyBeanMethods = false)
class MyReactorNettyClientConfiguration {

    @Bean
    fun clientHttpConnector(resourceFactory: ReactorResourceFactory): ClientHttpConnector {
        val httpClient = HttpClient.create(resourceFactory.connectionProvider)
            .runOn(resourceFactory.loopResources)
            .option(ChannelOption.CONNECT_TIMEOUT_MILLIS, 60000)
            .doOnConnected { connection ->
                connection.addHandlerLast(ReadTimeoutHandler(60))
            }
        return ReactorClientHttpConnector(httpClient)
    }

}

kotlin

提示

注意使用 ReactorResourceFactory 来管理连接提供者和事件循环资源。这确保了服务器接收请求和客户端发起请求时资源的高效共享。