DataFlavor (Java Platform SE 8)

java.lang.Object
- java.awt.datatransfer.DataFlavor

すべての実装されたインタフェース:

Externalizable, Serializable, Cloneable

直系の既知のサブクラス:

ActivationDataFlavor
```
public class DataFlavor
extends Object
implements Externalizable, Cloneable
```
DataFlavorは、データに関するメタ情報を提供します。 DataFlavorは通常、クリップボード上のデータにアクセスしたり、ドラッグ&ドロップ操作中にデータにアクセスしたりするために使用されます。
DataFlavorのインスタンスは、RFC 2045およびRFC 2046の定義に従ってコンテンツ・タイプをカプセル化します。通常、コンテンツ・タイプはMIMEタイプと呼ばれます。
コンテンツ・タイプは、メディア・タイプ(プライマリ・タイプと呼ばれる)、サブタイプ、およびオプションのパラメータで構成されます。 MIMEタイプの構文の詳細は、RFC 2045を参照してください。
JREデータ転送の実装は、MIMEタイプのパラメータ「class」を表現クラスとして解釈します。表現クラスは、転送されるオブジェクトのクラスを反映します。つまり、表現クラスは、Transferable.getTransferData(java.awt.datatransfer.DataFlavor)によって返されるオブジェクトのタイプです。たとえば、imageFlavorのMIMEタイプが"image/x-java-image;class=java.awt.Image"である場合、プライマリ・タイプはimage、サブタイプはx-java-image、表現クラスはjava.awt.Imageです。 getTransferDataがimageFlavorのDataFlavorで呼び出されると、java.awt.Imageのインスタンスが返されます。 DataFlavorが表現クラスに対してエラー・チェックを行わないことに注意する必要があります。表現クラスが有効かどうかは、DataFlavorのコンシューマ(Transferableなど)で判定します。
DataFlavorの作成時に表現クラスを指定しない場合は、デフォルトの表現クラスが使用されます。 DataFlavorのコンストラクタについては、該当するドキュメントを参照してください。
また、「text」のプライマリMIMEタイプを持つDataFlavorインスタンスは、「charset」パラメータを取ることもできます。「text」のMIMEタイプと「charset」パラメータの詳細は、RFC 2046およびselectBestTextFlavor(java.awt.datatransfer.DataFlavor[])を参照してください。
DataFlavorsが等しいかどうかは、プライマリ・タイプ、サブタイプ、および表現クラスによって判定されます。詳細は、equals(DataFlavor)を参照してください。等しいかどうかを決定するときは、オプションのすべてのパラメータが無視されます。たとえば、次の文では、同一であると見なされる2つのDataFlavorsが生成されます。
```
   DataFlavor flavor1 = new DataFlavor(Object.class, "X-test/test; class=<java.lang.Object>; foo=bar");
   DataFlavor flavor2 = new DataFlavor(Object.class, "X-test/test; class=<java.lang.Object>; x=y");
   // The following returns true.
   flavor1.equals(flavor2);
 
```
前に説明したように、flavor1とflavor2は同一であると見なされます。したがって、どちらのDataFlavorでTransferableを要求しても、同じ結果が返されます。
Swingによるデータ転送の使用の詳細は、「Java Tutorial」の「How to Use Drag and Drop and Data Transfer」セクションを参照してください。
関連項目:

直列化された形式

フィールドのサマリー

フィールド
修飾子と型	フィールド	説明
`static DataFlavor`	`allHtmlFlavor`	1つのHTMLマークアップを表します。
`static DataFlavor`	`fragmentHtmlFlavor`	1つのHTMLマークアップを表します。
`static DataFlavor`	`imageFlavor`	Java Imageクラスを表す`DataFlavor`。ここでは、次のようになります。
`static DataFlavor`	`javaFileListFlavor`	Java (および基本となるプラットフォーム)との間でファイルのリストを転送するには、このタイプ/サブタイプの`DataFlavor`と、`java.util.List`の表現クラスが使用されます。
`static String`	`javaJVMLocalObjectMimeType`	MIMEコンテンツ・タイプが関連付けられていない任意のJavaオブジェクト参照への参照を同じJVM内の`Transferable`インタフェース経由で転送するには、このタイプ/サブタイプの`DataFlavor`が、`Transferable`経由で渡されるクラス/インタフェースのタイプに等しい`representationClass`とともに使用されます。
`static String`	`javaRemoteObjectMimeType`	有効なリンクをドラッグ&ドロップ`ACTION_LINK`操作によってリモート・オブジェクトに渡すには、application/x-java-remote-objectのMIMEコンテンツ・タイプを使用するようにしてください。ここで、`DataFlavor`の表現クラスは、転送される`Remote`インタフェースのタイプを表します。
`static String`	`javaSerializedObjectMimeType`	application/x-java-serialized-objectというMIMEタイプは、永続化されたJavaオブジェクト(複数可)のグラフを表します。
`static DataFlavor`	`plainTextFlavor`	非推奨。 1.3以降。 `Transferable.getTransferData(DataFlavor.plainTextFlavor)`の代わりに`DataFlavor.getReaderForText(Transferable)`を使用します。
`static DataFlavor`	`selectionHtmlFlavor`	1つのHTMLマークアップを表します。
`static DataFlavor`	`stringFlavor`	Java Unicode Stringクラスを表す`DataFlavor`。ここでは、次のようになります。

コンストラクタのサマリー

コンストラクタ
コンストラクタ	説明
`DataFlavor()`	新しい`DataFlavor`を構築します。
`DataFlavor(Class<?> representationClass, String humanPresentableName)`	Javaクラスを表す`DataFlavor`を構築します。
`DataFlavor(String mimeType)`	`mimeType`文字列から`DataFlavor`を構築します。
`DataFlavor(String mimeType, String humanPresentableName)`	`MimeType`を表す`DataFlavor`を構築します。
`DataFlavor(String mimeType, String humanPresentableName, ClassLoader classLoader)`	`MimeType`を表す`DataFlavor`を構築します。

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド具象メソッド非推奨のメソッド
修飾子と型	メソッド	説明
`Object`	`clone()`	この`DataFlavor`の複製を返します。
`boolean`	`equals(DataFlavor that)`	このメソッドの動作は、`equals(Object)`と同じです。
`boolean`	`equals(Object o)`	このオブジェクトと他のオブジェクトが等しいかどうかを示します。
`boolean`	`equals(String s)`	非推奨。 `hashCode()`規約と矛盾するので、代わりに`isMimeTypeEqual(String)`を使用してください。
`Class<?>`	`getDefaultRepresentationClass()`
`String`	`getDefaultRepresentationClassAsString()`
`String`	`getHumanPresentableName()`	この`DataFlavor`が表すデータ形式の判読できる名前を返します。
`String`	`getMimeType()`	この`DataFlavor`のMIMEタイプの文字列を返します。
`String`	`getParameter(String paramName)`	`paramName`が「humanPresentableName」に等しい場合は、この`DataFlavor`の判読できる名前を返します。
`String`	`getPrimaryType()`	この`DataFlavor`のプライマリMIMEタイプを返します。
`Reader`	`getReaderForText(Transferable transferable)`	必要に応じて、予想される文字セット(エンコード)をデコードしたテキスト・フレーバのReaderを取得します。
`Class<?>`	`getRepresentationClass()`	この`DataFlavor`が要求されたときに、この`DataFlavor`をサポートしているオブジェクトが返す`Class`を返します。
`String`	`getSubType()`	この`DataFlavor`のサブMIMEタイプを返します。
`static DataFlavor`	`getTextPlainUnicodeFlavor()`	Unicodeエンコーディングでプレーン・テキストを表す`DataFlavor`を返します。ここでは、次のようになります。
`int`	`hashCode()`	この`DataFlavor`のハッシュ・コードを返します。
`boolean`	`isFlavorJavaFileListType()`	指定された`DataFlavor`がファイル・オブジェクトのリストを表す場合はtrueを返します。
`boolean`	`isFlavorRemoteObjectType()`	指定された`DataFlavor`がリモート・オブジェクトを表す場合はtrueを返します。
`boolean`	`isFlavorSerializedObjectType()`	指定された`DataFlavor`が直列化オブジェクトを表す場合はtrueを返します。
`boolean`	`isFlavorTextType()`	この`DataFlavor`がJavaプラットフォームのこの実装のための有効なテキスト・フレーバであるかどうかを返します。
`boolean`	`isMimeTypeEqual(DataFlavor dataFlavor)`	2つの`DataFlavor`オブジェクトの`mimeType`を比較します。
`boolean`	`isMimeTypeEqual(String mimeType)`	渡されたMIMEタイプの文字列表現がこの`DataFlavor`のMIMEタイプと同等であるかどうかを返します。
`boolean`	`isMimeTypeSerializedObject()`	`DataFlavor`が直列化オブジェクトを表すかどうか。
`boolean`	`isRepresentationClassByteBuffer()`	この`DataFlavor`の表現クラスが`java.nio.ByteBuffer`か、またはそのサブクラスのどちらであるかを返します。
`boolean`	`isRepresentationClassCharBuffer()`	この`DataFlavor`の表現クラスが`java.nio.CharBuffer`か、またはそのサブクラスのどちらであるかを返します。
`boolean`	`isRepresentationClassInputStream()`	`DataFlavor`が`java.io.InputStream`を表すかどうか。
`boolean`	`isRepresentationClassReader()`	この`DataFlavor`の表現クラスが`java.io.Reader`か、またはそのサブクラスのどちらであるかを返します。
`boolean`	`isRepresentationClassRemote()`	表現クラスが`Remote`である場合はtrueを返します。
`boolean`	`isRepresentationClassSerializable()`	表現クラスを直列化できる場合はtrueを返します。
`boolean`	`match(DataFlavor that)`	`equals(DataFlavor)`と同じ。
`protected String`	`normalizeMimeType(String mimeType)`	非推奨。
`protected String`	`normalizeMimeTypeParameter(String parameterName, String parameterValue)`	非推奨。
`void`	`readExternal(ObjectInput is)`	この`DataFlavor`を直列化された状態から復元します。
`static DataFlavor`	`selectBestTextFlavor(DataFlavor[] availableFlavors)`	`DataFlavor`の配列から最適なテキスト`DataFlavor`を選択します。
`void`	`setHumanPresentableName(String humanPresentableName)`	この`DataFlavor`が表すデータ形式の判読できる名前を設定します。
`String`	`toString()`	この`DataFlavor`とそのパラメータの文字列表現。
`protected static Class<?>`	`tryToLoadClass(String className, ClassLoader fallback)`	ブートストラップ・ローダー、システム・ローダー、コンテキスト・ローダー(存在する場合)、指定されたローダーの順番でクラスのロードを試みます。
`void`	`writeExternal(ObjectOutput os)`	この`DataFlavor`を直列化します。

クラス java.lang.Objectから継承されたメソッド
finalize, getClass, notify, notifyAll, wait, wait, wait

- フィールドの詳細
  - stringFlavor
```
public static final DataFlavor stringFlavor
```
    Java Unicode Stringクラスを表すDataFlavor。ここでは、次のようになります。
```
     representationClass = java.lang.String
     mimeType           = "application/x-java-serialized-object"
 
```
  - imageFlavor
```
public static final DataFlavor imageFlavor
```
    Java Imageクラスを表すDataFlavor。ここでは、次のようになります。
```
     representationClass = java.awt.Image
     mimeType            = "image/x-java-image"
 
```
  - plainTextFlavor
```
@Deprecated
public static final DataFlavor plainTextFlavor
```
    非推奨。1.3以降。 Transferable.getTransferData(DataFlavor.plainTextFlavor)の代わりにDataFlavor.getReaderForText(Transferable)を使用します。
    Unicodeエンコーディングでプレーン・テキストを表すDataFlavor。
```
     representationClass = InputStream
     mimeType            = "text/plain; charset=unicode"
 
```
    このDataFlavorは、次の理由により非推奨になりました。(1)その表現がInputStream、8ビット形式であるのに対し、Unicodeは16ビット文字セットである。(2) charset「unicode」は明確になっていない。「unicode」は共通プラットフォームの実装ではなくUnicodeの特定のプラットフォームの実装を意味している。
  - javaSerializedObjectMimeType
```
public static final String javaSerializedObjectMimeType
```
    application/x-java-serialized-objectというMIMEタイプは、永続化されたJavaオブジェクト(複数可)のグラフを表します。このDataFlavorに関連付けられた表現クラスによって、java.awt.datatransfer.getTransferDataの呼び出しからの参照として返されたオブジェクトのJava型が識別されます。
    
    関連項目:
    
    定数フィールド値
  - javaFileListFlavor
```
public static final DataFlavor javaFileListFlavor
```
    Java (および基本となるプラットフォーム)との間でファイルのリストを転送するには、このタイプ/サブタイプのDataFlavorと、java.util.Listの表現クラスが使用されます。リストの各要素はjava.io.File型であることが要求されるか、または保証されます。
  - javaJVMLocalObjectMimeType
```
public static final String javaJVMLocalObjectMimeType
```
    MIMEコンテンツ・タイプが関連付けられていない任意のJavaオブジェクト参照への参照を同じJVM内のTransferableインタフェース経由で転送するには、このタイプ/サブタイプのDataFlavorが、Transferable経由で渡されるクラス/インタフェースのタイプに等しいrepresentationClassとともに使用されます。
    このMIMEコンテンツ・タイプのDataFlavorに対してTransferable.getTransferDataから返されたオブジェクト参照は、DataFlavorの表現クラスのインスタンスである必要があります。
    
    関連項目:
    
    定数フィールド値
  - javaRemoteObjectMimeType
```
public static final String javaRemoteObjectMimeType
```
    有効なリンクをドラッグ&ドロップACTION_LINK操作によってリモート・オブジェクトに渡すには、application/x-java-remote-objectのMIMEコンテンツ・タイプを使用するようにしてください。ここで、DataFlavorの表現クラスは、転送されるRemoteインタフェースのタイプを表します。
    
    関連項目:
    
    定数フィールド値
  - selectionHtmlFlavor
```
public static DataFlavor selectionHtmlFlavor
```
    1つのHTMLマークアップを表します。このマークアップは、ソース側で選択された部分で構成されます。したがって、マークアップの一部のタグには、対応するタグがない場合があります。フレーバを使用してTransferableインスタンス内のデータが表されている場合、追加の変更は行われません。このDataFlavorインスタンスは、コンテンツのMIMEタイプにドキュメント・パラメータが含まれておらず、表現クラスがStringクラスであるDataFlavorインスタンスと同じHTMLマークアップを表しています。
```
     representationClass = String
     mimeType           = "text/html"
 
```
  - fragmentHtmlFlavor
```
public static DataFlavor fragmentHtmlFlavor
```
    1つのHTMLマークアップを表します。可能な場合は、ネイティブ・システムから受け取ったマークアップが補足され、ペア・タグが整形式のHTMLマークアップになります。フレーバを使用してTransferableインスタンス内のデータが表されている場合、追加の変更は行われません。
```
     representationClass = String
     mimeType           = "text/html"
 
```
  - allHtmlFlavor
```
public static DataFlavor allHtmlFlavor
```
    1つのHTMLマークアップを表します。可能な場合は、ネイティブ・システムから受け取ったマークアップが補足され、追加のタグによって整形式のHTMLドキュメントが作成されます。フレーバを使用してTransferableインスタンス内のデータが表されている場合、追加の変更は行われません。
```
     representationClass = String
     mimeType           = "text/html"
 
```
- コンストラクタの詳細
  - DataFlavor
```
public DataFlavor()
```
    新しいDataFlavorを構築します。このコンストラクタは、Externalizableインタフェースをサポートする目的のためにのみ提供されます。 public (クライアント)使用を目的とはしていません。
    
    導入されたバージョン:
    
    1.2
  - DataFlavor
```
public DataFlavor(Class<?> representationClass,
                  String humanPresentableName)
```
    Javaクラスを表すDataFlavorを構築します。
    返されたDataFlavorには次の特性があります。
```
    representationClass = representationClass
    mimeType            = application/x-java-serialized-object
 
```
    パラメータ:
    
    representationClass - このフレーバでデータを転送するために使用されるクラス
    
    humanPresentableName - このフレーバを識別するために使用される、人間が読める形式の文字列。このパラメータがnullである場合は、MIMEコンテンツ・タイプの値が使用されます。
    
    例外:
    
    NullPointerException - representationClassがnullの場合
  - DataFlavor
```
public DataFlavor(String mimeType,
                  String humanPresentableName)
```
    MimeTypeを表すDataFlavorを構築します。
    返されたDataFlavorには次の特性があります。
    mimeTypeが「application/x-java-serialized-object; class=<representation class>」である場合、結果はnew DataFlavor(Class:forName(<representation class>)の呼び出しと同じになります。
    そうでない場合は、次のようになります。
```
     representationClass = InputStream
     mimeType            = mimeType
 
```
    パラメータ:
    
    mimeType - このフレーバのMIMEタイプを識別するために使用される文字列。mimeTypeで「class=」パラメータが指定されていない場合、またはクラスが正常にロードされない場合は、IllegalArgumentExceptionがスローされる
    
    humanPresentableName - このフレーバを識別するために使用される、人間が読める形式の文字列。このパラメータがnullである場合は、MIMEコンテンツ・タイプの値が使用されます。
    
    例外:
    
    IllegalArgumentException - mimeTypeが無効な場合、またはクラスが正常にロードされない場合
    
    NullPointerException - mimeTypeがnullの場合
  - DataFlavor
```
public DataFlavor(String mimeType,
                  String humanPresentableName,
                  ClassLoader classLoader)
           throws ClassNotFoundException
```
    MimeTypeを表すDataFlavorを構築します。
    返されたDataFlavorには次の特性があります。
    mimeTypeが「application/x-java-serialized-object; class=<representation class>」である場合、結果はnew DataFlavor(Class:forName(<representation class>)の呼び出しと同じになります。
    そうでない場合は、次のようになります。
```
     representationClass = InputStream
     mimeType            = mimeType
 
```
    パラメータ:
    
    mimeType - このフレーバのMIMEタイプを識別するために使用される文字列
    
    humanPresentableName - このフレーバを識別するために使用される人間が読める形式の文字列
    
    classLoader - 使用するクラス・ローダー
    
    例外:
    
    ClassNotFoundException - クラスがロードされていない場合
    
    IllegalArgumentException - mimeTypeが無効である場合
    
    NullPointerException - mimeTypeがnullの場合
  - DataFlavor
```
public DataFlavor(String mimeType)
           throws ClassNotFoundException
```
    mimeType文字列からDataFlavorを構築します。文字列は、「class=<fully specified Java class name>」パラメータを指定し、指定した表現クラスでDataFlavorを作成できます。この文字列に「class=」パラメータが含まれていない場合は、java.io.InputStreamがデフォルトとして使用されます。
    
    パラメータ:
    
    mimeType - このフレーバのMIMEタイプを識別するために使用される文字列。「class=」パラメータで指定されたクラスが正常にロードされない場合は、ClassNotFoundExceptionがスローされる
    
    例外:
    
    ClassNotFoundException - クラスがロードされていない場合
    
    IllegalArgumentException - mimeTypeが無効である場合
    
    NullPointerException - mimeTypeがnullの場合
- メソッドの詳細
  - tryToLoadClass
```
protected static final Class<?> tryToLoadClass(String className,
                                               ClassLoader fallback)
                                        throws ClassNotFoundException
```
    ブートストラップ・ローダー、システム・ローダー、コンテキスト・ローダー(存在する場合)、指定されたローダーの順番でクラスのロードを試みます。
    
    パラメータ:
    
    className - ロードされるクラスの名前
    
    fallback - 代替用ローダー
    
    戻り値:
    
    ロードされたクラス
    
    例外:
    
    ClassNotFoundException - クラスが見つからない場合
  - toString
```
public String toString()
```
    このDataFlavorとそのパラメータの文字列表現。結果として得られるStringには、DataFlavorクラスの名前、このフレーバのMIMEタイプ、およびその表現クラスが含まれます。このフレーバに「テキスト」のプライマリMIMEタイプがあり、文字セット・パラメータをサポートしていて、符号化された表現がある場合には、フレーバの文字セットも含まれます。文字セット・パラメータをサポートするテキスト・フレーバのリストについては、selectBestTextFlavorを参照してください。
    
    オーバーライド:
    
    toString、クラスObject
    
    戻り値:
    
    このDataFlavorの文字列表現
    
    関連項目:
    
    selectBestTextFlavor(java.awt.datatransfer.DataFlavor[])
  - getTextPlainUnicodeFlavor
```
public static final DataFlavor getTextPlainUnicodeFlavor()
```
    Unicodeエンコーディングでプレーン・テキストを表すDataFlavorを返します。ここでは、次のようになります。
```
     representationClass = java.io.InputStream
     mimeType            = "text/plain;
                            charset=<platform default Unicode encoding>"
 
```
    Microsoft Windows向けのSunの実装では、utf-16leエンコーディングを使用します。 SolarisおよびLinux向けのSunの実装では、iso-10646-ucs-2エンコーディングを使用します。
    戻り値:
    
    Unicodeエンコーディングでプレーン・テキストを表すDataFlavor
    
    導入されたバージョン:
    
    1.3
  - selectBestTextFlavor
```
public static final DataFlavor selectBestTextFlavor(DataFlavor[] availableFlavors)
```
    DataFlavorの配列から最適なテキストDataFlavorを選択します。選択肢として見なされるのは、DataFlavor.stringFlavor、同等のフレーバ、および「text」のプライマリMIMEタイプを持つフレーバだけです。
    最初に、フレーバはMIMEタイプで次の順にソートされます。
    - "text/sgml"
    - "text/xml"
    - "text/html"
    - "text/rtf"
    - "text/enriched"
    - "text/richtext"
    - "text/uri-list"
    - "text/tab-separated-values"
    - "text/t140"
    - "text/rfc822-headers"
    - "text/parityfec"
    - "text/directory"
    - "text/css"
    - "text/calendar"
    - "application/x-java-serialized-object"
    - "text/plain"
    - "text/<その他>"
    たとえば、「text/sgml」は「text/html」より先に選択され、DataFlavor.stringFlavorはDataFlavor.plainTextFlavorより先に選択されます。
    配列で2つ以上のフレーバが最適なMIMEタイプを共有している場合は、そのMIMEタイプが文字セット・パラメータをサポートしているかどうか確認されます。
    文字セット・パラメータをサポートしている、またはサポートしているかのように扱われるMIMEタイプは次のとおりです。
    - "text/sgml"
    - "text/xml"
    - "text/html"
    - "text/enriched"
    - "text/richtext"
    - "text/uri-list"
    - "text/directory"
    - "text/css"
    - "text/calendar"
    - "application/x-java-serialized-object"
    - "text/plain"
    文字セット・パラメータをサポートしていない、またはサポートしていないかのように扱われるMIMEタイプは次のとおりです。
    - "text/rtf"
    - "text/tab-separated-values"
    - "text/t140"
    - "text/rfc822-headers"
    - "text/parityfec"
    「text/<その他>」のMIMEタイプの場合は、MIMEタイプで文字セット・パラメータがサポートされているかどうかをはじめて判定する必要が発生すると、JREは、そのMIMEタイプを使用する任意に選択されたDataFlavorにそのパラメータが明示的にリストされているかどうかをチェックします。その場合、JREはその時点から、MIMEタイプが文字セット・パラメータをサポートしていると仮定し、再度確認することはありません。パラメータが明示的にリストされていない場合、JREはその時点から、MIMEタイプが文字セット・パラメータをサポートしていないと仮定し、再度確認することはありません。このチェックは任意に選択されたDataFlavorに対して実行されるため、そのMIMEタイプで文字セット・パラメータがサポートされている場合、開発者は「text/<その他>」のMIMEタイプを持つすべてのDataFlavorで文字セット・パラメータが確実に指定されているようにする必要があります。開発者は、「text/<その他>」のDataFlavorがJREによってプラットフォームのデフォルトの文字セットに置き換えられることに依存してはいけません。この制限に従わない場合、定義されていない動作が発生します。
    配列内の最適なMIMEタイプで文字セット・パラメータがサポートされていない場合、そのMIMEタイプを共有するフレーバは、その表現クラスによってjava.io.InputStream、java.nio.ByteBuffer、[B、<残りすべて>の順にソートされます。
    2つ以上のフレーバで最適な表現クラスを共有している場合、または指定された3つの表現のいずれかを持つフレーバがない場合は、それらのフレーバのいずれか1つが無作為に選択されます。
    配列内の最適なMIMEタイプで文字セット・パラメータがサポートされている場合、そのMIMEタイプを共有するフレーバは、その表現クラスによってjava.io.Reader、java.lang.String、java.nio.CharBuffer、[C、<残りすべて>の順にソートされます。
    2つ以上のフレーバで最適な表現クラスを共有しており、その表現が明示的にリストした4つのいずれかである場合、それらのフレーバのいずれか1つが無作為に選択されます。ただし、指定された4つの表現のいずれかを持つフレーバがない場合、フレーバはその文字セットでソートされます。 UTF-16、UTF-8、UTF-16BE、UTF-16LEなどのUnicode文字セットとそのエイリアスが最適であるとみなされます。その後、プラットフォームのデフォルト文字セットとそのエイリアスが選択されます。 US-ASCIIとそのエイリアスはもっとも不適です。その他の文字セットはアルファベット順に選択されます。ただし、Javaプラットフォームの実装でサポートされている文字セットに限られます。
    2つ以上のフレーバが最適な文字セットを共有している場合、フレーバは再度、その表現クラスによってjava.io.InputStream、java.nio.ByteBuffer、[B、<残りすべて>の順にソートされます。
    2つ以上のフレーバで最適な表現クラスを共有している場合、または指定された3つの表現のいずれかを持つフレーバがない場合は、それらのフレーバのいずれか1つが無作為に選択されます。
    パラメータ:
    
    availableFlavors - 使用可能なDataFlavorの配列
    
    戻り値:
    
    上で指定されたルールに関して最適な(最適合)フレーバ。availableFlavorsがnullか、長さがゼロか、またはテキスト・フレーバを含まない場合はnull
    
    導入されたバージョン:
    
    1.3
  - getReaderForText
```
public Reader getReaderForText(Transferable transferable)
                        throws UnsupportedFlavorException,
                               IOException
```
    必要に応じて、予想される文字セット(エンコード)をデコードしたテキスト・フレーバのReaderを取得します。サポートされる表現クラスは、java.io.Reader、java.lang.String、java.nio.CharBuffer、[C、java.io.InputStream、java.nio.ByteBuffer、および[Bです。
    文字セット・パラメータをサポートしていないテキスト・フレーバは標準以外のフォーマットで符号化されるため、そのようなフレーバに対してこのメソッドを呼び出すべきではありません。ただし、下位互換性を維持するために、そのようなフレーバでこのメソッドが呼び出された場合は、文字セット・パラメータをサポートしているかのようにフレーバを扱い、それに従ってデコードしようとします。文字セット・パラメータをサポートしていないテキスト・フレーバのリストについては、selectBestTextFlavorを参照してください。
    
    パラメータ:
    
    transferable - このフレーバでデータが要求されるTransferable
    
    戻り値:
    
    Transferableのデータを読み込むためのReader
    
    例外:
    
    IllegalArgumentException - 表現クラスが上記の7つのリストにない場合
    
    IllegalArgumentException - Transferableにnullデータが含まれている場合
    
    NullPointerException - Transferableがnullである場合
    
    UnsupportedEncodingException - このフレーバの表現がjava.io.InputStream、java.nio.ByteBuffer、または[Bであり、かつこのフレーバのエンコーディングがこのJavaプラットフォームの実装でサポートされていない場合
    
    UnsupportedFlavorException - Transferableがこのフレーバをサポートしていない場合
    
    IOException - 入出力エラーのためにデータを読み込めない場合
    
    導入されたバージョン:
    
    1.3
    
    関連項目:
    
    selectBestTextFlavor(java.awt.datatransfer.DataFlavor[])
  - getMimeType
```
public String getMimeType()
```
    このDataFlavorのMIMEタイプの文字列を返します。
    
    戻り値:
    
    このフレーバのMIMEタイプの文字列
  - getRepresentationClass
```
public Class<?> getRepresentationClass()
```
    このDataFlavorが要求されたときに、このDataFlavorをサポートしているオブジェクトが返すClassを返します。
    
    戻り値:
    
    このDataFlavorが要求されたときに、このDataFlavorをサポートしているオブジェクトが返すClass
  - getHumanPresentableName
```
public String getHumanPresentableName()
```
    このDataFlavorが表すデータ形式の判読できる名前を返します。この名前は、それぞれの国に対応した名前になります。
    
    戻り値:
    
    このDataFlavorが表すデータ形式の判読できる名前
  - getPrimaryType
```
public String getPrimaryType()
```
    このDataFlavorのプライマリMIMEタイプを返します。
    
    戻り値:
    
    このDataFlavorのプライマリMIMEタイプ
  - getSubType
```
public String getSubType()
```
    このDataFlavorのサブMIMEタイプを返します。
    
    戻り値:
    
    このDataFlavorのサブMIMEタイプ
  - getParameter
```
public String getParameter(String paramName)
```
    paramNameが「humanPresentableName」に等しい場合は、このDataFlavorの判読できる名前を返します。そうでない場合は、paramNameに関連付けられたMIMEタイプの値を返します。
    
    パラメータ:
    
    paramName - 要求されたパラメータ名
    
    戻り値:
    
    名前パラメータの値。関連付けられた値がない場合はnull
  - setHumanPresentableName
```
public void setHumanPresentableName(String humanPresentableName)
```
    このDataFlavorが表すデータ形式の判読できる名前を設定します。この名前は、それぞれの国に対応した名前になります。
    
    パラメータ:
    
    humanPresentableName - 新しい判読できる名前
  - equals
```
public boolean equals(Object o)
```
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    equalsメソッドは、null以外のオブジェクト参照での同値関係を実装します。
    - 反射性(reflexive): null以外の参照値xについて、x.equals(x)はtrueを返します。
    - 対称性(symmetric): null以外の参照値xおよびyについて、y.equals(x)がtrueを返す場合に限り、x.equals(y)はtrueを返します。
    - 推移性(transitive): null以外の参照値x、y、およびzについて、x.equals(y)がtrueを返し、y.equals(z)がtrueを返す場合、x.equals(z)はtrueを返します。
    - 一貫性(consistent): null以外の参照値xおよびyについて、x.equals(y)の複数の呼出しは、このオブジェクトに対するequalsによる比較で使われた情報が変更されていなければ、一貫してtrueを返すか、一貫してfalseを返します。
    - null以外の参照値xについて、x.equals(null)はfalseを返します。
    Objectクラスのequalsメソッドは、もっとも比較しやすいオブジェクトの同値関係を実装します。つまり、null以外の参照値xとyについて、このメソッドはxとyが同じオブジェクトを参照する(x == yがtrue)場合にだけtrueを返します。
    通常、このメソッドをオーバーライドする場合は、hashCodeメソッドを常にオーバーライドして、「等価なオブジェクトは等価なハッシュ・コードを保持する必要がある」というhashCodeメソッドの汎用規約に従う必要があることに留意してください。
    DataFlavorクラスが等しいかどうかの比較は、次のように実行されます。2つのDataFlavorは、それらのMIMEプライマリ・タイプ、サブタイプ、および表現クラスが等しい場合にのみ等しいと見なされます。さらに、プライマリ・タイプが「text」であり、サブタイプが文字セット・パラメータをサポートするテキスト・フレーバを示し、さらに表現クラスがjava.io.Reader、java.lang.String、java.nio.CharBuffer、[Cのいずれでもない場合は、charsetパラメータも等しいと見なされます。 DataFlavorのどちらかまたは両方で文字セットが明示的に指定されていない場合は、プラットフォームのデフォルト・エンコーディングが使用されます。文字セット・パラメータをサポートするテキスト・フレーバのリストについては、selectBestTextFlavorを参照してください。
    オーバーライド:
    
    equals、クラスObject
    
    パラメータ:
    
    o - thisと比較するObject
    
    戻り値:
    
    thatがこのDataFlavorと同等である場合はtrue、そうでない場合はfalse
    
    関連項目:
    
    selectBestTextFlavor(java.awt.datatransfer.DataFlavor[])
  - equals
```
public boolean equals(DataFlavor that)
```
    このメソッドの動作は、equals(Object)と同じです。異なる点は、パラメータとしてDataFlavorインスタンスを取ることだけです。
    
    パラメータ:
    
    that - thisと比較するDataFlavor
    
    戻り値:
    
    thatがこのDataFlavorと同等である場合はtrue、そうでない場合はfalse
    
    関連項目:
    
    selectBestTextFlavor(java.awt.datatransfer.DataFlavor[])
  - equals
```
@Deprecated
public boolean equals(String s)
```
    非推奨。 hashCode()規約と矛盾するので、代わりにisMimeTypeEqual(String)を使用してください。
    
    mimeTypeのみを渡されたStringと比較します。representationClassは比較で考慮されません。 representationClassを比較する必要がある場合は、equals(new DataFlavor(s))を使用できます。
    
    パラメータ:
    
    s - 比較するmimeType。
    
    戻り値:
    
    文字列(MimeType)が等しい場合はtrue。そうでない場合、またはsがnullの場合はfalse
  - hashCode
```
public int hashCode()
```
    このDataFlavorのハッシュ・コードを返します。 2つのDataFlavorが等しい場合は、ハッシュ・コードも等しくなります。 DataFlavor.equals(String)に一致するStringの場合は、DataFlavorのハッシュ・コードがStringのハッシュ・コードに等しいことは保証されません。
    
    オーバーライド:
    
    hashCode、クラスObject
    
    戻り値:
    
    このDataFlavorのハッシュ・コード
    
    関連項目:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - match
```
public boolean match(DataFlavor that)
```
    equals(DataFlavor)と同じ。
    
    パラメータ:
    
    that - thisと比較するDataFlavor
    
    戻り値:
    
    thatがこのDataFlavorと同等である場合はtrue、そうでない場合はfalse
    
    導入されたバージョン:
    
    1.3
    
    関連項目:
    
    selectBestTextFlavor(java.awt.datatransfer.DataFlavor[])
  - isMimeTypeEqual
```
public boolean isMimeTypeEqual(String mimeType)
```
    渡されたMIMEタイプの文字列表現がこのDataFlavorのMIMEタイプと同等であるかどうかを返します。パラメータは比較の対象ではありません。
    
    パラメータ:
    
    mimeType - MIMEタイプの文字列表現
    
    戻り値:
    
    渡されたMIMEタイプの文字列表現がこのDataFlavorのMIMEタイプと同等である場合はtrue。そうでない場合はfalse
    
    例外:
    
    NullPointerException - mimeTypeがnullの場合
  - isMimeTypeEqual
```
public final boolean isMimeTypeEqual(DataFlavor dataFlavor)
```
    2つのDataFlavorオブジェクトのmimeTypeを比較します。パラメータは比較の対象ではありません。
    
    パラメータ:
    
    dataFlavor - 比較対象のDataFlavor
    
    戻り値:
    
    MimeTypeが等しい場合はtrue。そうでない場合はfalse
  - isMimeTypeSerializedObject
```
public boolean isMimeTypeSerializedObject()
```
    DataFlavorが直列化オブジェクトを表すかどうか。
  - getDefaultRepresentationClass
```
public final Class<?> getDefaultRepresentationClass()
```
  - getDefaultRepresentationClassAsString
```
public final String getDefaultRepresentationClassAsString()
```
  - isRepresentationClassInputStream
```
public boolean isRepresentationClassInputStream()
```
    DataFlavorがjava.io.InputStreamを表すかどうか。
  - isRepresentationClassReader
```
public boolean isRepresentationClassReader()
```
    このDataFlavorの表現クラスがjava.io.Readerか、またはそのサブクラスのどちらであるかを返します。
    
    導入されたバージョン:
    
    1.4
  - isRepresentationClassCharBuffer
```
public boolean isRepresentationClassCharBuffer()
```
    このDataFlavorの表現クラスがjava.nio.CharBufferか、またはそのサブクラスのどちらであるかを返します。
    
    導入されたバージョン:
    
    1.4
  - isRepresentationClassByteBuffer
```
public boolean isRepresentationClassByteBuffer()
```
    このDataFlavorの表現クラスがjava.nio.ByteBufferか、またはそのサブクラスのどちらであるかを返します。
    
    導入されたバージョン:
    
    1.4
  - isRepresentationClassSerializable
```
public boolean isRepresentationClassSerializable()
```
    表現クラスを直列化できる場合はtrueを返します。
    
    戻り値:
    
    表現クラスを直列化できる場合はtrue
  - isRepresentationClassRemote
```
public boolean isRepresentationClassRemote()
```
    表現クラスがRemoteである場合はtrueを返します。
    
    戻り値:
    
    表現クラスがRemoteである場合はtrue
  - isFlavorSerializedObjectType
```
public boolean isFlavorSerializedObjectType()
```
    指定されたDataFlavorが直列化オブジェクトを表す場合はtrueを返します。
    
    戻り値:
    
    指定されたDataFlavorが直列化オブジェクトを表す場合はtrue
  - isFlavorRemoteObjectType
```
public boolean isFlavorRemoteObjectType()
```
    指定されたDataFlavorがリモート・オブジェクトを表す場合はtrueを返します。
    
    戻り値:
    
    指定されたDataFlavorがリモート・オブジェクトを表す場合はtrue
  - isFlavorJavaFileListType
```
public boolean isFlavorJavaFileListType()
```
    指定されたDataFlavorがファイル・オブジェクトのリストを表す場合はtrueを返します。
    
    戻り値:
    
    指定されたDataFlavorがファイル・オブジェクトのリストを表す場合はtrue
  - isFlavorTextType
```
public boolean isFlavorTextType()
```
    このDataFlavorがJavaプラットフォームのこの実装のための有効なテキスト・フレーバであるかどうかを返します。有効なテキスト・フレーバとして指定できるのは、DataFlavor.stringFlavorと同等のフレーバと、「text」のプライマリMIMEタイプを持つDataFlavorだけです。
    このフレーバが文字セット・パラメータをサポートしている場合は、そのフレーバがDataFlavor.stringFlavorと同等である必要がある必要があります。または、その表現がjava.io.Reader、java.lang.String、java.nio.CharBuffer、[C、java.io.InputStream、java.nio.ByteBuffer、[Bのいずれかである必要があります。その表現がjava.io.InputStream、java.nio.ByteBuffer、または[Bである場合は、このフレーバのcharsetパラメータがこのJavaプラットフォームの実装でサポートされている必要があります。文字セットが指定されていない場合は、常にサポートされているプラットフォームのデフォルト文字セットが仮定されます。
    このフレーバが文字セット・パラメータをサポートしていない場合、その表現はjava.io.InputStream、java.nio.ByteBuffer、または[Bである必要があります。
    文字セット・パラメータをサポートするテキスト・フレーバのリストについては、selectBestTextFlavorを参照してください。
    
    戻り値:
    
    このDataFlavorが上で説明されている有効なテキスト・フレーバである場合はtrue。そうでない場合はfalse
    
    導入されたバージョン:
    
    1.4
    
    関連項目:
    
    selectBestTextFlavor(java.awt.datatransfer.DataFlavor[])
  - writeExternal
```
public void writeExternal(ObjectOutput os)
                   throws IOException
```
    このDataFlavorを直列化します。
    
    定義:
    
    writeExternal、インタフェースExternalizable
    
    パラメータ:
    
    os - オブジェクトを書き込むストリーム
    
    例外:
    
    IOException - 発生する可能性のあるすべての入出力例外を含む
  - readExternal
```
public void readExternal(ObjectInput is)
                  throws IOException,
                         ClassNotFoundException
```
    このDataFlavorを直列化された状態から復元します。
    
    定義:
    
    readExternal、インタフェースExternalizable
    
    パラメータ:
    
    is - オブジェクトを復元するためのデータ読込み元のストリーム
    
    例外:
    
    IOException - 入出力エラーが発生した場合
    
    ClassNotFoundException - 復元されているオブジェクトのクラスが見つからない場合。
  - clone
```
public Object clone()
             throws CloneNotSupportedException
```
    このDataFlavorの複製を返します。
    
    オーバーライド:
    
    clone、クラスObject
    
    戻り値:
    
    このDataFlavorの複製
    
    例外:
    
    CloneNotSupportedException - オブジェクトのクラスがCloneableインタフェースをサポートしていない場合。 cloneメソッドをオーバーライドしたサブクラスも、インスタンスを複製できないことを示すためにこの例外をスローすることがある
    
    関連項目:
    
    Cloneable
  - normalizeMimeTypeParameter
```
@Deprecated
protected String normalizeMimeTypeParameter(String parameterName,
                                                        String parameterValue)
```
    非推奨。
    
    DataFlavorサブクラスが、値の大文字と小文字を区別しないtext/plainのcharsetパラメータなどの特殊なパラメータを取り扱えるようにするために、各MIMEタイプ・パラメータのDataFlavorに対して呼び出されます。 (MIMEタイプのパラメータ値は大文字と小文字を区別することになっています。)
    このメソッドはパラメータ名とパラメータ値のペアごとに呼び出され、parameterValueの正規化された表現を返さなければいけません。 1.1以降では、このメソッドがこの実装によって呼び出されることはありません。
  - normalizeMimeType
```
@Deprecated
protected String normalizeMimeType(String mimeType)
```
    非推奨。
    
    DataFlavorサブタイプにMIMEタイプの正規化の実現方法を変更する機会を与えるために、MIMEタイプ文字列ごとに呼び出されます。 MIMEタイプの文字列を渡すものがない場合に、デフォルトのパラメータ/値のペアを追加するために使用することもあります。 1.1以降では、このメソッドがこの実装によって呼び出されることはありません。

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスDataFlavor

フィールドのサマリー

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

フィールドの詳細

stringFlavor

imageFlavor

plainTextFlavor

javaSerializedObjectMimeType

javaFileListFlavor

javaJVMLocalObjectMimeType

javaRemoteObjectMimeType

selectionHtmlFlavor

fragmentHtmlFlavor

allHtmlFlavor

コンストラクタの詳細

DataFlavor

DataFlavor

DataFlavor

DataFlavor

DataFlavor

メソッドの詳細

tryToLoadClass

toString

getTextPlainUnicodeFlavor

selectBestTextFlavor

getReaderForText

getMimeType

getRepresentationClass

getHumanPresentableName

getPrimaryType

getSubType

getParameter

setHumanPresentableName

equals

equals

equals

hashCode

match

isMimeTypeEqual

isMimeTypeEqual

isMimeTypeSerializedObject

getDefaultRepresentationClass

getDefaultRepresentationClassAsString

isRepresentationClassInputStream

isRepresentationClassReader

isRepresentationClassCharBuffer

isRepresentationClassByteBuffer

isRepresentationClassSerializable

isRepresentationClassRemote

isFlavorSerializedObjectType

isFlavorRemoteObjectType

isFlavorJavaFileListType

isFlavorTextType

writeExternal

readExternal

clone

normalizeMimeTypeParameter

normalizeMimeType