java.awt.datatransfer

Класс DataFlavor

java.lang. Объект

java.awt.datatransfer. DataFlavor

Все Реализованные Интерфейсы:

Externalizable, Сериализуемый, Cloneable

Прямые Известные Подклассы:

ActivationDataFlavor

public class DataFlavor
extends Object
implements Externalizable, Cloneable

A DataFlavor обеспечивает метаинформацию о данных. DataFlavor обычно привык к данным доступа на буфере обмена, или во время работы перетаскивания и отбрасывания.

Экземпляр DataFlavor инкапсулирует тип контента как определено в RFC 2045 и RFC 2046. Тип контента обычно упоминается как тип MIME.

Тип контента состоит из типа носителя (называемый основным типом), подтип, и дополнительные параметры. См. RFC 2045 для деталей о синтаксисе типа MIME.

Реализация передачи данных JRE интерпретирует параметр "класс" типа MIME как класс представления. Класс представления отражает класс передаваемого объекта. Другими словами класс представления является типом объекта, возвращенного Transferable.getTransferData(java.awt.datatransfer.DataFlavor). Например, тип MIME imageFlavor "image/x-java-image;class=java.awt.Image", основной тип image, подтип x-java-image, и класс представления java.awt.Image. Когда getTransferData вызывается с a DataFlavor из imageFlavor, экземпляр java.awt.Image возвращается. Важно отметить это DataFlavor не делает никакой проверки на ошибки против класса представления. Это до потребителей DataFlavor, такой как Transferable, соблюдать класс представления.
Отметьте, если Вы не определяете класс представления, создавая a DataFlavor, класс представления по умолчанию используется. См. соответствующую документацию для DataFlavor's конструкторы.

Кроме того, DataFlavor у экземпляров с "текстом" основной тип MIME может быть параметр "набора символов". Обратитесь к RFC 2046 и selectBestTextFlavor(java.awt.datatransfer.DataFlavor[]) для деталей о "текстовых" типах MIME и параметре "набора символов".

Равенство DataFlavors определяется основным типом, подтипом, и классом представления. Обратитесь к equals(DataFlavor) для деталей. Определяя равенство, любые дополнительные параметры игнорируются. Например, следующее производит два DataFlavors это считают идентичным:

   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);
 

Как упомянуто, flavor1 и flavor2 считаются идентичными. Также, выяснение a Transferable для также DataFlavor возвращает те же самые результаты.

Для получения дополнительной информации по передаче данных использования с Swing видят, Как Использовать, Перетаскивают и Отбрасывание и Передача данных, раздел в Учебном руководстве по Java.

См. Также:

Сериализированная Форма

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static DataFlavor	imageFlavor DataFlavor представление класса Изображения Java, где:
static DataFlavor	javaFileListFlavor Передать список файлов к/от Java (и базовая платформа) a DataFlavor из этого типа/подтипа и класса представления java.util.List используется.
static String	javaJVMLocalObjectMimeType Передать ссылку на произвольную ссылку на объект Java, у которой нет никакого связанного Типа контента MIME через a Transferable интерфейс В ПРЕДЕЛАХ ТОЙ ЖЕ САМОЙ JVM, a DataFlavor с этим типом/подтипом используется, с a representationClass равный типу класса/интерфейса, передаваемого через Transferable.
static String	javaRemoteObjectMimeType Чтобы передать живую ссылку к Удаленному объекту через Перетаскивание и Отбрасывание ACTION_LINK работа Тип контента Пантомимы application/x-java-remote-object должна использоваться, где класс представления DataFlavor представляет тип Remote интерфейс, который будет передан.
static String	javaSerializedObjectMimeType Тип контента MIME application/x-java-serialized-object представляет график объекта (ов) Java, которые были сделаны персистентными.
static DataFlavor	plainTextFlavor Осуждаемый. с 1.3. Использовать DataFlavor.getReaderForText(Transferable) вместо Transferable.getTransferData(DataFlavor.plainTextFlavor).
static DataFlavor	stringFlavor DataFlavor представление Строкового класса Unicode Java, где:

Сводка конструктора

Конструкторы

Конструктор и Описание
DataFlavor() Создает новое DataFlavor.
DataFlavor(Class<?> representationClass, String humanPresentableName) Конструкции a DataFlavor это представляет класс Java.
DataFlavor(String mimeType) Конструкции a DataFlavor от a mimeType строка.
DataFlavor(String mimeType, String humanPresentableName) Конструкции a DataFlavor это представляет a MimeType.
DataFlavor(String mimeType, String humanPresentableName, ClassLoader classLoader) Конструкции a DataFlavor это представляет a MimeType.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
Объект	clone() Возвращает клона этого DataFlavor.
boolean	equals(DataFlavor that) У этого метода есть то же самое поведение как equals(Object).
boolean	equals(Object o) Указывает, " ли некоторый другой объект равен" этому.
boolean	equals(String s) Осуждаемый. Как непоследовательный с hashCode() контракт, использовать isMimeTypeEqual(String) вместо этого.
Class<?>	getDefaultRepresentationClass()
Строка	getDefaultRepresentationClassAsString()
Строка	getHumanPresentableName() Возвращает человеческое презентабельное имя для формата данных что это DataFlavor представляет.
Строка	getMimeType() Возвращает строку типа MIME для этого DataFlavor.
Строка	getParameter(String paramName) Возвращает человеческое презентабельное имя для этого DataFlavor если paramName равняется "humanPresentableName".
Строка	getPrimaryType() Возвращает основной тип MIME для этого DataFlavor.
Читатель	getReaderForText(Transferable transferable) Получает Читателя для текстовой разновидности, декодируемой, в случае необходимости, для ожидаемого набора символов (кодирование).
Class<?>	getRepresentationClass() Возвраты Class который возражает поддержке этого DataFlavor возвратится когда это DataFlavor требуется.
Строка	getSubType() Возвращает sub тип MIME этого DataFlavor.
static DataFlavor	getTextPlainUnicodeFlavor() Возвраты a DataFlavor представление простого текста с кодированием Unicode, где:
int	hashCode() Хэш-код возвратов для этого DataFlavor.
boolean	isFlavorJavaFileListType() Возвращает true если DataFlavor определенный представляет список объектов файла.
boolean	isFlavorRemoteObjectType() Возвращает true если DataFlavor определенный представляет удаленный объект.
boolean	isFlavorSerializedObjectType() Возвращает true если DataFlavor определенный представляет сериализированный объект.
boolean	isFlavorTextType() Возвраты, ли это DataFlavor допустимая текстовая разновидность для этой реализации платформы Java.
boolean	isMimeTypeEqual(DataFlavor dataFlavor) Сравнивается mimeType из два DataFlavor объекты.
boolean	isMimeTypeEqual(String mimeType) Возвраты, эквивалентно ли строковое представление типа MIME, который передают в, типу MIME этого DataFlavor.
boolean	isMimeTypeSerializedObject() Делает DataFlavor представьте сериализированный объект?
boolean	isRepresentationClassByteBuffer() Возвраты, ли класс представления для этого DataFlavor java.nio.ByteBuffer или подкласс этого.
boolean	isRepresentationClassCharBuffer() Возвраты, ли класс представления для этого DataFlavor java.nio.CharBuffer или подкласс этого.
boolean	isRepresentationClassInputStream() Делает DataFlavor представьте a java.io.InputStream?
boolean	isRepresentationClassReader() Возвраты, ли класс представления для этого DataFlavor java.io.Reader или подкласс этого.
boolean	isRepresentationClassRemote() Возвращает true, если класс представления Remote.
boolean	isRepresentationClassSerializable() Возвращает true, если класс представления может быть сериализирован.
boolean	match(DataFlavor that) Идентичный equals(DataFlavor).
protected String	normalizeMimeType(String mimeType) Осуждаемый.
protected String	normalizeMimeTypeParameter(String parameterName, String parameterValue) Осуждаемый.
void	readExternal(ObjectInput is) Восстановления это DataFlavor от Сериализированного состояния.
static DataFlavor	selectBestTextFlavor(DataFlavor[] availableFlavors) Выбирает лучший текст DataFlavor от массива DataFlavors.
void	setHumanPresentableName(String humanPresentableName) Определяет человеческое презентабельное имя для формата данных что это DataFlavor представляет.
Строка	toString() Строковое представление этого DataFlavor и его параметры.
protected static Class<?>	tryToLoadClass(String className, ClassLoader fallback) Попытки загрузить класс из: программа начальной загрузки, системный загрузчик, загрузчик контекста (если Вы присутствуете), и наконец определенный загрузчик.
void	writeExternal(ObjectOutput os) Сериализирует это DataFlavor.

Методы java.lang унаследованный от класса. Объект

finalize, getClass, notify, notifyAll, wait, wait, wait

Полевая Деталь

stringFlavor

public static final DataFlavor stringFlavor

DataFlavor представление Строкового класса Unicode Java, где:

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

imageFlavor

public static final DataFlavor imageFlavor

DataFlavor представление класса Изображения Java, где:

     representationClass = java.awt.Image
     mimeType            = "image/x-java-image"
 

plainTextFlavor

@Deprecated
public static final DataFlavor plainTextFlavor

Осуждаемый. с 1.3. Использовать DataFlavor.getReaderForText(Transferable) вместо Transferable.getTransferData(DataFlavor.plainTextFlavor).

DataFlavor представление простого текста с кодированием Unicode, где:

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

Это DataFlavor был осужден, потому что (1) Его представлением является InputStream, 8-разрядное основанное представление, в то время как Unicode является 16-разрядным набором символов; и (2) набор символов "unicode" не четко определен. "unicode" подразумевает реализацию определенной платформы Unicode, не межплатформенную реализацию.

javaSerializedObjectMimeType

public static final String javaSerializedObjectMimeType

Тип контента MIME application/x-java-serialized-object представляет график объекта (ов) Java, которые были сделаны персистентными. Класс представления связался с этим DataFlavor идентифицирует тип Java объекта, возвращенного как ссылка из вызова java.awt.datatransfer.getTransferData.

См. Также:

Постоянные Значения полей

javaFileListFlavor

public static final DataFlavor javaFileListFlavor

Передать список файлов к/от Java (и базовая платформа) a DataFlavor из этого типа/подтипа и класса представления java.util.List используется. Каждый элемент списка требуется/гарантируется, чтобы иметь тип java.io.File.

javaJVMLocalObjectMimeType

public static final String javaJVMLocalObjectMimeType

Передать ссылку на произвольную ссылку на объект Java, у которой нет никакого связанного Типа контента MIME через a Transferable интерфейс В ПРЕДЕЛАХ ТОЙ ЖЕ САМОЙ JVM, a DataFlavor с этим типом/подтипом используется, с a representationClass равный типу класса/интерфейса, передаваемого через Transferable.

Ссылка на объект, возвращенная из Transferable.getTransferData для a DataFlavor с этим MIME Тип контента обязан быть экземпляром Класса представления DataFlavor.

См. Также:

Постоянные Значения полей

javaRemoteObjectMimeType

public static final String javaRemoteObjectMimeType

Чтобы передать живую ссылку к Удаленному объекту через Перетаскивание и Отбрасывание ACTION_LINK работа Тип контента Пантомимы application/x-java-remote-object должна использоваться, где класс представления DataFlavor представляет тип Remote интерфейс, который будет передан.

См. Также:

Постоянные Значения полей

Деталь конструктора

DataFlavor

public DataFlavor()

Создает новое DataFlavor. Этому конструктору предоставляют только с целью поддержки Externalizable интерфейс. Это не предназначается для общественности (клиент) использование.

С тех пор:

1.2

DataFlavor

public DataFlavor(Class<?> representationClass,
          String humanPresentableName)

Конструкции a DataFlavor это представляет класс Java.

Возвращенный DataFlavor будет иметь следующие характеристики:

    representationClass = representationClass
    mimeType            = application/x-java-serialized-object
 

Параметры:

representationClass - класс, используемый, чтобы передать данные в этой разновидности

humanPresentableName - удобочитаемая строка, используемая, чтобы идентифицировать эту разновидность; если этот параметр null тогда значение Тип контента MIME используется

Броски:

NullPointerException - если representationClass нуль

DataFlavor

public DataFlavor(String mimeType,
          String humanPresentableName)

Конструкции a DataFlavor это представляет a MimeType.

Возвращенный DataFlavor будет иметь следующие характеристики:

Если mimeType "application/x-java-serialized-object; класс = <класс представления>", результатом является то же самое как вызов new DataFlavor(Class:forName(<representation class>).

Иначе:

     representationClass = InputStream
     mimeType            = mimeType
 

Параметры:

mimeType - строка, используемая, чтобы идентифицировать тип MIME для этой разновидности; если mimeType не определяет "класс =" параметр, или если класс успешно не загружается, то IllegalArgumentException бросается

humanPresentableName - удобочитаемая строка, используемая, чтобы идентифицировать эту разновидность; если этот параметр null тогда значение Тип контента MIME используется

Броски:

IllegalArgumentException - если mimeType недопустимо или если класс успешно не загружается

NullPointerException - если mimeType нуль

DataFlavor

public DataFlavor(String mimeType,
          String humanPresentableName,
          ClassLoader classLoader)
           throws ClassNotFoundException

Конструкции a DataFlavor это представляет a MimeType.

Возвращенный DataFlavor будет иметь следующие характеристики:

Если mimeType "application/x-java-serialized-object; класс = <класс представления>", результатом является то же самое как вызов new DataFlavor(Class:forName(<representation class>).

Иначе:

     representationClass = InputStream
     mimeType            = mimeType
 

Параметры:

mimeType - строка, используемая, чтобы идентифицировать тип MIME для этой разновидности

humanPresentableName - удобочитаемая строка, используемая, чтобы идентифицировать эту разновидность

classLoader - загрузчик класса, чтобы использовать

Броски:

ClassNotFoundException - если класс не загружается

IllegalArgumentException - если mimeType недопустимо

NullPointerException - если mimeType нуль

DataFlavor

public DataFlavor(String mimeType)
           throws ClassNotFoundException

Конструкции a DataFlavor от a mimeType строка. Строка может определить "класс =" параметр, чтобы создать a DataFlavor с требуемым классом представления. Если строка не содержит "класс =" параметр, java.io.InputStream используется в качестве значения по умолчанию.

Параметры:

mimeType - строка, используемая, чтобы идентифицировать тип MIME для этой разновидности; если класс, определенный "классом =" параметр, успешно не загружается, то ClassNotFoundException бросается

Броски:

ClassNotFoundException - если класс не загружается

IllegalArgumentException - если mimeType недопустимо

NullPointerException - если mimeType нуль

Деталь метода

tryToLoadClass

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

Попытки загрузить класс из: программа начальной загрузки, системный загрузчик, загрузчик контекста (если Вы присутствуете), и наконец определенный загрузчик.

Параметры:

className - имя класса, который будет загружен

fallback - загрузчик нейтрализации

Возвраты:

класс загружался

Броски:

ClassNotFoundException - если класс не находится

toString

public String toString()

Строковое представление этого DataFlavor и его параметры. Получающееся String содержит имя DataFlavor класс, тип MIME этой разновидности, и его класс представления. Если эта разновидность имеет основной тип MIME "текста", поддерживает параметр набора символов, и имеет закодированное представление, набор символов разновидности также включается. См. selectBestTextFlavor для списка текстовых разновидностей, которые поддерживают параметр набора символов.

Переопределения:

toString в классе Object

Возвраты:

строковое представление этого DataFlavor

См. Также:

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

getTextPlainUnicodeFlavor

public static final DataFlavor getTextPlainUnicodeFlavor()

Возвраты a DataFlavor представление простого текста с кодированием Unicode, где:

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

Реализация Sun для Microsoft Windows использует кодирование utf-16le. Реализация Sun для Соляриса и Linux использует кодирование iso-10646-ucs-2.

Возвраты:

a DataFlavor представление простого текста с кодированием Unicode

С тех пор:

1.3

selectBestTextFlavor

public static final DataFlavor selectBestTextFlavor(DataFlavor[] availableFlavors)

Выбирает лучший текст DataFlavor от массива DataFlavors. Только DataFlavor.stringFlavor, и эквивалентные разновидности, и разновидности, у которых есть основной тип MIME "текста", рассматривают для выбора.

Разновидности сначала сортируются их типами MIME в следующем порядке:

• "text/sgml"
• "text/xml"
• "текст/HTML"
• "text/rtf"
• "текст/обогащать"
• "текст/обогащенный текст"
• "text/uri-list"
• "text/tab-separated-values"
• "text/t140"
• "text/rfc822-headers"
• "text/parityfec"
• "текст/каталог"
• "text/css"
• "текст/календарь"
• "application/x-java-serialized-object"
• "текст/плоскость"
• "текст / <другой>"

Например, "text/sgml" будет выбран по "тексту/HTML", и DataFlavor.stringFlavor будет выбран DataFlavor.plainTextFlavor.

Если две или больше доли разновидностей, лучший MIME вводит массив, то тот тип MIME будет проверен, чтобы видеть, поддерживает ли это параметр набора символов.

Следующая поддержка типов MIME, или обрабатываются, как если бы они поддерживают, параметр набора символов:

• "text/sgml"
• "text/xml"
• "текст/HTML"
• "текст/обогащать"
• "текст/обогащенный текст"
• "text/uri-list"
• "текст/каталог"
• "text/css"
• "текст/календарь"
• "application/x-java-serialized-object"
• "текст/плоскость"

Следующие типы MIME не поддерживают, или обрабатываются, как если бы они не поддерживают, параметр набора символов:

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

Для "текста / <другие>" типы MIME, в первый раз JRE должен определить, поддерживает ли тип MIME параметр набора символов, это проверит, перечисляется ли параметр явно в произвольно выбранный DataFlavor который использует тот тип MIME. Если так, JRE примет от той точки на этом, тип MIME поддерживает параметр набора символов и не будет проверять снова. Если параметр не будет явно перечислен, то JRE примет от той точки на этом, тип MIME не поддерживает параметр набора символов и не будет проверять снова. Поскольку эта проверка выполняется на произвольно выбранный DataFlavor, разработчики должны гарантировать что все DataFlavors с "текстом / <другой>" тип MIME определяет параметр набора символов, если это поддерживается тем типом MIME. Разработчики никогда не должны полагаться на JRE, чтобы заменить набором символов платформы по умолчанию "текст / <другой>" DataFlavor. Отказ придерживаться этого ограничения приведет к неопределенному поведению.

Если лучший MIME вводит массив, не поддерживает параметр набора символов, разновидности, которые совместно используют тот тип MIME, будут тогда сортированы их классами представления в следующем порядке: java.io.InputStream, java.nio.ByteBuffer, [B, <все другие>.

Если две или больше разновидности совместно используют лучший класс представления, или если ни у какой разновидности не будет одного из трех указанных представлений, то одна из тех разновидностей будет выбрана недетерминировано.

Если лучший MIME вводит массив, действительно поддерживает параметр набора символов, разновидности, которые совместно используют тот тип MIME, будут тогда сортированы их классами представления в следующем порядке: java.io.Reader, java.lang.String, java.nio.CharBuffer, [C, <все другие>.

Если две или больше разновидности совместно используют лучший класс представления, и то представление является одним из четырех, явно перечисленных, то одна из тех разновидностей будет выбрана недетерминировано. Если, однако, ни у какой разновидности не будет одного из четырех указанных представлений, то разновидности будут тогда сортированы их наборами символов. Наборы символов Unicode, такие как "UTF-16", "UTF-8", "UTF-16BE", "UTF-16LE", и их псевдонимы, считают лучшими. После них выбираются набор символов значения по умолчанию платформы и его псевдонимы. "US-ASCII" и его псевдонимы хуже. Все другие наборы символов выбираются в алфавитном порядке, но только наборы символов, поддерживаемые этой реализацией платформы Java, рассмотрят.

Если две или больше разновидности совместно используют лучший набор символов, то разновидности будут с другой стороны сортированы их классами представления в следующем порядке: java.io.InputStream, java.nio.ByteBuffer, [B, <все другие>.

Если две или больше разновидности совместно используют лучший класс представления, или если ни у какой разновидности не будет одного из трех указанных представлений, то одна из тех разновидностей будет выбрана недетерминировано.

Параметры:

availableFlavors - массив доступных DataFlavors

Возвраты:

лучшее (самая высокая точность) разновидность согласно правилам, определенным выше, или null, если availableFlavors null, имеет нулевую длину, или не содержит текстовых разновидностей

С тех пор:

1.3

getReaderForText

public Reader getReaderForText(Transferable transferable)
                        throws UnsupportedFlavorException,
                               IOException

Получает Читателя для текстовой разновидности, декодируемой, в случае необходимости, для ожидаемого набора символов (кодирование). Поддерживаемые классы представления java.io.Reader, java.lang.String, java.nio.CharBuffer, [C, java.io.InputStream, java.nio.ByteBuffer, и [B.

Поскольку текстовые разновидности, которые не поддерживают параметр набора символов, кодируются в нестандартном формате, этот метод нельзя вызвать для таких разновидностей. Однако, чтобы поддержать прежнюю совместимость, если этот метод вызовут для такой разновидности, то этот метод обработает разновидность, как если бы это поддерживает параметр набора символов и попытку декодировать это соответственно. См. selectBestTextFlavor для списка текстовых разновидностей, которые не поддерживают параметр набора символов.

Параметры:

transferable - Transferable чьи данные будут запрошены в этой разновидности

Возвраты:

a Reader читать Transferable's данные

Броски:

IllegalArgumentException - если класс представления не является одним из этих упомянутых выше семи

IllegalArgumentException - если Transferable имеет null данные

NullPointerException - если Transferable null

UnsupportedEncodingException - если представление этой разновидности java.io.InputStream, java.nio.ByteBuffer, или [B и кодирование этой разновидности не поддерживается этой реализацией платформы Java

UnsupportedFlavorException - если Transferable не поддерживает эту разновидность

IOException - если данные не могут быть считаны из-за ошибки ввода-вывода

С тех пор:

1.3

См. Также:

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

getMimeType

public String getMimeType()

Возвращает строку типа MIME для этого DataFlavor.

Возвраты:

тип MIME представляет в виде строки для этой разновидности

getRepresentationClass

public Class<?> getRepresentationClass()

Возвраты Class который возражает поддержке этого DataFlavor возвратится когда это DataFlavor требуется.

Возвраты:

Class который возражает поддержке этого DataFlavor возвратится когда это DataFlavor требуется

getHumanPresentableName

public String getHumanPresentableName()

Возвращает человеческое презентабельное имя для формата данных что это DataFlavor представляет. Это имя было бы локализовано для разных стран.

Возвраты:

человеческое презентабельное имя для формата данных, что это DataFlavor представляет

getPrimaryType

public String getPrimaryType()

Возвращает основной тип MIME для этого DataFlavor.

Возвраты:

основной тип MIME этого DataFlavor

getSubType

public String getSubType()

Возвращает sub тип MIME этого DataFlavor.

Возвраты:

тип MIME Sub этого DataFlavor

getParameter

public String getParameter(String paramName)

Возвращает человеческое презентабельное имя для этого DataFlavor если paramName равняется "humanPresentableName". Иначе возвращает значение типа MIME, связанное с paramName.

Параметры:

paramName - название параметра требуют

Возвраты:

значение параметра имени, или null если нет никакого присваиваемого значения

setHumanPresentableName

public void setHumanPresentableName(String humanPresentableName)

Определяет человеческое презентабельное имя для формата данных что это DataFlavor представляет. Это имя было бы локализовано для разных стран.

Параметры:

humanPresentableName - новое человеческое презентабельное имя

равняется

public boolean equals(Object o)

Указывает, " ли некоторый другой объект равен" этому.

equals метод реализует отношение эквивалентности на ненулевых ссылках на объект:

• Это рефлексивно: для любого ненулевого ссылочного значения x, x.equals(x) должен возвратиться true.
• Это симметрично: для любых ненулевых ссылочных значений x и y, x.equals(y) должен возвратиться true если и только если y.equals(x) возвраты true.
• Это является переходным: для любых ненулевых ссылочных значений x, y, и z, если x.equals(y) возвраты true и y.equals(z) возвраты true, тогда x.equals(z) должен возвратиться true.
• Это является непротиворечивым: для любых ненулевых ссылочных значений x и y, многократные вызовы x.equals(y) последовательно возвращайтесь true или последовательно возвращайтесь false, предоставленный никакая информация, используемая в equals сравнения на объектах изменяются.
• Для любого ненулевого ссылочного значения x, x.equals(null) должен возвратиться false.

equals метод для класса Object реализует самое отличительное отношение эквивалентности на объектах; то есть, для любых ненулевых ссылочных значений x и y, этот метод возвраты true если и только если x и y обратитесь к тому же самому объекту (x == y имеет значение true).

Отметьте, что обычно необходимо переопределить hashCode метод всякий раз, когда этот метод переопределяется, чтобы поддержать общий контракт для hashCode метод, который утверждает, что у равных объектов должны быть равные хэш-коды.

Равняется сравнению для DataFlavor класс реализуется следующим образом: Два DataFlavors считают равными, если и только если их MIME основной тип и подтип и класс представления равен. Дополнительно, если основной тип является "текстом", подтип обозначает текстовую разновидность, которая поддерживает параметр набора символов, и класс представления не java.io.Reader, java.lang.String, java.nio.CharBuffer, или [C, charset параметр должен также быть равным. Если набор символов явно не определяется для одного или обоих DataFlavors, кодировка по умолчанию платформы принимается. См. selectBestTextFlavor для списка текстовых разновидностей, которые поддерживают параметр набора символов.

Переопределения:

equals в классе Object

Параметры:

o - Object сравниться с this

Возвраты:

true если that эквивалентно этому DataFlavor; false иначе

См. Также:

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

равняется

public boolean equals(DataFlavor that)

У этого метода есть то же самое поведение как equals(Object). Единственная разница, являющаяся этим, это берет a DataFlavor экземпляр в качестве параметра.

Параметры:

that - DataFlavor сравниться с this

Возвраты:

true если that эквивалентно этому DataFlavor; false иначе

См. Также:

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

равняется

@Deprecated
public boolean equals(String s)

Осуждаемый. Как непоследовательный с hashCode() контракт, использовать isMimeTypeEqual(String) вместо этого.

Сравнивается только mimeType против переданного в String и representationClass не рассматривается в сравнении. Если representationClass потребности, которые будут сравнены, тогда equals(new DataFlavor(s)) может использоваться.

Параметры:

s - mimeType сравниться.

Возвраты:

истина, если Строка (MimeType) равна; ложь иначе или если s null

хэш-код

public int hashCode()

Хэш-код возвратов для этого DataFlavor. Для два равный DataFlavors, хэш-коды равны. Для String это соответствует DataFlavor.equals(String), этому не гарантируют это DataFlavor's хэш-код равно хэш-коду String.

Переопределения:

hashCode в классе Object

Возвраты:

хэш-код для этого DataFlavor

См. Также:

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

соответствие

public boolean match(DataFlavor that)

Идентичный equals(DataFlavor).

Параметры:

that - DataFlavor сравниться с this

Возвраты:

true если that эквивалентно этому DataFlavor; false иначе

С тех пор:

1.3

См. Также:

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

isMimeTypeEqual

public boolean isMimeTypeEqual(String mimeType)

Возвраты, эквивалентно ли строковое представление типа MIME, который передают в, типу MIME этого DataFlavor. Параметры не включаются в сравнение.

Параметры:

mimeType - строковое представление типа MIME

Возвраты:

истина, если строковое представление типа MIME, который передают в, эквивалентно типу MIME этого DataFlavor; ложь иначе

Броски:

NullPointerException - если mimeType null

isMimeTypeEqual

public final boolean isMimeTypeEqual(DataFlavor dataFlavor)

Сравнивается mimeType из два DataFlavor объекты. Никакие параметры не рассматривают.

Параметры:

dataFlavor - DataFlavor быть сравненным

Возвраты:

истина, если MimeTypes равны, иначе ложны

isMimeTypeSerializedObject

public boolean isMimeTypeSerializedObject()

Делает DataFlavor представьте сериализированный объект?

getDefaultRepresentationClass

public final Class<?> getDefaultRepresentationClass()

getDefaultRepresentationClassAsString

public final String getDefaultRepresentationClassAsString()

isRepresentationClassInputStream

public boolean isRepresentationClassInputStream()

Делает DataFlavor представьте a java.io.InputStream?

isRepresentationClassReader

public boolean isRepresentationClassReader()

Возвраты, ли класс представления для этого DataFlavor java.io.Reader или подкласс этого.

С тех пор:

1.4

isRepresentationClassCharBuffer

public boolean isRepresentationClassCharBuffer()

Возвраты, ли класс представления для этого DataFlavor java.nio.CharBuffer или подкласс этого.

С тех пор:

1.4

isRepresentationClassByteBuffer

public boolean isRepresentationClassByteBuffer()

Возвраты, ли класс представления для этого DataFlavor java.nio.ByteBuffer или подкласс этого.

С тех пор:

1.4

isRepresentationClassSerializable

public boolean isRepresentationClassSerializable()

Возвращает true, если класс представления может быть сериализирован.

Возвраты:

истина, если класс представления может быть сериализирован

isRepresentationClassRemote

public boolean isRepresentationClassRemote()

Возвращает true, если класс представления Remote.

Возвраты:

истина, если класс представления Remote

isFlavorSerializedObjectType

public boolean isFlavorSerializedObjectType()

Возвращает true если DataFlavor определенный представляет сериализированный объект.

Возвраты:

истина, если DataFlavor определенный представляет Сериализированный Объект

isFlavorRemoteObjectType

public boolean isFlavorRemoteObjectType()

Возвращает true если DataFlavor определенный представляет удаленный объект.

Возвраты:

истина, если DataFlavor определенный представляет Удаленный объект

isFlavorJavaFileListType

public boolean isFlavorJavaFileListType()

Возвращает true если DataFlavor определенный представляет список объектов файла.

Возвраты:

истина, если DataFlavor определенный представляет Список объектов Файла

isFlavorTextType

public boolean isFlavorTextType()

Возвраты, ли это DataFlavor допустимая текстовая разновидность для этой реализации платформы Java. Только разновидности, эквивалентные DataFlavor.stringFlavor и DataFlavors с основным типом MIME "текста" могут быть допустимые текстовые разновидности.

Если эта разновидность поддерживает параметр набора символов, это должно быть эквивалентно DataFlavor.stringFlavor, или его представление должно быть java.io.Reader, java.lang.String, java.nio.CharBuffer, [C, java.io.InputStream, java.nio.ByteBuffer, или [B. Если представление java.io.InputStream, java.nio.ByteBuffer, или [B, тогда эта разновидность charset параметр должен поддерживаться этой реализацией платформы Java. Если набор символов не определяется, то набор символов значения по умолчанию платформы, который всегда поддерживается, принимается.

Если эта разновидность не поддерживает параметр набора символов, его представление должно быть java.io.InputStream, java.nio.ByteBuffer, или [B.

См. selectBestTextFlavor для списка текстовых разновидностей, которые поддерживают параметр набора символов.

Возвраты:

true если это DataFlavor допустимая текстовая разновидность как описано выше; false иначе

С тех пор:

1.4

См. Также:

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

writeExternal

public void writeExternal(ObjectOutput os)
                   throws IOException

Сериализирует это DataFlavor.

Определенный:

writeExternal в интерфейсе Externalizable

Параметры:

os - поток, чтобы записать объект в

Броски:

IOException - Включает любые исключения ввода-вывода, которые могут произойти

readExternal

public void readExternal(ObjectInput is)
                  throws IOException,
                         ClassNotFoundException

Восстановления это DataFlavor от Сериализированного состояния.

Определенный:

readExternal в интерфейсе Externalizable

Параметры:

is - поток, чтобы считать данные из того, чтобы восстановить объект

Броски:

IOException - если ошибки ввода-вывода происходят

ClassNotFoundException - Если класс для восстанавливаемого объекта не может быть найден.

клон

public Object clone()
             throws CloneNotSupportedException

Возвращает клона этого DataFlavor.

Переопределения:

clone в классе Object

Возвраты:

клон этого DataFlavor

Броски:

CloneNotSupportedException - если класс объекта не поддерживает Cloneable интерфейс. Подклассы, которые переопределяют clone метод может также выдать это исключение, чтобы указать, что экземпляр не может быть клонирован.

См. Также:

Cloneable

normalizeMimeTypeParameter

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

Осуждаемый.

Обращенный DataFlavor для каждого параметра Типа MIME, чтобы позволить DataFlavor подклассы, чтобы обработать специальные параметры как текст/плоскость charset параметры, значения которых являются нечувствительными к регистру. (Значения параметра типа MIME, как предполагается, являются чувствительными к регистру.

Этот метод вызывают для каждого названия параметра / парой значения и должен возвратить нормализованное представление parameterValue. Этот метод никогда не вызывается этой реализацией от 1.1 вперед.

normalizeMimeType

@Deprecated
protected String normalizeMimeType(String mimeType)

Осуждаемый.

Требовавшийся каждая строка типа MIME, чтобы дать DataFlavor выделяет подтипы в возможности измениться, как нормализация типов MIME выполняется. Одно возможное применение должно было бы добавить пар параметра/значения по умолчанию в случаях, где ни один не присутствует в строке типа MIME, в которой передают. Этот метод никогда не вызывается этой реализацией от 1.1 вперед.