HTTP 客戶端

Spring Boot 提供了許多與 HTTP 客戶端一起使用的 starters。本節回答了與使用它們相關的問題。

配置 RestTemplate 使用代理

RestTemplate 定製中所述,您可以結合 RestTemplateBuilder 使用 RestTemplateCustomizer 來構建定製的 RestTemplate。這是配置 RestTemplate 以使用代理的推薦方法。

代理配置的具體細節取決於正在使用的底層客戶端請求工廠。

配置 Reactor Netty-based WebClient 使用的 TcpClient

當 classpath 中包含 Reactor Netty 時,會自動配置基於 Reactor Netty 的 WebClient。要定製客戶端對網路連線的處理,請提供一個 ClientHttpConnector bean。以下示例配置了 60 秒的連線超時並添加了 ReadTimeoutHandler

  • Java

  • Kotlin

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);
	}

}
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)
	}

}
請注意,連線提供者和事件迴圈資源使用了 ReactorResourceFactory。這確保了接收請求的服務端和發出請求的客戶端能夠有效共享資源。