java.awt.datatransfer
Class SystemFlavorMap

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

public final class SystemFlavorMap

extends Object

implements FlavorMap

The SystemFlavorMap is an externally configurable map that maps platform native type names (strings) to MIME type strings, and also their associated DataFlavors.

This map is used by the DnD system to map platform data types to MIME types to enable the transfer of objects between Java and the platform via the platform DnD System.

Since:

JDK1.2

Method Summary

static DataFlavor	decodeDataFlavor(String atom)
static String	decodeJavaMIMEType(String atom)
static String	encodeDataFlavor(DataFlavor df)
static String	encodeJavaMIMEType(String mimeType)
static FlavorMap	getDefaultFlavorMap() get the default system implementation
Map	getFlavorsForNatives(String[] natives) map natives to corresponding flavors
Map	getNativesForFlavors(DataFlavor[] flavors) map flavors to native data types names
static boolean	isJavaMIMEType(String atom)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getDefaultFlavorMap

public static FlavorMap getDefaultFlavorMap()

get the default system implementation

getNativesForFlavors

public Map getNativesForFlavors(DataFlavor[] flavors)

map flavors to native data types names

Specified by:

getNativesForFlavors in interface FlavorMap

Tags copied from interface: FlavorMap

Parameters:

flavors - The array of DataFlavors to map to native types, or null

Returns:

a Map object which contains between 0 or more entries with keys of type DataFlavor and values of type String, where the String values mapped (if any) are the native (platform dependent) data type name corresponding to the (platform independent) DataFlavor (MimeType). If the parameter is null then the Map returned should be the complete map of all mappings between DataFlavors and their corresponding native names known to the implementation at the time of the call. The Map returned is mutable and considered to be owned by the caller, thus allowing "nesting" of FlavorMap implementations.

getFlavorsForNatives

public Map getFlavorsForNatives(String[] natives)

map natives to corresponding flavors

Specified by:

getFlavorsForNatives in interface FlavorMap

Tags copied from interface: FlavorMap

Parameters:

native - The array of String native types to map to DataFlavors, or null

Returns:

a Map object which contains 0 or more entries with keys of type String and values of type DataFlavor, where the DataFlavor values mapped (if any) are the (platform independent) types corresponding to their native (platform dependent) data type names. If the parameter is null then the map returned should be the complete map of all mappings between native names and their corresponding DataFlavors known to the implementation at the time of the call. The Map returned is mutable and considered to be owned by the caller, thus allowing "nesting" of FlavorMap implementations.

encodeJavaMIMEType

public static String encodeJavaMIMEType(String mimeType)

Returns:

encode a Java MIMEType for use as a native type name

encodeDataFlavor

public static String encodeDataFlavor(DataFlavor df)

Returns:

encode a Java MIMEType for use as a native type name

isJavaMIMEType

public static boolean isJavaMIMEType(String atom)

Returns:

if the native type string is an encoded Java MIMEType

decodeJavaMIMEType

public static String decodeJavaMIMEType(String atom)

Returns:

the decoded Java MIMEType string

decodeDataFlavor

public static DataFlavor decodeDataFlavor(String atom)
                                   throws ClassNotFoundException

Returns:

the decoded Java MIMEType as a DataFlavor