SystemFlavorMap (Java Platform SE 7)

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

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

FlavorMap, FlavorTable
```
public final class SystemFlavorMap
extends Object
implements FlavorMap, FlavorTable
```
SystemFlavorMap は、プラットフォーム固有のデータ形式に対応する「ネイティブ」(文字列) と、プラットフォームから独立した MIME タイプに対応する「フレーバ」(DataFlavors) の間の、構成可能なマップです。このマッピングは、Java とネイティブアプリケーションの間、および別個の VM 内の Java アプリケーション間でデータを転送するために、データ転送サブシステムによって使用されます。
Sun のリファレンス実装では、デフォルトの SystemFlavorMap はファイル jre/lib/flavormap.properties、および AWT プロパティーの AWT.DnD.flavorMapFileURL で参照される URL のコンテンツによって初期化されます。詳細は、flavormap.properties を参照してください。

導入されたバージョン:

1.2

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`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) に従って等しい場合だけです。
    このメソッドの Sun のリファレンス実装では、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) に従って等しい場合だけです。
    このメソッドの Sun のリファレンス実装では、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, 2013, 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