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

クラスHttpHeaders

  • public abstract class HttpHeaders
extends Object
    一連のHTTPヘッダーの読み取り専用ビュー。
    インキュベーション機能。将来のリリースで削除されます。

    このクラス(Stringヘッダー名を受け入れる)のメソッドとmapメソッドによって返されたMapは、ヘッダー値を取得する際に大文字と小文字を区別せずに動作します。

    HttpHeadersインスタンスは不変です。

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

    • コンストラクタの詳細

      • HttpHeaders

        protected HttpHeaders()
        HttpHeadersを作成します。

    • メソッドの詳細

      • firstValue

        public Optional<String> firstValue​(String name)
        指定された(おそらく多値)ヘッダーの最初の値を含むOptionalを返します。 ヘッダーが存在しない場合、返されたOptionalは空です。
        実装要件:
        デフォルトの実装では、allValues(name).stream().findFirst()
        パラメータ:
        name - ヘッダー名
        戻り値:
        最初の名前付き値のOptional<String>

      • firstValueAsLong

        public OptionalLong firstValueAsLong​(String name)
        指定されたヘッダー・フィールドの最初の値を含むOptionalLongを返します。 ヘッダーが存在しない場合、オプションは空です。 ヘッダーが存在するが、Long値として解析されない値が含まれている場合、例外がスローされます。
        実装要件:
        デフォルトの実装では、allValues(name).stream().mapToLong(Long::valueOf).findFirst()
        パラメータ:
        name - ヘッダー名
        戻り値:
        OptionalLong
        例外:
        NumberFormatException - 値が見つかるが、Longとして解析されない場合

      • allValues

        public List<String> allValues​(String name)
        指定された名前付きヘッダーのすべての値の変更不可能なListを返します。 Listが常に返されます。ヘッダーが存在しない場合は、空である可能性があります。
        実装要件:
        デフォルトの実装では、とりわけmap().get(name)を呼び出してヘッダー値のリストを取得します。
        パラメータ:
        name - ヘッダー名
        戻り値:
        文字列値のリスト

      • map

        public abstract Map<String,List<String>> map()
        このHttpHeadersの変更不可能なマルチ・マップ・ビューを返します。
        戻り値:
        マップ

      • equals

        public final boolean equals​(Object obj)
        このHTTPヘッダー・インスタンスが指定されたオブジェクトと等しいかどうかをテストします。

        指定されたオブジェクトがHttpHeadersでない場合、このメソッドはfalseを返します。 対応するmapsが等しい場合、2つのHTTPヘッダーが等しくなります。

        このメソッドはObject.equalsメソッドの汎用規約を満たします。

        オーバーライド:
        equals 、クラス:  Object
        パラメータ:
        obj - このオブジェクトが比較されるオブジェクト
        戻り値:
        指定されたオブジェクトがこのHTTPヘッダーと等しい HttpHeadersである場合にのみtrue
        関連項目:
        Object.hashCode()、HashMap

      • toString

        public String toString()
        このHTTPヘッダーを文字列として返します。
        オーバーライド:
        toString 、クラス:  Object
        戻り値:
        HTTPヘッダーを記述する文字列