翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Apache ベースの HTTP クライアントの設定

SDK の ApacheHttpClientは Apache HttpClient 4.x に基づいています。

SDK には URLConnectionHttpClient も用意されており、ロードは速くなりますが、機能が少なくなっています。UrlConnectionHttpClient の設定の詳細については、「URLConnection ベースの HTTP クライアントを設定する」を参照してください。

ApacheHttpClient で使用できるすべての設定オプションを確認するには、「ApacheHttpClient.Builder」と「ProxyConfiguration.Builder」を参照してください。

ApacheHttpClient へのアクセス

設定が必要です

を使用するにはApacheHttpClient、コンパイル時にapache-clientライブラリへの依存関係を追加する必要があります。

次の Maven pom.xml ファイルの例を参照して、「ApacheHttpClient」を設定します。

    
        
            
                software.amazon.awssdk
                bom
                2.54.0
                pom
                import
            
        
    
    
        
            software.amazon.awssdk
            s3
        
        
        
            software.amazon.awssdk
            apache-client
        
    

ApacheHttpClient を使用および設定する

サービスクライアントを構築すると同時に ApacheHttpClient のインスタンスを設定することも、複数のサービスクライアントで共有するために単一のインスタンスを設定することもできます。

いずれの方法でも、ApacheHttpClient.Builder を使用して Apache ベースの HTTP クライアントのプロパティを設定します。

ベストプラクティス: ApacheHttpClient インスタンスをサービスクライアント専用にする

ApacheHttpClient のインスタンスを設定する必要がある場合は、専有 ApacheHttpClient インスタンスを構築することをお勧めします。これを行うには、サービスクライアントのビルダーの httpClientBuilder メソッドを使用します。この方法では、HTTP クライアントのライフサイクルが SDK によって管理されるため、不要になったときに ApacheHttpClient インスタンスを閉じなかった場合にメモリリークが発生するのを防ぐことができます。

次の例では、S3Client を作成して、maxConnections と connectionTimeout の値で ApacheHttpClient の埋め込みインスタンス設定します。HTTP インスタンスは、S3Client.Builder のhttpClientBuilder メソッドを使用して作成されます。

インポート

import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.services.s3.S3Client;
import java.time.Duration;

コード

S3Client s3Client = S3Client   // Singleton: Use the s3Client for all requests.
    .builder()
    .httpClientBuilder(ApacheHttpClient.builder()
        .maxConnections(100)
        .connectionTimeout(Duration.ofSeconds(5))
    ).build();

// Perform work with the s3Client.

s3Client.close();   // Requests completed: Close all service clients.

別の方法: ApacheHttpClient インスタンスを共有する

アプリケーションのリソースとメモリの使用量を低く抑えるため、ApacheHttpClient を設定して複数のサービスクライアント間で共有できます。HTTP 接続プールは共有されるため、リソースの使用量が少なくなります。

次の例では、2 つのサービスクライアントで使用される Apache ベースの HTTP クライアントを設定します。設定された ApacheHttpClient インスタンスは、各ビルダーの httpClient メソッドに渡されます。サービスクライアントと HTTP クライアントが不要になると、コードによって明示的に閉じられます。HTTP クライアントは最後に閉じられます。

インポート

import software.amazon.awssdk.http.SdkHttpClient;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.services.dynamodb.DynamoDbClient;
import software.amazon.awssdk.services.s3.S3Client;

コード

SdkHttpClient apacheHttpClient = ApacheHttpClient.builder()
        .maxConnections(100).build();

// Singletons: Use the s3Client and dynamoDbClient for all requests.
S3Client s3Client = 
    S3Client.builder()
            .httpClient(apacheHttpClient).build();

DynamoDbClient dynamoDbClient = 
    DynamoDbClient.builder()
                  .httpClient(apacheHttpClient).build();

// Perform work with the s3Client and dynamoDbClient.

// Requests completed: Close all service clients.
s3Client.close();
dynamoDbClient.close();
apacheHttpClient.close();  // Explicitly close apacheHttpClient.

プロキシの設定例

次のコードスニペットは、Apache HTTP クライアントのプロキシ設定ビルダーを使用しています。

SdkHttpClient apacheHttpClient = ApacheHttpClient.builder()
                .proxyConfiguration(ProxyConfiguration.builder()
                        .endpoint(URI.create("http://example.com:1234"))
                        .username("username")
                        .password("password")
                        .addNonProxyHost("localhost")
                        .addNonProxyHost("host.example.com")
                        .build())
                .build();

プロキシ設定に対応する Java システムプロパティは、以下のコマンドラインスニペットに示されています。

$ java -Dhttp.proxyHost=example.com -Dhttp.proxyPort=1234 -Dhttp.proxyUser=username \
-Dhttp.proxyPassword=password -Dhttp.nonProxyHosts=localhost|host.example.com -cp ... App

環境変数を使用する同等のセットアップは次のとおりです。

// Set the following environment variables.
// $ export HTTP_PROXY="http://username:password@example.com:1234"
// $ export NO_PROXY="localhost|host.example.com"

// Set the 'useSystemPropertyValues' to false on the proxy configuration.
SdkHttpClient apacheHttpClient = ApacheHttpClient.builder()
                .proxyConfiguration(ProxyConfiguration.builder()
                        .useSystemPropertyValues(Boolean.FALSE)
                        .build())
                .build();

// Run the application.
// $ java -cp ... App