HTTP クライアント

Spring Boot は、HTTP クライアントで動作する多くのスターターを提供します。このセクションでは、それらの使用に関する質問に回答します。

プロキシを使用するための RestTemplate の構成

RestTemplate のカスタマイズで説明したように、RestTemplateCustomizer (Javadoc) を RestTemplateBuilder (Javadoc) と組み合わせて使用して、カスタマイズされた RestTemplate (Javadoc) を構築できます。これは、プロキシを使用するように構成された RestTemplate (Javadoc) を作成するための推奨される方法です。

プロキシ構成の正確な詳細は、使用されている基になるクライアントリクエストファクトリによって異なります。

Reactor Netty ベースの WebClient が使用する TcpClient を構成する

Reactor Netty がクラスパス上にある場合、Reactor Netty ベースの WebClient (Javadoc) が自動的に構成されます。クライアントのネットワーク接続の処理をカスタマイズするには、ClientHttpConnector (Javadoc) 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 (Javadoc) が使用されていることに注意してください。これにより、リクエストを受信するサーバーとリクエストを行うクライアントのリソースが効率的に共有されます。