public class

ActivationDataFlavor

extends DataFlavor
java.lang.Object
   ↳ java.awt.datatransfer.DataFlavor
     ↳ com.google.code.javax.activation.ActivationDataFlavor

Class Overview

The ActivationDataFlavor class is a special subclass of java.awt.datatransfer.DataFlavor. It allows the JAF to set all three values stored by the DataFlavor class via a new constructor. It also contains improved MIME parsing in the equals method. Except for the improved parsing, its semantics are identical to that of the JDK's DataFlavor class.

Summary

[Expand]
Inherited Constants
From class java.awt.datatransfer.DataFlavor
Fields
private String humanPresentableName
private MimeType mimeObject
private String mimeType
private Class representationClass
[Expand]
Inherited Fields
From class java.awt.datatransfer.DataFlavor
Public Constructors
ActivationDataFlavor(Class representationClass, String mimeType, String humanPresentableName)
Construct a DataFlavor that represents an arbitrary Java object.
ActivationDataFlavor(Class representationClass, String humanPresentableName)
Construct a DataFlavor that represents a MimeType.
ActivationDataFlavor(String mimeType, String humanPresentableName)
Construct a DataFlavor that represents a MimeType.
Public Methods
boolean equals(DataFlavor dataFlavor)
Compares the DataFlavor passed in with this DataFlavor; calls the isMimeTypeEqual method.
String getHumanPresentableName()
Return the Human Presentable name.
String getMimeType()
Return the MIME type for this DataFlavor.
Class getRepresentationClass()
Return the representation class.
boolean isMimeTypeEqual(String mimeType)
Is the string representation of the MIME type passed in equivalent to the MIME type of this DataFlavor.
void setHumanPresentableName(String humanPresentableName)
Set the human presentable name.
Protected Methods
String normalizeMimeType(String mimeType)
This method is deprecated. No replacement.
String normalizeMimeTypeParameter(String parameterName, String parameterValue)
This method is deprecated. No replacement.
[Expand]
Inherited Methods
From class java.awt.datatransfer.DataFlavor
From class java.lang.Object
From interface java.io.Externalizable

Fields

private String humanPresentableName

private MimeType mimeObject

private String mimeType

private Class representationClass

Public Constructors

public ActivationDataFlavor (Class representationClass, String mimeType, String humanPresentableName)

Construct a DataFlavor that represents an arbitrary Java object. This constructor is an extension of the JDK's DataFlavor in that it allows the explicit setting of all three DataFlavor attributes.

The returned DataFlavor will have the following characteristics:

representationClass = representationClass
mimeType = mimeType
humanName = humanName

Parameters
representationClass The class used in this DataFlavor
mimeType The MIME type of the data represented by this class
humanPresentableName The human presentable name of the flavor

public ActivationDataFlavor (Class representationClass, String humanPresentableName)

Construct a DataFlavor that represents a MimeType.

The returned DataFlavor will have the following characteristics:

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

otherwise:

representationClass = InputStream

mimeType = mimeType

Parameters
representationClass The class used in this DataFlavor
humanPresentableName The human presentable name of the flavor

public ActivationDataFlavor (String mimeType, String humanPresentableName)

Construct a DataFlavor that represents a MimeType.

The returned DataFlavor will have the following characteristics:

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

representationClass = InputStream

mimeType = mimeType

Parameters
mimeType The MIME type of the data represented by this class
humanPresentableName The human presentable name of the flavor

Public Methods

public boolean equals (DataFlavor dataFlavor)

Compares the DataFlavor passed in with this DataFlavor; calls the isMimeTypeEqual method.

Parameters
dataFlavor The DataFlavor to compare with
Returns
  • true if the MIME type and representation class are the same

public String getHumanPresentableName ()

Return the Human Presentable name.

Returns
  • the human presentable name

public String getMimeType ()

Return the MIME type for this DataFlavor.

Returns
  • the MIME type

public Class getRepresentationClass ()

Return the representation class.

Returns
  • the representation class

public boolean isMimeTypeEqual (String mimeType)

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

ActivationDataFlavor delegates the comparison of MIME types to the MimeType class included as part of the JavaBeans Activation Framework. This provides a more robust comparison than is normally available in the DataFlavor class.

Parameters
mimeType The MIME type
Returns
  • true if the same MIME type

public void setHumanPresentableName (String humanPresentableName)

Set the human presentable name.

Parameters
humanPresentableName The name to set

Protected Methods

protected String normalizeMimeType (String mimeType)

This method is deprecated.
No replacement.

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. This method is never invoked by this implementation.

Parameters
mimeType The MIME type
Returns
  • the normalized MIME type

protected String normalizeMimeTypeParameter (String parameterName, String parameterValue)

This method is deprecated.
No replacement.

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. This method is never invoked by this implementation.

Parameters
parameterName The parameter name
parameterValue The parameter value
Returns
  • the normalized parameter value