JavaTM 2 Platform
Std. Ed. v1.3.1

java.awt.datatransfer
Class SystemFlavorMap

java.lang.Object
  |
  +--java.awt.datatransfer.SystemFlavorMap
All Implemented Interfaces:
FlavorMap

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:
1.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
Following copied from interface: java.awt.datatransfer.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
Following copied from interface: java.awt.datatransfer.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

JavaTM 2 Platform
Std. Ed. v1.3.1

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Java, Java 2D, and JDBC are trademarks or registered trademarks of Oracle and/or its affiliates, in the US and other countries.
Copyright © 1995, 2010 Oracle and/or its affiliates. All rights reserved.