パッケージ jakarta.ws.rs.core

クラス MediaType

  • public class MediaType
extends ObjectSE
    メディア型の抽象化。インスタンスは不変です。
    導入:
    1.0
    作成者:
    Paul Sandoz, Marc Hadley
    関連事項:
    HTTP/1.1 セクション 3.7

    • コンストラクターの詳細

      • MediaType

        public MediaType​(StringSE type,
                 StringSE subtype,
                 MapSE<StringSE,​StringSE> parameters)
        指定された型、サブ型、パラメーターを使用して、MediaType の新しいインスタンスを作成します。
        パラメーター:
        type - プライマリ型の null は、MEDIA_TYPE_WILDCARD と同等です。
        subtype - サブ型 null は MEDIA_TYPE_WILDCARD と同等です。
        parameters - メディア型パラメーターのマップ、null は空のマップと同じです。

      • MediaType

        public MediaType​(StringSE type,
                 StringSE subtype)
        指定された型とサブ型を使用して、MediaType の新しいインスタンスを作成します。
        パラメーター:
        type - プライマリ型の null は MEDIA_TYPE_WILDCARD と同等です
        subtype - サブ型、null は MEDIA_TYPE_WILDCARD と同等です

      • MediaType

        public MediaType​(StringSE type,
                 StringSE subtype,
                 StringSE charset)
        指定された型、サブ型、"charset" パラメーターを使用して MediaType の新しいインスタンスを作成します。
        パラメーター:
        type - プライマリ型の null は MEDIA_TYPE_WILDCARD と同等です
        subtype - サブ型、null は MEDIA_TYPE_WILDCARD と同等です
        charset - "charset" パラメーター値。null または空の場合、"charset" パラメーターは設定されません。

      • MediaType

        public MediaType()
        MediaType の新しいインスタンスを作成します。型とサブ型はどちらもワイルドカードです。代わりに定数 WILDCARD_TYPE の使用を検討してください。

    • メソッドの詳細

      • valueOf

        public static MediaType valueOf​(StringSE type)
        指定された文字列を解析して、MediaType の新しいインスタンスを作成します。
        パラメーター:
        type - メディア型文字列。
        戻り値:
        新しく作成された MediaType。
        例外:
        IllegalArgumentExceptionSE - 指定された文字列を解析できないか、null である場合

      • getType

        public StringSE getType()
        プライマリ型の Getter。
        戻り値:
        プライマリ型の値。

      • isWildcardType

        public boolean isWildcardType()
        プライマリ型がワイルドカードであるかどうかを確認します。
        戻り値:
        プライマリ型がワイルドカードの場合は true。

      • getSubtype

        public StringSE getSubtype()
        サブ型の Getter。
        戻り値:
        サブ型の値。

      • isWildcardSubtype

        public boolean isWildcardSubtype()
        サブ型がワイルドカードであるかどうかを確認します。
        戻り値:
        サブ型がワイルドカードの場合は true。

      • getParameters

        public MapSE<StringSE,​StringSE> getParameters()
        読み取り専用パラメーターマップの場合は Getter。キーでは大文字と小文字は区別されません。
        戻り値:
        パラメーターの不変のマップ。

      • withCharset

        public MediaType withCharset​(StringSE charset)
        元のインスタンスからコピーされた同じ型、サブ型、パラメーター、提供された "charset" パラメーターを使用して新しい MediaType インスタンスを作成します。
        パラメーター:
        charset - "charset" パラメーター値。null または空の場合、"charset" パラメーターは設定または更新されません。
        戻り値:
        "charset" パラメーターが指定された値に設定された現在の MediaType インスタンスのコピー。
        導入:
        2.0

      • isCompatible

        public boolean isCompatible​(MediaType other)
        このメディア型が別のメディア型と互換性があるかどうかを確認します。2 つのメディア型は、それらの型が等しいか、一方がワイルドカード型であり、それらのサブ型が等しいか、一方がワイルドカードサブ型である場合にのみ、互換性があると見なされます。メディア型パラメーターは無視されます。関数は可換です。
        パラメーター:
        other - 比較するメディア型。
        戻り値:
        型に互換性がある場合は true、それ以外の場合は false。

      • equals

        public boolean equals​(ObjectSE obj)

        obj をこのメディア型と比較し、型、サブ型、パラメーターを比較して、それらが同じであるかどうかを確認します。パラメーター値の大文字と小文字の区別は、パラメーター名のセマンティクスに依存することに注意してください。HTTP/1.1 を参照してください。この方法では、値で大文字と小文字が区別されることを前提としています。

        equals(...) 実装は、クラスの同等性チェック（this.getClass() == obj.getClass()）を実行しないことに注意してください。MediaType クラスから拡張し、equals(...) メソッドと hashCode() メソッドのいずれかをオーバーライドする必要があるクラスは、Object.equals(java.lang.Object)SE と Object.hashCode() の間の契約が壊れないように、常に両方のメソッドをオーバーライドする必要があります。
        オーバーライド:
        クラス ObjectSE の equalsSE 
        パラメーター:
        obj - 比較するオブジェクト
        戻り値:
        2 つのメディア型が同じ場合は true、それ以外の場合は false。

      • hashCode

        public int hashCode()

        型、サブ型、パラメーターからハッシュコードを生成します。

        equals(java.lang.Object) 実装は、クラスの同等性チェック（this.getClass() == obj.getClass()）を実行しないことに注意してください。MediaType クラスから拡張し、equals(Object) メソッドと hashCode() メソッドのいずれかをオーバーライドする必要があるクラスは、Object.equals(java.lang.Object)SE と Object.hashCode() の間の契約が壊れないように、常に両方のメソッドをオーバーライドする必要があります。
        オーバーライド:
        クラス ObjectSE の hashCode 
        戻り値:
        生成されたハッシュコード。

      • toString

        public StringSE toString()
        メディア型を、対応する HTTP ヘッダーの値として使用するのに適した文字列に変換します。
        オーバーライド:
        クラス ObjectSE の toString 
        戻り値:
        メディア型の文字列バージョン。