A class that implements a mechanism to transfer data using
cut/copy/paste operations.

FlavorListeners may be registered on an instance of the
Clipboard class to be notified about changes to the set of
DataFlavors available on this clipboard (see
addFlavorListener(java.awt.datatransfer.FlavorListener)).

Defines the interface for classes that will provide data to
a clipboard. An instance of this interface becomes the owner
of the contents of a clipboard (clipboard owner) if it is
passed as an argument to
Clipboard.setContents(java.awt.datatransfer.Transferable, java.awt.datatransfer.ClipboardOwner) method of
the clipboard and this method returns successfully.
The instance remains the clipboard owner until another application
or another object within this application asserts ownership
of this clipboard.

A DataFlavor provides meta information about data. DataFlavor
is typically used to access data on the clipboard, or during
a drag and drop operation.

An instance of DataFlavor encapsulates a content type as
defined in RFC 2045
and RFC 2046.
A content type is typically referred to as a MIME type.

A content type consists of a media type (referred
to as the primary type), a subtype, and optional parameters. See
RFC 2045
for details on the syntax of a MIME type.

The JRE data transfer implementation interprets the parameter "class"
of a MIME type as a representation class.
The representation class reflects the class of the object being
transferred. In other words, the representation class is the type of
object returned by Transferable.getTransferData(java.awt.datatransfer.DataFlavor).
For example, the MIME type of imageFlavor is
"image/x-java-image;class=java.awt.Image",
the primary type is image, the subtype is
x-java-image, and the representation class is
java.awt.Image. When getTransferData is invoked
with a DataFlavor of imageFlavor, an instance of
java.awt.Image is returned.
It's important to note that DataFlavor does no error checking
against the representation class. It is up to consumers of
DataFlavor, such as Transferable, to honor the representation
class.

Note, if you do not specify a representation class when
creating a DataFlavor, the default
representation class is used. See appropriate documentation for
DataFlavor's constructors.

Also, DataFlavor instances with the "text" primary
MIME type may have a "charset" parameter. Refer to
RFC 2046 and
selectBestTextFlavor(java.awt.datatransfer.DataFlavor[]) for details on "text" MIME types
and the "charset" parameter.

Equality of DataFlavors is determined by the primary type,
subtype, and representation class. Refer to equals(DataFlavor) for
details. When determining equality, any optional parameters are ignored.
For example, the following produces two DataFlavors that
are considered identical:


  DataFlavor flavor1 = new DataFlavor(Object.class, "X-test/test; class=<java.lang.Object>; foo=bar");
  DataFlavor flavor2 = new DataFlavor(Object.class, "X-test/test; class=<java.lang.Object>; x=y");
  // The following returns true.
  flavor1.equals(flavor2);
As mentioned, flavor1 and flavor2 are considered identical.
As such, asking a Transferable for either DataFlavor returns
the same results.

For more information on the using data transfer with Swing see
the
How to Use Drag and Drop and Data Transfer,
section in Java Tutorial.

FlavorEvent is used to notify interested parties
that available DataFlavors have changed in the
Clipboard (the event source).

Defines an object which listens for FlavorEvents.

A two-way Map between "natives" (Strings), which correspond to platform-
specific data formats, and "flavors" (DataFlavors), which correspond to
platform-independent MIME types. FlavorMaps need not be symmetric, but
typically are.

A FlavorMap which relaxes the traditional 1-to-1 restriction of a Map. A
flavor is permitted to map to any number of natives, and likewise a native
is permitted to map to any number of flavors. FlavorTables need not be
symmetric, but typically are.

A class to encapsulate MimeType parsing related exceptions

A Transferable which implements the capability required
to transfer a String.

This Transferable properly supports
DataFlavor.stringFlavor
and all equivalent flavors. Support for
DataFlavor.plainTextFlavor
and all equivalent flavors is deprecated. No other
DataFlavors are supported.

The SystemFlavorMap is a configurable map between "natives" (Strings), which
correspond to platform-specific data formats, and "flavors" (DataFlavors),
which correspond to platform-independent MIME types. This mapping is used
by the data transfer subsystem to transfer data between Java and native
applications, and between Java applications in separate VMs.

Defines the interface for classes that can be used to provide data
for a transfer operation.

For information on using data transfer with Swing, see

How to Use Drag and Drop and Data Transfer,
a section in The Java Tutorial, for more information.

Signals that the requested data is not supported in this flavor.