Класс 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

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

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.datatransfer/java/awt/datatransfer/SystemFlavorMap.html