Class DataFlavor

Method Details

• tryToLoadClass

  protected static final Class<?> tryToLoadClass(String className, ClassLoader fallback) throws ClassNotFoundException

  Tries to load a class from: the bootstrap loader, the system loader, the context loader (if one is present) and finally the loader specified.

  Parameters:

  className - the name of the class to be loaded

  fallback - the fallback loader

  Returns:

  the class loaded

  Throws:

  ClassNotFoundException - if class is not found

• toString

  public String toString()

  String representation of this DataFlavor and its parameters. The resulting String contains the name of the DataFlavor class, this flavor's MIME type, and its representation class. If this flavor has a primary MIME type of "text", supports the charset parameter, and has an encoded representation, the flavor's charset is also included. See selectBestTextFlavor for a list of text flavors which support the charset parameter.

  Overrides:

  toString in class Object

  Returns:

  string representation of this DataFlavor

  See Also:

  • selectBestTextFlavor(java.awt.datatransfer.DataFlavor[])

• getTextPlainUnicodeFlavor

  public static final DataFlavor getTextPlainUnicodeFlavor()

  Returns a DataFlavor representing plain text with Unicode encoding, where:

       representationClass = java.io.InputStream
       mimeType            = "text/plain;
                              charset=<platform default Unicode encoding>"
   

  Implementation Note:

  Oracle's implementation for Microsoft Windows and macOS uses the encoding utf-16le. Oracle's implementation for Solaris and Linux uses the encoding iso-10646-ucs-2.

  Returns:

  a DataFlavor representing plain text with Unicode encoding

  Since:

  1.3

• selectBestTextFlavor

  public static final DataFlavor selectBestTextFlavor(DataFlavor[] availableFlavors)

  Selects the best text DataFlavor from an array of DataFlavors. Only DataFlavor.stringFlavor, and equivalent flavors, and flavors that have a primary MIME type of "text", are considered for selection.

  Flavors are first sorted by their MIME types in the following order:

  • "text/sgml"
  • "text/xml"
  • "text/html"
  • "text/rtf"
  • "text/enriched"
  • "text/richtext"
  • "text/uri-list"
  • "text/tab-separated-values"
  • "text/t140"
  • "text/rfc822-headers"
  • "text/parityfec"
  • "text/directory"
  • "text/css"
  • "text/calendar"
  • "application/x-java-serialized-object"
  • "text/plain"
  • "text/<other>"

  For example, "text/sgml" will be selected over "text/html", and DataFlavor.stringFlavor will be chosen over DataFlavor.plainTextFlavor.

  If two or more flavors share the best MIME type in the array, then that MIME type will be checked to see if it supports the charset parameter.

  The following MIME types support, or are treated as though they support, the charset parameter:

  • "text/sgml"
  • "text/xml"
  • "text/html"
  • "text/enriched"
  • "text/richtext"
  • "text/uri-list"
  • "text/directory"
  • "text/css"
  • "text/calendar"
  • "application/x-java-serialized-object"
  • "text/plain"

  The following MIME types do not support, or are treated as though they do not support, the charset parameter:

  • "text/rtf"
  • "text/tab-separated-values"
  • "text/t140"
  • "text/rfc822-headers"
  • "text/parityfec"

  For "text/<other>" MIME types, the first time the JRE needs to determine whether the MIME type supports the charset parameter, it will check whether the parameter is explicitly listed in an arbitrarily chosen DataFlavor which uses that MIME type. If so, the JRE will assume from that point on that the MIME type supports the charset parameter and will not check again. If the parameter is not explicitly listed, the JRE will assume from that point on that the MIME type does not support the charset parameter and will not check again. Because this check is performed on an arbitrarily chosen DataFlavor, developers must ensure that all DataFlavors with a "text/<other>" MIME type specify the charset parameter if it is supported by that MIME type. Developers should never rely on the JRE to substitute the platform's default charset for a "text/<other>" DataFlavor. Failure to adhere to this restriction will lead to undefined behavior.

  If the best MIME type in the array does not support the charset parameter, the flavors which share that MIME type will then be sorted by their representation classes in the following order: java.io.InputStream, java.nio.ByteBuffer, [B, <all others>.

  If two or more flavors share the best representation class, or if no flavor has one of the three specified representations, then one of those flavors will be chosen non-deterministically.

  If the best MIME type in the array does support the charset parameter, the flavors which share that MIME type will then be sorted by their representation classes in the following order: java.io.Reader, java.lang.String, java.nio.CharBuffer, [C, <all others>.

  If two or more flavors share the best representation class, and that representation is one of the four explicitly listed, then one of those flavors will be chosen non-deterministically. If, however, no flavor has one of the four specified representations, the flavors will then be sorted by their charsets. Unicode charsets, such as "UTF-16", "UTF-8", "UTF-16BE", "UTF-16LE", and their aliases, are considered best. After them, the platform default charset and its aliases are selected. "US-ASCII" and its aliases are worst. All other charsets are chosen in alphabetical order, but only charsets supported by this implementation of the Java platform will be considered.

  If two or more flavors share the best charset, the flavors will then again be sorted by their representation classes in the following order: java.io.InputStream, java.nio.ByteBuffer, [B, <all others>.

  If two or more flavors share the best representation class, or if no flavor has one of the three specified representations, then one of those flavors will be chosen non-deterministically.

  Parameters:

  availableFlavors - an array of available DataFlavors

  Returns:

  the best (highest fidelity) flavor according to the rules specified above, or null, if availableFlavors is null, has zero length, or contains no text flavors

  Since:

  1.3

• getReaderForText

  public Reader getReaderForText(Transferable transferable) throws UnsupportedFlavorException, IOException

  Gets a Reader for a text flavor, decoded, if necessary, for the expected charset (encoding). The supported representation classes are java.io.Reader, java.lang.String, java.nio.CharBuffer, [C, java.io.InputStream, java.nio.ByteBuffer, and [B.

  Because text flavors which do not support the charset parameter are encoded in a non-standard format, this method should not be called for such flavors. However, in order to maintain backward-compatibility, if this method is called for such a flavor, this method will treat the flavor as though it supports the charset parameter and attempt to decode it accordingly. See selectBestTextFlavor for a list of text flavors which do not support the charset parameter.

  Parameters:

  transferable - the Transferable whose data will be requested in this flavor

  Returns:

  a Reader to read the Transferable's data

  Throws:

  IllegalArgumentException - if the representation class is not one of the seven listed above

  IllegalArgumentException - if the Transferable has null data

  NullPointerException - if the Transferable is null

  UnsupportedEncodingException - if this flavor's representation is java.io.InputStream, java.nio.ByteBuffer, or [B and this flavor's encoding is not supported by this implementation of the Java platform

  UnsupportedFlavorException - if the Transferable does not support this flavor

  IOException - if the data cannot be read because of an I/O error

  Since:

  1.3

  See Also:

  • selectBestTextFlavor(java.awt.datatransfer.DataFlavor[])

• getMimeType

  public String getMimeType()

  Returns the MIME type string for this DataFlavor.

  Returns:

  the MIME type string for this flavor

• getRepresentationClass

  public Class<?> getRepresentationClass()

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

  Returns:

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

• getHumanPresentableName

  public String getHumanPresentableName()

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

  Returns:

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

• getPrimaryType

  public String getPrimaryType()

  Returns the primary MIME type for this DataFlavor.

  Returns:

  the primary MIME type of this DataFlavor

• getSubType

  public String getSubType()

  Returns the sub MIME type of this DataFlavor.

  Returns:

  the Sub MIME type of this DataFlavor

• getParameter

  public String getParameter(String paramName)

  Returns the human presentable name for this DataFlavor if paramName equals "humanPresentableName". Otherwise returns the MIME type value associated with paramName.

  Parameters:

  paramName - the parameter name requested

  Returns:

  the value of the name parameter, or null if there is no associated value

• setHumanPresentableName

  public void setHumanPresentableName(String humanPresentableName)

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

  Parameters:

  humanPresentableName - the new human presentable name

• equals

  public boolean equals(Object o)

  Indicates whether some other object is "equal to" this one.

  The equals method implements an equivalence relation on non-null object references:

  • It is reflexive: for any non-null reference value x, x.equals(x) should return true.
  • It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
  • It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
  • It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
  • For any non-null reference value x, x.equals(null) should return false.

  An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes.

  The equals comparison for the DataFlavor class is implemented as follows: Two DataFlavors are considered equal if and only if their MIME primary type and subtype and representation class are equal. Additionally, if the primary type is "text", the subtype denotes a text flavor which supports the charset parameter, and the representation class is not java.io.Reader, java.lang.String, java.nio.CharBuffer, or [C, the charset parameter must also be equal. If a charset is not explicitly specified for one or both DataFlavors, the platform default encoding is assumed. See selectBestTextFlavor for a list of text flavors which support the charset parameter.

  Overrides:

  equals in class Object

  Parameters:

  o - the Object to compare with this

  Returns:

  true if that is equivalent to this DataFlavor; false otherwise

  See Also:

  • selectBestTextFlavor(java.awt.datatransfer.DataFlavor[])

• equals

  public boolean equals(DataFlavor that)

  This method has the same behavior as equals(Object). The only difference being that it takes a DataFlavor instance as a parameter.

  Parameters:

  that - the DataFlavor to compare with this

  Returns:

  true if that is equivalent to this DataFlavor; false otherwise

  See Also:

  • selectBestTextFlavor(java.awt.datatransfer.DataFlavor[])

• equals

  @Deprecated public boolean equals(String s)

  Deprecated.

  As inconsistent with hashCode() contract, use isMimeTypeEqual(String) instead.

  Compares only the mimeType against the passed in String and representationClass is not considered in the comparison. If representationClass needs to be compared, then equals(new DataFlavor(s)) may be used.

  Parameters:

  s - the mimeType to compare

  Returns:

  true if the String (MimeType) is equal; false otherwise or if s is null

• hashCode

  public int hashCode()

  Returns hash code for this DataFlavor. For two equal DataFlavors, hash codes are equal. For the String that matches DataFlavor.equals(String), it is not guaranteed that DataFlavor's hash code is equal to the hash code of the String.

  Overrides:

  hashCode in class Object

  Returns:

  a hash code for this DataFlavor

  See Also:

  • Object.equals(java.lang.Object)
  • System.identityHashCode(java.lang.Object)

• match

  public boolean match(DataFlavor that)

  Identical to equals(DataFlavor).

  Parameters:

  that - the DataFlavor to compare with this

  Returns:

  true if that is equivalent to this DataFlavor; false otherwise

  Since:

  1.3

  See Also:

  • selectBestTextFlavor(java.awt.datatransfer.DataFlavor[])

• isMimeTypeEqual

  public boolean isMimeTypeEqual(String mimeType)

  Returns whether the string representation of the MIME type passed in is equivalent to the MIME type of this DataFlavor. Parameters are not included in the comparison.

  Parameters:

  mimeType - the string representation of the MIME type

  Returns:

  true if the string representation of the MIME type passed in is equivalent to the MIME type of this DataFlavor; false otherwise

  Throws:

  NullPointerException - if mimeType is null

• isMimeTypeEqual

  public final boolean isMimeTypeEqual(DataFlavor dataFlavor)

  Compares the mimeType of two DataFlavor objects. No parameters are considered.

  Parameters:

  dataFlavor - the DataFlavor to be compared

  Returns:

  true if the MimeTypes are equal, otherwise false

• isMimeTypeSerializedObject

  public boolean isMimeTypeSerializedObject()

  Does the DataFlavor represent a serialized object?

  Returns:

  whether or not a serialized object is represented

• getDefaultRepresentationClass

  public final Class<?> getDefaultRepresentationClass()

  Returns the default representation class.

  Returns:

  the default representation class

• getDefaultRepresentationClassAsString

  public final String getDefaultRepresentationClassAsString()

  Returns the name of the default representation class.

  Returns:

  the name of the default representation class

• isRepresentationClassInputStream

  public boolean isRepresentationClassInputStream()

  Does the DataFlavor represent a java.io.InputStream?

  Returns:

  whether or not this DataFlavor represent a java.io.InputStream

• isRepresentationClassReader

  public boolean isRepresentationClassReader()

  Returns whether the representation class for this DataFlavor is java.io.Reader or a subclass thereof.

  Returns:

  whether or not the representation class for this DataFlavor is java.io.Reader or a subclass thereof

  Since:

  1.4

• isRepresentationClassCharBuffer

  public boolean isRepresentationClassCharBuffer()

  Returns whether the representation class for this DataFlavor is java.nio.CharBuffer or a subclass thereof.

  Returns:

  whether or not the representation class for this DataFlavor is java.nio.CharBuffer or a subclass thereof

  Since:

  1.4

• isRepresentationClassByteBuffer

  public boolean isRepresentationClassByteBuffer()

  Returns whether the representation class for this DataFlavor is java.nio.ByteBuffer or a subclass thereof.

  Returns:

  whether or not the representation class for this DataFlavor is java.nio.ByteBuffer or a subclass thereof

  Since:

  1.4

• isRepresentationClassSerializable

  public boolean isRepresentationClassSerializable()

  Returns true if the representation class can be serialized.

  Returns:

  true if the representation class can be serialized

• isRepresentationClassRemote

  public boolean isRepresentationClassRemote()

  Returns true if the representation class is Remote.

  Returns:

  true if the representation class is Remote

• isFlavorSerializedObjectType

  public boolean isFlavorSerializedObjectType()

  Returns true if the DataFlavor specified represents a serialized object.

  Returns:

  true if the DataFlavor specified represents a Serialized Object

• isFlavorRemoteObjectType

  public boolean isFlavorRemoteObjectType()

  Returns true if the DataFlavor specified represents a remote object.

  Returns:

  true if the DataFlavor specified represents a Remote Object

• isFlavorJavaFileListType

  public boolean isFlavorJavaFileListType()

  Returns true if the DataFlavor specified represents a list of file objects.

  Returns:

  true if the DataFlavor specified represents a java.util.List of java.io.File objects

• isFlavorTextType

  public boolean isFlavorTextType()

  Returns whether this DataFlavor is a valid text flavor for this implementation of the Java platform. Only flavors equivalent to DataFlavor.stringFlavor and DataFlavors with a primary MIME type of "text" can be valid text flavors.

  If this flavor supports the charset parameter, it must be equivalent to DataFlavor.stringFlavor, or its representation must be java.io.Reader, java.lang.String, java.nio.CharBuffer, [C, java.io.InputStream, java.nio.ByteBuffer, or [B. If the representation is java.io.InputStream, java.nio.ByteBuffer, or [B, then this flavor's charset parameter must be supported by this implementation of the Java platform. If a charset is not specified, then the platform default charset, which is always supported, is assumed.

  If this flavor does not support the charset parameter, its representation must be java.io.InputStream, java.nio.ByteBuffer, or [B.

  See selectBestTextFlavor for a list of text flavors which support the charset parameter.

  Returns:

  true if this DataFlavor is a valid text flavor as described above; false otherwise

  Since:

  1.4

  See Also:

  • selectBestTextFlavor(java.awt.datatransfer.DataFlavor[])

• writeExternal

  public void writeExternal(ObjectOutput os) throws IOException

  Serializes this DataFlavor.

  Specified by:

  writeExternal in interface Externalizable

  Parameters:

  os - the stream to write the object to

  Throws:

  IOException - Includes any I/O exceptions that may occur

• readExternal

  public void readExternal(ObjectInput is) throws IOException, ClassNotFoundException

  Restores this DataFlavor from a Serialized state.

  Specified by:

  readExternal in interface Externalizable

  Parameters:

  is - the stream to read data from in order to restore the object

  Throws:

  IOException - if I/O errors occur

  ClassNotFoundException - If the class for an object being restored cannot be found.

• clone

  public Object clone() throws CloneNotSupportedException

  Returns a clone of this DataFlavor.

  Overrides:

  clone in class Object

  Returns:

  a clone of this DataFlavor

  Throws:

  CloneNotSupportedException - if the object's class does not support the Cloneable interface. Subclasses that override the clone method can also throw this exception to indicate that an instance cannot be cloned.

  See Also:

  • Cloneable

• normalizeMimeTypeParameter

  @Deprecated protected String normalizeMimeTypeParameter(String parameterName, String parameterValue)

  Deprecated.

  This method is never invoked by this implementation from 1.1 onwards

  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.

  Parameters:

  parameterName - the parameter name

  parameterValue - the parameter value

  Returns:

  the parameter value

• normalizeMimeType

  @Deprecated protected String normalizeMimeType(String mimeType)

  Deprecated.

  This method is never invoked by this implementation from 1.1 onwards

  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.

  Parameters:

  mimeType - the mime type

  Returns:

  the mime type