All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class java.awt.datatransfer.DataFlavor

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

public class DataFlavor

extends Object

plainTextFlavor

The DataFlavor representing plain text with unicode encoding, where:

representationClass = InputStream
mimeType = "text/plain; charset=unicode"

stringFlavor

The DataFlavor representing a Java Unicode String class, where:

representationClass = java.lang.String
mimeType = "application/x-javaserializedobject"

DataFlavor(Class, String)

Construct a DataFlavor that represents a Java class

The returned DataFlavor will have the following characteristics

representationClass = representationClass
mimeType = application/x-javaserializedobject

DataFlavor(String, String)

Construct a DataFlavor that represents a MimeType

The returned DataFlavor will have the following characteristics:

If the mimeType is "application/x-javaserializedobject; class=", the result is the same as calling new DataFlavor(Class:forName() as above

otherwise:

representationClass = InputStream
mimeType = mimeType

equals(DataFlavor)

getHumanPresentableName()

Returns the human presentable name for the data foramt that this DataFlavor represents.

getMimeType()

Returns the MIME type string for this DataFlavor

getRepresentationClass()

Returns the Class which objects supporting this DataFlavor will return when this DataFlavor is requested.

isMimeTypeEqual(DataFlavor)

Convenience function equivalent to calling: isMimeTypeEqual(dataFlavor.getMimeType());

isMimeTypeEqual(String)

Is the string representation of the MIME type passed in equivalent to the MIME type of this DataFlavor.

normalizeMimeType(String)

Called for each MIME type string to give DataFlavor subtypes the opportunity to change how the normalization of MIME types is accomplished.

normalizeMimeTypeParameter(String, String)

Called on DataFlavor for every MIME Type parameter to allow DataFlavor subclasses to handle special parameters like the text/plain charset parameters, whose values are case insensitive.

setHumanPresentableName(String)

Sets the human presentable name for the data format that this DataFlavor represents.

Properties Public Static 
    stringFlavor=DataFlavor 

The DataFlavor representing a Java Unicode String class, where:

representationClass = java.lang.String
mimeType = "application/x-javaserializedobject"

Properties Public Static 
    plainTextFlavor=DataFlavor 

The DataFlavor representing plain text with unicode encoding, where:

representationClass = InputStream
mimeType = "text/plain; charset=unicode"

    method DataFlavor(representationClass=Class, -
                      humanPresentableName=String) public 

Construct a DataFlavor that represents a Java class

The returned DataFlavor will have the following characteristics

representationClass = representationClass
mimeType = application/x-javaserializedobject

Parameters:

representationClass - the class used to transfer data in this flavor

humanPresentableName - the human-readible string used to identify this flavor

    method DataFlavor(mimeType=String, -
                      humanPresentableName=String) public 

Construct a DataFlavor that represents a MimeType

The returned DataFlavor will have the following characteristics:

If the mimeType is "application/x-javaserializedobject; class=", the result is the same as calling new DataFlavor(Class:forName() as above

otherwise:

representationClass = InputStream
mimeType = mimeType

Parameters:

mimeType - the string used to identify the MIME type for this flavor

humanPresentableName - the human-readible string used to identify this flavor

    method getMimeType() returns String public     

Returns the MIME type string for this DataFlavor

    method getRepresentationClass() returns Class public     

Returns the Class which objects supporting this DataFlavor will return when this DataFlavor is requested.

    method getHumanPresentableName() returns String public     

Returns the human presentable name for the data foramt that this DataFlavor represents. This name would be localized for different countries

    method setHumanPresentableName(humanPresentableName=String)  public     

Sets the human presentable name for the data format that this DataFlavor represents. This name would be localized for different countries

    method equals(dataFlavor=DataFlavor) returns boolean public     

    method isMimeTypeEqual(mimeType=String) returns boolean public     

Is the string representation of the MIME type passed in equivalent to the MIME type of this DataFlavor. This may involve adding default attributes for some MIME types (like adding charset=US-ASCII to text/plain MIME types that have no charset parameter specified)

    method isMimeTypeEqual(dataFlavor=DataFlavor) returns boolean public   final  

Convenience function equivalent to calling: isMimeTypeEqual(dataFlavor.getMimeType());

    method normalizeMimeTypeParameter(parameterName=String, -
                                      parameterValue=String) returns String Inheritable     

Called on DataFlavor for every MIME Type parameter to allow DataFlavor subclasses to handle special parameters like the text/plain charset parameters, whose values are case insensitive. (MIME type parameter values are supposed to be case sensitive.

This method is called for each parameter name/value pair and should return the normalized representation of the parameterValue

    method normalizeMimeType(mimeType=String) returns String Inheritable     

Called for each MIME type string to give DataFlavor subtypes the opportunity to change how the normalization of MIME types is accomplished. One possible use would be to add default parameter/value pairs in cases where none are present in the MIME type string passed in

All Packages  Class Hierarchy  This Package  Previous  Next  Index