パッケージ jakarta.activation

クラス ActivationDataFlavor


  • public class ActivationDataFlavor
    extends ObjectSE
    ActivationDataFlavor クラスは、JDK の java.awt.datatransfer.DataFlavor クラスに似ています。これにより、Jakarta Activation は、新しいコンストラクターを介して DataFlavor クラスによって格納された 3 つの値すべてを設定できます。また、equals  メソッドでの改善された MIME 解析も含まれています。改善された構文解析を除いて、そのセマンティクスは JDK の DataFlavor クラスのセマンティクスと同じです。
    • コンストラクターの詳細

      • ActivationDataFlavor

        public ActivationDataFlavor​(ClassSE<?> representationClass,
                                    StringSE mimeType,
                                    StringSE humanPresentableName)
        任意の Java オブジェクトを表す ActivationDataFlavor を作成します。

        返される ActivationDataFlavor には、次の特性があります。

        representationClass = representationClass
        mimeType = mimeType
        humanName = humanName

        パラメーター:
        representationClass - この ActivationDataFlavor で使用されるクラス
        mimeType - このクラスによって表されるデータの MIME 型
        humanPresentableName - フレーバーの人間が表現できる名前
      • ActivationDataFlavor

        public ActivationDataFlavor​(ClassSE<?> representationClass,
                                    StringSE humanPresentableName)
        MimeType を表す ActivationDataFlavor を作成します。

        返される ActivationDataFlavor には、次の特性があります。

        mimeType が "application/x-java-serialized-object; class=" の場合、結果は上記のように new ActivationDataFlavor(Class.forName()) を呼び出すのと同じになります。

        さもないと:

        representationClass = InputStream

        mimeType = mimeType

        パラメーター:
        representationClass - この ActivationDataFlavor で使用されるクラス
        humanPresentableName - フレーバーの人間が表現できる名前
      • ActivationDataFlavor

        public ActivationDataFlavor​(StringSE mimeType,
                                    StringSE humanPresentableName)
        MimeType を表す ActivationDataFlavor を作成します。

        返される ActivationDataFlavor には、次の特性があります。

        mimeType が "application/x-java-serialized-object; class=" の場合、結果は上記のように new ActivationDataFlavor(Class.forName()) を呼び出すのと同じになります。それ以外の場合は次のようになります。

        representationClass = InputStream
        mimeType = mimeType

        パラメーター:
        mimeType - このクラスによって表されるデータの MIME 型
        humanPresentableName - フレーバーの人間が表現できる名前
    • メソッドの詳細

      • getMimeType

        public StringSE getMimeType()
        この ActivationDataFlavor の MIME 型を返します。
        戻り値:
        MIME 型
      • getRepresentationClass

        public ClassSE<?> getRepresentationClass()
        表現クラスを返します。
        戻り値:
        表現クラス
      • getHumanPresentableName

        public StringSE getHumanPresentableName()
        HumanPresentable の名前を返します。
        戻り値:
        人間の見栄えのする名前
      • setHumanPresentableName

        public void setHumanPresentableName​(StringSE humanPresentableName)
        人間に見栄えのする名前を設定します。
        パラメーター:
        humanPresentableName - 設定する名前
      • equals

        public boolean equals​(ActivationDataFlavor dataFlavor)
        渡された ActivationDataFlavor をこの ActivationDataFlavor と比較します。isMimeTypeEqual メソッドを呼び出します。
        パラメーター:
        dataFlavor - 比較する ActivationDataFlavor
        戻り値:
        MIME 型と表現クラスが同じ場合は true
      • equals

        public boolean equals​(ObjectSE o)
        オーバーライド:
        クラス ObjectSEequalsSE 
        パラメーター:
        o - 比較する Object 
        戻り値:
        オブジェクトも ActivationDataFlavor であり、これと等しい場合は true
      • equals

        @DeprecatedSE
        public boolean equals​(StringSE s)
        使用すべきではありません。
        hashCode() 契約と矛盾するため、代わりに isMimeTypeEqual(String) を使用してください。
        mimeType のみを渡された String と比較し、representationClass は比較では考慮されません。representationClass を比較する必要がある場合は、equals(new DataFlavor(s)) を使用できます。
        パラメーター:
        s - 比較する mimeType
        戻り値:
        文字列(MimeType)が等しい場合は true。それ以外の場合、または s が null の場合は false
      • hashCode

        public int hashCode()
        この ActivationDataFlavor のハッシュコードを返します。2 つの等しい ActivationDataFlavor の場合、ハッシュコードは等しくなります。ActivationDataFlavor.equals(String) と一致する String の場合、ActivationDataFlavor のハッシュコードが String のハッシュコードと等しいことは保証されません。
        オーバーライド:
        クラス ObjectSEhashCode 
        戻り値:
        この ActivationDataFlavor のハッシュコード
      • isMimeTypeEqual

        public boolean isMimeTypeEqual​(StringSE mimeType)
        この ActivationDataFlavor の MIME 型と同等に渡される MIME 型の文字列表現です。

        ActivationDataFlavor は、MIME 型の比較を Jakarta Activation の一部として含まれている MimeType クラスに委譲します。

        パラメーター:
        mimeType - MIME 型
        戻り値:
        同じ MIME 型の場合は true
      • normalizeMimeTypeParameter

        @DeprecatedSE
        protected StringSE normalizeMimeTypeParameter​(StringSE parameterName,
                                                    StringSE parameterValue)
        使用すべきではありません。
        すべての MIME 型パラメーターに対して ActivationDataFlavor で呼び出され、ActivationDataFlavor サブクラスが text/plain 文字セットパラメーターなどの特殊なパラメーターを処理できるようにします。このパラメーターの値では大文字と小文字は区別されません。(MIME 型のパラメーター値では、大文字と小文字が区別されることになっています)。

        このメソッドは、各パラメーター名 / 値のペアに対して呼び出され、parameterValue の正規化された表現を返す必要があります。このメソッドは、この実装によって呼び出されることはありません。

        パラメーター:
        parameterName - パラメーター名
        parameterValue - パラメーター値
        戻り値:
        正規化されたパラメーター値
      • normalizeMimeType

        @DeprecatedSE
        protected StringSE normalizeMimeType​(StringSE mimeType)
        使用すべきではありません。
        ActivationDataFlavor サブ型に MIME 型の正規化の実行方法を変更する機会を与えるために、各 MIME 型文字列に対して呼び出されます。考えられる使用箇所の 1 つは、渡された MIME 型文字列にデフォルトのパラメーターと値のペアが存在しない場合に追加することです。このメソッドは、この実装によって呼び出されることはありません。
        パラメーター:
        mimeType - MIME 型
        戻り値:
        正規化された MIME 型