Класс SystemFlavorMap

java.lang.Object

java.awt.datatransfer.SystemFlavorMap

Все реализуемые интерфейсы:: FlavorMap, FlavorTable

public final class SystemFlavorMap extends Object implements FlavorMap, FlavorTable

SystemFlavorMap — это настраиваемое соответствие между «нативными форматами» (строками), представляющими специфичные для платформы форматы данных, и «типами данных» (DataFlavor), представляющими независимые от платформы типы MIME. Эта связь используется подсистемой передачи данных для передачи данных между Java и нативными приложениями, а также между Java-приложениями в отдельных виртуальных машинах.

Начиная с:: 1.2

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`addFlavorForUnencodedNative(String nat, DataFlavor flav)`	Добавляет соответствие между одним нативным `String` и одним `DataFlavor`.
`void`	`addUnencodedNativeForFlavor(DataFlavor flav, String nat)`	Добавляет соответствие между указанным `DataFlavor` (и всеми `DataFlavor`, равными указанному `DataFlavor`) и указанным нативным `String`.
`static DataFlavor`	`decodeDataFlavor(String nat)`	Декодирует нативный `String` для использования в качестве `DataFlavor`.
`static String`	`decodeJavaMIMEType(String nat)`	Декодирует нативный `String` для использования в качестве типа MIME Java.
`static String`	`encodeDataFlavor(DataFlavor flav)`	Кодирует `DataFlavor` для использования в качестве нативного `String`.
`static String`	`encodeJavaMIMEType(String mimeType)`	Кодирует тип MIME для использования в качестве нативного `String`.
`static FlavorMap`	`getDefaultFlavorMap()`	Возвращает FlavorMap по умолчанию для ClassLoader текущего потока.
`List<DataFlavor>`	`getFlavorsForNative(String nat)`	Возвращает `List` из `DataFlavor`, в которые указанный нативный `String` может быть преобразован подсистемой передачи данных.
`Map<String, DataFlavor>`	`getFlavorsForNatives(String[] natives)`	Возвращает `Map`, сопоставляющую указанные нативные `String` с наиболее предпочтительным `DataFlavor`.
`List<String>`	`getNativesForFlavor(DataFlavor flav)`	Возвращает `List` из нативных `String`, в которые указанный `DataFlavor` может быть преобразован подсистемой передачи данных.
`Map<DataFlavor, String>`	`getNativesForFlavors(DataFlavor[] flavors)`	Возвращает `Map`, сопоставляющую указанные `DataFlavor` с наиболее предпочтительным нативным `String`.
`static boolean`	`isJavaMIMEType(String str)`	Возвращает значение, указывающее, является ли указанный `String` закодированным типом MIME Java.
`void`	`setFlavorsForNative(String nat, DataFlavor[] flavors)`	Удаляет текущие соответствия для указанного нативного `String` и создает новые соответствия с указанными `DataFlavor`.
`void`	`setNativesForFlavor(DataFlavor flav, String[] natives)`	Удаляет текущие соответствия для указанного `DataFlavor` и всех `DataFlavor`, равных указанному `DataFlavor`, и создает новые соответствия с указанными нативными `String`.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API планируется удалить в будущей версии. Финализация объявлена устаревшей и планируется к удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Переводит текущий поток в состояние ожидания до пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в состояние ожидания до пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в состояние ожидания до пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного времени.

Подробное описание методов

getDefaultFlavorMap

public static FlavorMap getDefaultFlavorMap()

Возвращает FlavorMap по умолчанию для ClassLoader текущего потока.

Возвращает:: FlavorMap по умолчанию для ClassLoader текущего потока

getNativesForFlavor

public List<String> getNativesForFlavor(DataFlavor flav)

Возвращает List нативных String, в которые указанный DataFlavor может быть преобразован подсистемой передачи данных. List будут упорядочены от наиболее подходящего нативного формата к наименее подходящему. Иными словами, первый нативный формат будет наиболее точно представлять данные указанного типа на базовой нативной платформе.

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

Указано в:

getNativesForFlavor в интерфейсе FlavorTable

Параметры:

flav — DataFlavor, для которого следует вернуть соответствующие нативные форматы. Если указан null, все нативные форматы, известные в данный момент подсистеме передачи данных, возвращаются в недетерминированном порядке.

Возвращает:

java.util.List объектов java.lang.String, представляющих собой специфичные для платформы представления специфичных для платформы форматов данных

Начиная с:

1.4

См. также:

getFlavorsForNative

public List<DataFlavor> getFlavorsForNative(String nat)

Возвращает List типов DataFlavor, в которые указанный нативный String может быть преобразован подсистемой передачи данных. List будут упорядочены от наиболее подходящего DataFlavor к наименее подходящему. Иными словами, первый DataFlavor будет наиболее точно представлять данные указанного нативного формата в Java-приложении.

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

Если указанный нативный формат закодирован неправильно и соответствия для него не изменялись с помощью setFlavorsForNative, содержимое List зависит от платформы, но null вернуть нельзя.

Указано в:

getFlavorsForNative в интерфейсе FlavorTable

Параметры:

nat — нативный формат, для которого следует вернуть соответствующие DataFlavor. Если указан null, все DataFlavor, известные в данный момент подсистеме передачи данных, возвращаются в недетерминированном порядке.

Возвращает:

java.util.List объектов DataFlavor, в которые могут быть преобразованы данные указанного специфичного для платформы нативного формата

Начиная с:

1.4

См. также:

getNativesForFlavors

public Map<DataFlavor, String> getNativesForFlavors(DataFlavor[] flavors)

Возвращает Map, сопоставляющую указанные DataFlavor с наиболее предпочтительным нативным String. Каждое значение нативного формата будет совпадать с первым нативным форматом в списке, возвращенном методом getNativesForFlavor для указанного типа.

Если указанный DataFlavor ранее не был известен подсистеме передачи данных, вызов этого метода установит двустороннее соответствие между указанным DataFlavor и закодированной версией его типа MIME в качестве нативного формата.

Указано в:

getNativesForFlavors в интерфейсе FlavorMap

Параметры:

flavors — массив DataFlavor, которые будут набором ключей возвращаемой Map. Если указан null, будет возвращено соответствие всех DataFlavor, известных подсистеме передачи данных, их наиболее предпочтительным нативным формам String.

Возвращает:

java.util.Map DataFlavor, сопоставляющую String нативным форматам

См. также:

getFlavorsForNatives

public Map<String, DataFlavor> getFlavorsForNatives(String[] natives)

Возвращает Map, сопоставляющую указанные нативные String с наиболее предпочтительным DataFlavor. Каждое значение DataFlavor будет совпадать с первым DataFlavor в списке, возвращенном методом getFlavorsForNative для указанного нативного формата.

Указано в:

getFlavorsForNatives в интерфейсе FlavorMap

Параметры:

natives — массив String, которые будут набором ключей возвращаемой Map. Если указан null, будет возвращено соответствие всех поддерживаемых нативных форматов String их наиболее предпочтительным DataFlavor.

Возвращает:

java.util.Map нативных String, сопоставляющую DataFlavor

См. также:

addUnencodedNativeForFlavor

public void addUnencodedNativeForFlavor(DataFlavor flav, String nat)

Добавляет соответствие между указанным DataFlavor (и всеми DataFlavor, равными указанному DataFlavor) и указанным нативным String. В отличие от getNativesForFlavor, соответствие будет установлено только в одном направлении, а нативный формат не будет закодирован. Чтобы установить двустороннее соответствие, вызовите также addFlavorForUnencodedNative. Новый вариант соответствия будет иметь более низкий приоритет, чем существующие. Этот метод ничего не делает, если соответствие указанного или равного DataFlavor указанному нативному String уже существует.

Параметры:

flav — ключ DataFlavor для соответствия

nat — значение нативного формата String для соответствия

Выбрасывает:

NullPointerException — если flav или nat равен null

Начиная с:

1.4

См. также:

setNativesForFlavor

public void setNativesForFlavor(DataFlavor flav, String[] natives)

Удаляет текущие соответствия для указанного DataFlavor и всех DataFlavor, равных указанному DataFlavor, и создает новые соответствия с указанными нативными форматами String. В отличие от getNativesForFlavor, соответствия будут установлены только в одном направлении, а нативные форматы не будут закодированы. Чтобы установить двусторонние соответствия, вызовите также setFlavorsForNative. Первый нативный формат в массиве будет соответствовать наивысшему приоритету. Последующие нативные форматы будут соответствовать постепенно снижающемуся приоритету.

Если массив содержит несколько элементов, ссылающихся на равные нативные форматы String, этот метод установит новые соответствия для первого из таких элементов и проигнорирует остальные.

Рекомендуется, чтобы клиентский код не сбрасывал соответствия, установленные подсистемой передачи данных. Этот метод следует использовать только для соответствий на уровне приложения.

Параметры:

flav — ключ DataFlavor для соответствий

natives — значения нативных форматов String для соответствий

Выбрасывает:

NullPointerException — если flav или natives равен null либо natives содержит элементы null

Начиная с:

1.4

См. также:

addFlavorForUnencodedNative

public void addFlavorForUnencodedNative(String nat, DataFlavor flav)

Добавляет соответствие между одним нативным String и одним DataFlavor. В отличие от getFlavorsForNative, соответствие будет установлено только в одном направлении, а нативный формат не будет закодирован. Чтобы установить двустороннее соответствие, вызовите также addUnencodedNativeForFlavor. Новый вариант соответствия будет иметь более низкий приоритет, чем существующие. Этот метод ничего не делает, если соответствие указанного нативного формата String указанному или равному DataFlavor уже существует.

Параметры:

nat — ключ нативного формата String для соответствия

flav — значение DataFlavor для соответствия

Выбрасывает:

NullPointerException — если nat или flav равен null

Начиная с:

1.4

См. также:

setFlavorsForNative

public void setFlavorsForNative(String nat, DataFlavor[] flavors)

Удаляет текущие соответствия для указанного нативного String и создает новые соответствия с указанными DataFlavor. В отличие от getFlavorsForNative, соответствия будут установлены только в одном направлении, и кодировать нативные форматы необязательно. Чтобы установить двусторонние соответствия, вызовите также setNativesForFlavor. Первый DataFlavor в массиве будет соответствовать наивысшему приоритету. Последующие DataFlavor будут соответствовать постепенно снижающемуся приоритету.

Если массив содержит несколько элементов, ссылающихся на равные DataFlavor, этот метод установит новые соответствия для первого из таких элементов и проигнорирует остальные.

Параметры:

nat — ключ нативного формата String для соответствий

flavors — значения DataFlavor для соответствий

Выбрасывает:

NullPointerException — если nat или flavors равен null либо если flavors содержит элементы null

Начиная с:

1.4

См. также:

encodeJavaMIMEType

public static String encodeJavaMIMEType(String mimeType)

Кодирует тип MIME для использования в качестве нативного формата String. Формат закодированного представления типа MIME зависит от реализации. Единственные ограничения:

Закодированное представление равно null тогда и только тогда, когда тип MIME String равен null
Закодированные представления двух типов MIME String, не являющихся null, равны тогда и только тогда, когда эти String равны согласно String.equals(Object)

Эталонная реализация этого метода возвращает указанный тип MIME String с префиксом JAVA_DATAFLAVOR:.

Параметры:: mimeType — кодируемый тип MIME
Возвращает:: закодированный String или null, если mimeType равен null

encodeDataFlavor

public static String encodeDataFlavor(DataFlavor flav)

Кодирует DataFlavor для использования в качестве нативного формата String. Формат закодированного DataFlavor зависит от реализации. Единственные ограничения:

Закодированное представление равно null тогда и только тогда, когда указанный DataFlavor равен null или его тип MIME String равен null
Закодированные представления двух DataFlavor, не являющихся null, с типами MIME String, не являющимися null, равны тогда и только тогда, когда типы MIME String этих DataFlavor равны согласно String.equals(Object)

Эталонная реализация этого метода возвращает тип MIME String указанного DataFlavor с префиксом JAVA_DATAFLAVOR:.

Параметры:: flav — кодируемый DataFlavor
Возвращает:: закодированный String или null, если flav равен null либо имеет тип MIME null

isJavaMIMEType

public static boolean isJavaMIMEType(String str)

Возвращает значение, указывающее, является ли указанный String закодированным типом MIME Java.

Параметры:: str — проверяемый String
Возвращает:: true, если String закодирован; в противном случае — false

decodeJavaMIMEType

public static String decodeJavaMIMEType(String nat)

Декодирует нативный String для использования в качестве типа MIME Java.

Параметры:: nat — декодируемый String
Возвращает:: декодированный тип MIME Java или null, если nat не является закодированным нативным String

decodeDataFlavor

public static DataFlavor decodeDataFlavor(String nat) throws ClassNotFoundException

Декодирует нативный String для использования в качестве DataFlavor.

Параметры:: nat — декодируемый String
Возвращает:: декодированный DataFlavor или null, если nat не является закодированным нативным String
Выбрасывает:: ClassNotFoundException — если класс типа данных не загружен

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.