列挙クラスHttpOption.Http3DiscoveryMode

java.lang.Object
java.lang.Enum<HttpOption.Http3DiscoveryMode>
java.net.http.HttpOption.Http3DiscoveryMode
すべての実装されたインタフェース:
Serializable, Comparable<HttpOption.Http3DiscoveryMode>, Constable
含まれているインタフェース:
HttpOption<T>
パブリック静的列挙HttpOption.Http3DiscoveryModeはEnum<HttpOption.Http3DiscoveryMode>を拡張します。
この列挙は、HttpClientがHTTP/3交換を確立する方法を決定するのに役立ち、Builder.setOptionの HttpOption.H3_DISCOVERYオプションの値として指定できます。

リクエスト優先バージョンもクライアント優先バージョンもHTTP/3でない場合、HTTP/3交換は確立されず、Http3DiscoveryModeは無視されます。

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

  • ネストされたクラスのサマリー

    Enumクラスで宣言されたネストされたクラス/インタフェース

    Enum.EnumDesc<E>
    修飾子と型
    クラス
    説明
    static final class 
    Enum.EnumDesc<E extends Enum<E>>
    enum定数の「名目記述子」。

  • 列挙型定数のサマリー

    列挙型定数
    列挙型定数
    説明
    ALT_SVC
    これにより、HttpClientは、HTTP代替サービスのみを使用して、オリジン・サーバーとのHTTP/3接続を検索または確立するように指示されます。
    ANY
    これにより、HttpClientは、独自の実装固有のアルゴリズムを使用して、交換用の接続を検索または確立するように指示されます。
    HTTP_3_URI_ONLY
    これにより、HttpClientは、オリジン・サーバーとのHTTP/3接続のみを試行するように指示されます。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    static HttpOption.Http3DiscoveryMode
    valueOf(String name)
    指定された名前を持つこのクラスのenum定数を返します。
    static HttpOption.Http3DiscoveryMode[]
    values()
    この列挙クラスの定数を含む配列を宣言されている順序で 返します。

    Enumクラスで宣言されたメソッド

    clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf
    修飾子と型
    メソッド
    説明
    protected final Object
    clone()
    CloneNotSupportedExceptionをスローします。
    final int
    compareTo(HttpOption.Http3DiscoveryMode o)
    このenumと指定されたオブジェクトの順序を比較します。
    final Optional<Enum.EnumDesc<HttpOption.Http3DiscoveryMode>>
    describeConstable()
    このインスタンスの列挙型記述子EnumDescを返します(作成可能な場合)。作成できない場合は空のOptionalを返します。
    final boolean
    equals(Object other)
    指定されたオブジェクトがこのenum定数と同じ場合は、trueを返します。
    protected final void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は削除のために非推奨になりました。
    final Class<HttpOption.Http3DiscoveryMode>
    getDeclaringClass()
    このenum定数のenum型に対応するClassオブジェクトを返します。
    final int
    hashCode()
    このenum定数のハッシュ・コードを返します。
    final String
    name()
    enum宣言で宣言されているとおりのenum定数の名前を返します。
    final int
    ordinal()
    列挙定数の序数(列挙宣言での位置。初期定数はゼロの序数に割り当てられる)を返します。
    String
    toString()
    宣言に含まれるとおりのenum定数の名前を返します。
    static <T extends Enum<T>>
    T
    valueOf(Class<T> enumClass, String name)
    指定された名前の指定されたenumクラスのenum定数を返します。

    クラスオブジェクトで宣言されたメソッド

    getClass, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • 列挙型定数の詳細

    • ANY

      public static final HttpOption.Http3DiscoveryMode ANY
      これにより、HttpClientは、独自の実装固有のアルゴリズムを使用して、交換用の接続を検索または確立するように指示されます。 通常、リクエストURIで定義されたオリジン・サーバーとの接続が以前に確立されていない場合、HttpClient実装は、リクエストURIに存在する権限でQUIC経由のHTTP/3接続とTLS/TCP経由のHTTP接続の両方を確立しようとし、成功する最初の接続を使用します。 交換は、最初に成功した方法に応じて、3つのHTTPプロトコル・バージョンのいずれかで実行できます。
      実装上のノート:
      リクエスト優先バージョンがHTTP/3の場合、HttpClientは、TCP経由でTLS接続を試行する前に、HTTP/3接続を確立しようとすることで、HTTP/3に優先順位を付けることができます。

      このモードでHTTP/3接続を試行する場合、HttpClientは、オリジン・サーバーから以前に取得した可能性のあるHTTP代替サービス情報を使用できます。 そのような情報が使用できない場合は、リクエストURIに存在する権限(ホスト、ポート)での直接HTTP/3接続が試行されます。

    • ALT_SVC

      public static final HttpOption.Http3DiscoveryMode ALT_SVC
      これにより、HttpClientは、HTTP代替サービスのみを使用して、オリジン・サーバーとのHTTP/3接続を検索または確立するように指示されます。 交換は、HTTP/3の代替サービス・レコードが見つかったかどうか、およびそのようなレコードが見つからなかった場合にオリジン・サーバーとネゴシエートされたHTTPバージョンに応じて、3つのHTTPプロトコル・バージョンのいずれかで実行できます。

      このモードでは、オリジン・サーバーに送信されたリクエストは、そのサーバーのh3 HTTP代替サービス・エンドポイントがクライアントに通知されるまで、HTTP/1.1またはHTTP/2を介して送信されます。 通常、代替サービスは、リクエストへの応答時にサーバーによって通知されるため、後続のリクエストはその代替サービスを使用できます。

    • HTTP_3_URI_ONLY

      public static final HttpOption.Http3DiscoveryMode HTTP_3_URI_ONLY
      これにより、HttpClientは、オリジン・サーバーとのHTTP/3接続のみを試行するように指示されます。 接続が成功するのは、オリジン・サーバーが、リクエストURIで定義されている同じ権限(ホスト、ポート)でQUIC経由で受信HTTP/3接続をリスニングしている場合のみです。 このモードでは、HTTP Alternative Servicesは使用されません。

  • メソッドの詳細

    • values

      public static HttpOption.Http3DiscoveryMode[] values()
      この列挙クラスの定数を含む配列を宣言されている順序で 返します。
      戻り値:
      この列挙クラスの定数を宣言されている順序で含む配列

    • valueOf

      public static HttpOption.Http3DiscoveryMode valueOf(String name)
      指定された名前を持つこのクラスのenum定数を返します。 文字列は、このクラスでenum定数を宣言するために使用される識別子と正確に一致する必要があります。 (不適切な空白文字は許可されません。)
      パラメータ:
      name - 返される列挙型定数の名前。
      戻り値:
      指定された名前を持つ列挙型定数
      スロー:
      IllegalArgumentException - この列挙型クラスに指定された名前の定数がない場合
      NullPointerException - 引数がnullの場合