SystemFlavorMap (Java Platform SE 8)

java.lang.Object
- java.awt.datatransfer.SystemFlavorMap

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

FlavorMap, FlavorTable
```
public final class SystemFlavorMap
extends Object
implements FlavorMap, FlavorTable
```
SystemFlavorMapは、プラットフォーム固有のデータ形式に対応する「ネイティブ」(文字列)と、プラットフォームから独立したMIMEタイプに対応する「フレーバ」(DataFlavors)の間の、構成可能なマップです。このマッピングは、Javaとネイティブ・アプリケーションの間、および別個のVM内のJavaアプリケーション間でデータを転送するために、データ転送サブシステムによって使用されます。

導入されたバージョン:

1.2

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッドと説明
`void`	`addFlavorForUnencodedNative(String nat, DataFlavor flav)` 1つの`String`ネイティブから1つの`DataFlavor`へのマッピングを追加します。
`void`	`addUnencodedNativeForFlavor(DataFlavor flav, String nat)` 指定された`DataFlavor` (および指定された`DataFlavor`に等しいすべての`DataFlavor`)から指定された`String`ネイティブへのマッピングを追加します。
`static DataFlavor`	`decodeDataFlavor(String nat)` `DataFlavor`として使用するために`String`ネイティブをデコードします。
`static String`	`decodeJavaMIMEType(String nat)` Java MIMEタイプとして使用するために`String`ネイティブをデコードします。
`static String`	`encodeDataFlavor(DataFlavor flav)` `String`ネイティブとして使用するために`DataFlavor`をエンコードします。
`static String`	`encodeJavaMIMEType(String mimeType)` `String`ネイティブとして使用するためにMIMEタイプをエンコードします。
`static FlavorMap`	`getDefaultFlavorMap()` このスレッドのClassLoaderの、デフォルトのFlavorMapを返します。
`List<DataFlavor>`	`getFlavorsForNative(String nat)` 指定された`String`ネイティブのデータ転送サブシステムによる変換の宛先にすることのできる`DataFlavor`の`List`を返します。
`Map<String,DataFlavor>`	`getFlavorsForNatives(String[] natives)` 指定された`String`ネイティブの、そのもっとも適切な`DataFlavor`への`Map`を返します。
`List<String>`	`getNativesForFlavor(DataFlavor flav)` 指定された`DataFlavor`のデータ転送サブシステムによる変換の宛先にすることのできる`String`ネイティブの`List`を返します。
`Map<DataFlavor,String>`	`getNativesForFlavors(DataFlavor[] flavors)` 指定された`DataFlavor`の、そのもっとも適切な`String`ネイティブへの`Map`を返します。
`static boolean`	`isJavaMIMEType(String str)` 指定された`String`がエンコードされたJava MIMEタイプであるかどうかを返します。
`void`	`setFlavorsForNative(String nat, DataFlavor[] flavors)` 指定された`String`ネイティブの現在のマッピングを破棄し、指定された`DataFlavor`への新しいマッピングを作成します。
`void`	`setNativesForFlavor(DataFlavor flav, String[] natives)` 指定された`DataFlavor`、および指定された`DataFlavor`に等しいすべての`DataFlavor`の現在のマッピングを破棄し、指定された`String`ネイティブへの新しいマッピングを作成します。

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

- メソッドの詳細
  - getDefaultFlavorMap
```
public static FlavorMap getDefaultFlavorMap()
```
    このスレッドのClassLoaderの、デフォルトのFlavorMapを返します。
  - getNativesForFlavor
```
public List<String> getNativesForFlavor(DataFlavor flav)
```
    指定されたDataFlavorのデータ転送サブシステムによる変換の宛先にすることのできるStringネイティブのListを返します。Listは、もっとも適しているネイティブからもっとも適していないものの順にソートされます。つまり、基本となるネイティブ・プラット・フォームに指定されたフレーバのデータをもっともよく反映するのは、最初のネイティブということになります。
    指定されたDataFlavorが以前にデータ転送サブシステムに認識されておらず、データ転送サブシステムがこのDataFlavorを既存のネイティブに変換できない場合は、このメソッドを呼び出すと、指定されたDataFlavorと、そのMIMEタイプのネイティブとしてエンコードされたバージョンの間の双方向のマッピングが確立されます。
    
    定義:
    
    getNativesForFlavor、インタフェース: FlavorTable
    
    パラメータ:
    
    flav - 対応するネイティブが返されるDataFlavor。nullが指定されている場合は、現在データ転送サブシステムに認識されているすべてのネイティブが順序不定で返される。
    
    戻り値:
    
    プラットフォーム固有のデータ形式のプラットフォーム固有の表現であるjava.lang.Stringオブジェクトのjava.util.List
    
    導入されたバージョン:
    
    1.4
    
    関連項目:
    
    encodeDataFlavor(java.awt.datatransfer.DataFlavor)
  - getFlavorsForNative
```
public List<DataFlavor> getFlavorsForNative(String nat)
```
    指定されたStringネイティブのデータ転送サブシステムによる変換の宛先にすることのできるDataFlavorのListを返します。Listは、もっとも適しているDataFlavorからもっとも適していないものの順にソートされます。つまり、最初のDataFlavorが、Javaアプリケーションに指定されたネイティブ内のデータをもっともよく反映しています。
    指定されたネイティブが以前にデータ転送サブシステムに認識されておらず、そのネイティブが適切にエンコードされている場合は、このメソッドを呼び出すと、指定されたネイティブと、デコードされたバージョンのネイティブをMIMEタイプとして持つDataFlavorの間の双方向のマッピングが確立されます。
    指定されたネイティブが適切にエンコードされたネイティブではなく、このネイティブのマッピングがsetFlavorsForNativeによって変更されていない場合、Listの内容はプラットフォームに依存しますが、nullを返すことはできません。
    
    定義:
    
    getFlavorsForNative、インタフェース: FlavorTable
    
    パラメータ:
    
    nat - 対応するDataFlavorが返されるネイティブ。nullが指定されている場合は、現在データ転送サブシステムに認識されているすべてのDataFlavorが順序不定で返される。
    
    戻り値:
    
    指定されたプラットフォーム固有ネイティブ内のプラットフォーム固有データの変換先にできるDataFlavorオブジェクトのjava.util.List
    
    導入されたバージョン:
    
    1.4
    
    関連項目:
    
    encodeJavaMIMEType(java.lang.String)
  - getNativesForFlavors
```
public Map<DataFlavor,String> getNativesForFlavors(DataFlavor[] flavors)
```
    指定されたDataFlavorの、そのもっとも適切なStringネイティブへのMapを返します。各ネイティブ値は、指定されたフレーバに対してgetNativesForFlavorが返すリスト内の最初のネイティブと同じになります。
    指定されたDataFlavorが以前にデータ転送サブシステムに認識されていない場合は、このメソッドを呼び出すと、指定されたDataFlavorと、そのMIMEタイプをネイティブとしてエンコードしたものとの間で、双方向のマッピングが確立されます。
    
    定義:
    
    getNativesForFlavors、インタフェース: FlavorMap
    
    パラメータ:
    
    flavors - 返されたMapの鍵セットになるDataFlavorの配列。nullが指定されている場合は、データ転送サブシステムに認識されているすべてのDataFlavorから、そのもっとも適切なStringネイティブへのマッピングが返される。
    
    戻り値:
    
    DataFlavorからStringネイティブへのjava.util.Map
    
    関連項目:
    
    getNativesForFlavor(java.awt.datatransfer.DataFlavor), encodeDataFlavor(java.awt.datatransfer.DataFlavor)
  - getFlavorsForNatives
```
public Map<String,DataFlavor> getFlavorsForNatives(String[] natives)
```
    指定されたStringネイティブの、そのもっとも適切なDataFlavorへのMapを返します。各DataFlavor値は、指定されたネイティブに対してgetFlavorsForNativeによって返されるリスト内の最初のDataFlavorと同じになります。
    指定されたネイティブが以前にデータ転送サブシステムに認識されておらず、そのネイティブが適切にエンコードされている場合は、このメソッドを呼び出すと、指定されたネイティブと、デコードされたバージョンのネイティブをMIMEタイプとして持つDataFlavorの間の双方向のマッピングが確立されます。
    
    定義:
    
    getFlavorsForNatives、インタフェース: FlavorMap
    
    パラメータ:
    
    natives - 返されたMapの鍵セットになるStringの配列。nullが指定されている場合は、サポートされるすべてのStringネイティブから、そのもっとも適切なDataFlavorへのマッピングが返される。
    
    戻り値:
    
    StringネイティブからDataFlavorへのjava.util.Map
    
    関連項目:
    
    getFlavorsForNative(java.lang.String), encodeJavaMIMEType(java.lang.String)
  - addUnencodedNativeForFlavor
```
public void addUnencodedNativeForFlavor(DataFlavor flav,
                                        String nat)
```
    指定されたDataFlavor (および指定されたDataFlavorに等しいすべてのDataFlavor)から指定されたStringネイティブへのマッピングを追加します。getNativesForFlavorとは異なり、このマッピングは一方向にのみ確立され、ネイティブはエンコードされません。双方向のマッピングを確立するには、addFlavorForUnencodedNativeも呼び出します。新しいマッピングの優先度は、既存のマッピングよりも低くなります。指定された、または等しいDataFlavorから、指定されたStringネイティブへのマッピングがすでに存在する場合は、このメソッドに効果はありません。
    
    パラメータ:
    
    flav - マッピング用のDataFlavorキー
    
    nat - マッピング用のStringネイティブ値
    
    例外:
    
    NullPointerException - flavまたはnatがnullの場合
    
    導入されたバージョン:
    
    1.4
    
    関連項目:
    
    addFlavorForUnencodedNative(java.lang.String, java.awt.datatransfer.DataFlavor)
  - setNativesForFlavor
```
public void setNativesForFlavor(DataFlavor flav,
                                String[] natives)
```
    指定されたDataFlavor、および指定されたDataFlavorに等しいすべてのDataFlavorの現在のマッピングを破棄し、指定されたStringネイティブへの新しいマッピングを作成します。getNativesForFlavorとは異なり、このマッピングは一方向にのみ確立され、ネイティブはエンコードされません。双方向のマッピングを確立するには、setFlavorsForNativeも呼び出します。配列内の最初のネイティブは、優先度がもっとも高いマッピングを表します。続くネイティブでは、マッピングの優先度が下がっていきます。
    配列に、等しいStringネイティブを参照する複数の要素が含まれている場合、このメソッドは、これらのうちの最初の要素のための新しいマッピングを確立し、残りの要素を無視します。
    データ転送サブシステムが確立したマッピングをクライアント・コードでリセットしないようお薦めします。このメソッドは、アプリケーション・レベルのマッピングだけに使用します。
    
    パラメータ:
    
    flav - マッピング用のDataFlavorキー
    
    natives - マッピング用のStringネイティブ値
    
    例外:
    
    NullPointerException - flavまたはネイティブがnullの場合、またはネイティブにnull要素が含まれている場合
    
    導入されたバージョン:
    
    1.4
    
    関連項目:
    
    setFlavorsForNative(java.lang.String, java.awt.datatransfer.DataFlavor[])
  - addFlavorForUnencodedNative
```
public void addFlavorForUnencodedNative(String nat,
                                        DataFlavor flav)
```
    1つのStringネイティブから1つのDataFlavorへのマッピングを追加します。getFlavorsForNativeとは異なり、このマッピングは一方向にのみ確立され、ネイティブはエンコードされません。双方向のマッピングを確立するには、addUnencodedNativeForFlavorも呼び出します。新しいマッピングの優先度は、既存のマッピングよりも低くなります。指定されたStringネイティブから、指定された、または等しいDataFlavorへのマッピングがすでに存在する場合は、このメソッドに効果はありません。
    
    パラメータ:
    
    nat - マッピング用のStringネイティブ・キー
    
    flav - マッピング用のDataFlavor値
    
    例外:
    
    NullPointerException - natまたはflavがnullの場合
    
    導入されたバージョン:
    
    1.4
    
    関連項目:
    
    addUnencodedNativeForFlavor(java.awt.datatransfer.DataFlavor, java.lang.String)
  - setFlavorsForNative
```
public void setFlavorsForNative(String nat,
                                DataFlavor[] flavors)
```
    指定されたStringネイティブの現在のマッピングを破棄し、指定されたDataFlavorへの新しいマッピングを作成します。getFlavorsForNativeとは異なり、このマッピングは一方向にのみ確立され、ネイティブをエンコードする必要はありません。双方向のマッピングを確立するには、setNativesForFlavorも呼び出します。配列内の最初のDataFlavorは、優先度がもっとも高いマッピングを表します。以降のDataFlavorでは、マッピングの優先度が下がっていきます。
    配列に、等しいDataFlavorを参照する複数の要素が含まれている場合、このメソッドは、これらのうちの最初の要素のための新しいマッピングを確立し、残りの要素を無視します。
    データ転送サブシステムが確立したマッピングをクライアント・コードでリセットしないようお薦めします。このメソッドは、アプリケーション・レベルのマッピングだけに使用します。
    
    パラメータ:
    
    nat - マッピング用のStringネイティブ・キー
    
    flavors - マッピング用のDataFlavor値
    
    例外:
    
    NullPointerException - natまたはフレーバがnullの場合、またはフレーバにnull要素が含まれている場合
    
    導入されたバージョン:
    
    1.4
    
    関連項目:
    
    setNativesForFlavor(java.awt.datatransfer.DataFlavor, java.lang.String[])
  - encodeJavaMIMEType
```
public static String encodeJavaMIMEType(String mimeType)
```
    Stringネイティブとして使用するためにMIMEタイプをエンコードします。MIMEタイプのエンコードされた表現の形式は、実装に依存します。制限は次に示すものだけです。
    - エンコードされた表現がnullになるのは、MIMEタイプStringがnullの場合だけです。
    - null以外の2つのMIMEタイプStringのエンコードされた表現が等しいのは、これらのStringがString.equals(Object)に従って等しい場合だけです。
    このメソッドのリファレンス実装では、接頭辞JAVA_DATAFLAVOR:が付いた指定されたMIMEタイプStringを返します。
    パラメータ:
    
    mimeType - エンコードするMIMEタイプ
    
    戻り値:
    
    エンコードされたString。mimeTypeがnullの場合はnull
  - encodeDataFlavor
```
public static String encodeDataFlavor(DataFlavor flav)
```
    Stringネイティブとして使用するためにDataFlavorをエンコードします。エンコードされたDataFlavorの形式は、実装に依存します。制限は次に示すものだけです。
    - エンコードされた表現がnullになるのは、指定されたDataFlavorがnullか、またはそのMIMEタイプStringがnullの場合だけです。
    - null以外のMIMEタイプStringを持つnull以外の2つのDataFlavorのエンコードされた表現が等しいのは、これらのDataFlavorのMIMEタイプStringがString.equals(Object)に従って等しい場合だけです。
    このメソッドのリファレンス実装では、接頭辞JAVA_DATAFLAVOR:が付いた指定されたDataFlavorのMIMEタイプStringを返します。
    パラメータ:
    
    flav - エンコードするDataFlavor
    
    戻り値:
    
    エンコードされたString。flavがnullか、またはnullのMIMEタイプを持つ場合はnull
  - isJavaMIMEType
```
public static boolean isJavaMIMEType(String str)
```
    指定されたStringがエンコードされたJava MIMEタイプであるかどうかを返します。
    
    パラメータ:
    
    str - テストするString
    
    戻り値:
    
    Stringがエンコードされている場合はtrue。それ以外の場合はfalse
  - decodeJavaMIMEType
```
public static String decodeJavaMIMEType(String nat)
```
    Java MIMEタイプとして使用するためにStringネイティブをデコードします。
    
    パラメータ:
    
    nat - デコードするString
    
    戻り値:
    
    デコードされたJava MIMEタイプ。natがエンコードされたStringネイティブでない場合はnull
  - decodeDataFlavor
```
public static DataFlavor decodeDataFlavor(String nat)
                                   throws ClassNotFoundException
```
    DataFlavorとして使用するためにStringネイティブをデコードします。
    
    パラメータ:
    
    nat - デコードするString
    
    戻り値:
    
    デコードされたDataFlavor。natがエンコードされたStringネイティブでない場合はnull
    
    例外:
    
    ClassNotFoundException

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

クラスSystemFlavorMap

メソッドのサマリー

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

メソッドの詳細

getDefaultFlavorMap

getNativesForFlavor

getFlavorsForNative

getNativesForFlavors

getFlavorsForNatives

addUnencodedNativeForFlavor

setNativesForFlavor

addFlavorForUnencodedNative

setFlavorsForNative

encodeJavaMIMEType

encodeDataFlavor

isJavaMIMEType

decodeJavaMIMEType

decodeDataFlavor