- 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
-
-
メソッドのサマリー
修飾子と型 メソッド 説明 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
ネイティブへの新しいマッピングを作成します。
-
-
-
メソッドの詳細
-
getDefaultFlavorMap
public static FlavorMap getDefaultFlavorMap()
このスレッドのClassLoaderの、デフォルトのFlavorMapを返します。- 戻り値:
- このスレッドのデフォルトのFlavorMap ClassLoader
-
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
またはflavors
がnull
の場合、またはflavors
に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タイプ- 戻り値:
mimeType
がnull
ならば、エンコードされたString
、または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
- 戻り値:
flav
がnull
またはnull
MIMEタイプの場合は、エンコードされたString
または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
- 戻り値:
nat
がエンコードされたString
ネイティブでない場合、デコードされたDataFlavor
、またはnull
- 例外:
ClassNotFoundException
- データ・フレーバのクラスがロードされていない場合
-
-