モジュール jdk.incubator.httpclient
パッケージ jdk.incubator.http

クラスHttpClient.Builder

  • 含まれているクラス:
    HttpClient

    public abstract static class HttpClient.Builder
extends Object
    不変のHttpClientのビルダー。 HttpClient.Builderは、HttpClient.newBuilder()を呼び出すことによって作成されます。
    インキュベーション機能。将来のリリースで削除されます。

    このクラスの各セッター・メソッドは、ビルダーの状態を変更し、this (すなわち、同じインスタンス)を返します。 メソッドは同期されておらず、外部同期なしで複数のスレッドから呼び出されるべきではありません。

    build()は、呼び出されるたびに新しいHttpClientを返します。

    導入されたバージョン:
    9

    • コンストラクタの詳細

      • Builder

        protected Builder​()

    • メソッドの詳細

      • cookieManager

        public abstract HttpClient.Builder cookieManager​(CookieManager cookieManager)
        クッキー・マネージャを設定します。
        パラメータ:
        cookieManager - クッキー・マネージャ
        戻り値:
        このビルダー

      • sslContext

        public abstract HttpClient.Builder sslContext​(SSLContext sslContext)
        SSLContextを設定します。 セキュリティ・マネージャが設定されている場合、呼び出し側はNetPermission ("setSSLContext")

        このメソッドを呼び出さないと、デフォルトのSSLContextが使用されます。これは通常、プロトコルを指定する必要のないクライアント・アプリケーションやクライアント認証が必要なクライアント・アプリケーションに適しています。

        パラメータ:
        sslContext - SSLContext
        戻り値:
        このビルダー
        例外:
        SecurityException - セキュリティ・マネージャが設定されているが、呼出し側に必要な権限がない場合

      • sslParameters

        public abstract HttpClient.Builder sslParameters​(SSLParameters sslParameters)
        SSLParametersを設定します。 このメソッドが呼び出されない場合は、デフォルトのパラメータ・セットが使用されます。 指定されたオブジェクトの内容がコピーされます。 HTTPプロトコル実装(アプリケーション・プロトコル・リスト)によって内部的に使用されるいくつかのパラメータは、呼び出し元によって無視されるため、設定しないでください。
        パラメータ:
        sslParameters - SSLParameters
        戻り値:
        このビルダー

      • executor

        public abstract HttpClient.Builder executor​(Executor executor)
        非同期タスクに使用されるエグゼキュータを設定します。 このメソッドが呼び出されない場合は、Executors.newCachedThreadPoolから返されるデフォルトのexecutorが設定されます。
        パラメータ:
        executor - エグゼクティブ
        戻り値:
        このビルダー

      • followRedirects

        public abstract HttpClient.Builder followRedirects​(HttpClient.Redirect policy)
        リクエストがサーバーによって発行されたリダイレクトに自動的に従うかどうかを指定します。 この設定は、各リクエストでオーバーライドできます。 この設定のデフォルト値はNEVERです。
        パラメータ:
        policy - リダイレクト・ポリシー
        戻り値:
        このビルダー

      • version

        public abstract HttpClient.Builder version​(HttpClient.Version version)
        可能であれば、特定のHTTPプロトコル・バージョンをリクエストします。 設定されていない場合、バージョンはデフォルトでHttpClient.Version.HTTP_2になります。 HttpClient.Version.HTTP_2が設定されている場合、各リクエストはHTTP/2にアップグレードしようとします。 アップグレードが成功すると、このリクエストに対するレスポンスはHTTP/2を使用し、その後のすべてのリクエストと同じ「オリジン・サーバー」へのレスポンスはHTTP/2を使用します。 アップグレードが失敗した場合、レスポンスはHTTP/1.1を使用して処理されます
        パラメータ:
        version - リクエストされたHTTPプロトコルのバージョン
        戻り値:
        このビルダー

      • priority

        public abstract HttpClient.Builder priority​(int priority)
        このクライアントから送信されたHTTP/2リクエストのデフォルトの優先度を設定します。 指定する値は、1と256 (inclusive)の間にある必要があります。
        パラメータ:
        priority - 優先度の重み付け
        戻り値:
        このビルダー
        例外:
        IllegalArgumentException - 指定された優先度が範囲外の場合

      • proxy

        public abstract HttpClient.Builder proxy​(ProxySelector selector)
        このクライアントのProxySelectorを設定します。 セレクタが設定されていない場合、プロキシは使用されません。 nullパラメータが指定されると、システム全体のデフォルト・プロキシ・セレクタが使用されます。
        実装上の注意:
        ProxySelector.of(InetSocketAddress)は、すべてのリクエストに対して1つのプロキシを使用するProxySelectorを提供します。
        パラメータ:
        selector - ProxySelector
        戻り値:
        このビルダー

      • authenticator

        public abstract HttpClient.Builder authenticator​(Authenticator a)
        HTTP認証に使用するオーセンティケータを設定します。
        パラメータ:
        a - オーセンティケータ
        戻り値:
        このビルダー

      • build

        public abstract HttpClient build​()
        このビルダーの現在の状態から構築されたHttpClientを返します。
        戻り値:
        このビルダー