Класс SystemFlavorMap

java.lang.Object

java.awt.datatransfer.SystemFlavorMap

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

public final class SystemFlavorMap extends Object implements FlavorMap, FlavorTable

Класс SystemFlavorMap представляет собой настраиваемое отображение между "нативными" (строками), соответствующими платформ-специфичным форматам данных, и "флейворами" (DataFlavors), соответствующими платформ-независимым типам 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` для использования в качестве Java-типа MIME.
`static String`	`encodeDataFlavor(DataFlavor flav)`	Кодирует `DataFlavor` для использования в качестве нативного `String`.
`static String`	`encodeJavaMIMEType(String mimeType)`	Кодирует тип MIME для использования в качестве нативного `String`.
`static FlavorMap`	`getDefaultFlavorMap()`	Возвращает стандартное отображение FlavorMap для загрузчика классов текущей нити.
`List<DataFlavor>`	`getFlavorsForNative(String nat)`	Возвращает набор `List` `DataFlavor`, к которым подсистема передачи данных может перевести указанный нативный `String`.
`Map<String, DataFlavor>`	`getFlavorsForNatives(String[] natives)`	Возвращает отображение указанных нативных `String` в их предпочтительные `DataFlavor`.
`List<String>`	`getNativesForFlavor(DataFlavor flav)`	Возвращает набор `List` `String`, к которым подсистема передачи данных может перевести указанный `DataFlavor`.
`Map<DataFlavor, String>`	`getNativesForFlavors(DataFlavor[] flavors)`	Возвращает отображение указанных `DataFlavor` в их предпочтительные нативные `String`.
`static boolean`	`isJavaMIMEType(String str)`	Возвращает, является ли указанный `String` закодированным Java-типом MIME.
`void`	`setFlavorsForNative(String nat, DataFlavor[] flavors)`	Удаляет текущие отображения для указанного нативного `String` и создаёт новые отображения для указанных `DataFlavor`.
`void`	`setNativesForFlavor(DataFlavor flav, String[] natives)`	Удаляет текущие отображения для указанного `DataFlavor` и всех `DataFlavor`, равных указанному `DataFlavor`, и создаёт новые отображения для указанных нативных `String`.

Методы, унаследованные от класса java.lang.Object

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

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

getDefaultFlavorMap

public static FlavorMap getDefaultFlavorMap()

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

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

getNativesForFlavor

public List<String> getNativesForFlavor(DataFlavor flav)

Возвращает список нативных представлений, в которые можно преобразовать указанный объект DataFlavor с помощью подсистемы передачи данных. Список отсортирован от лучшего к худшему представлению. То есть, первое нативное представление лучше всего отображает данные в указанном формате на платформе.

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

Определено в:

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

Параметры:

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

Возвращает:

список нативных объектов, представляющих платформозависимые форматы данных

С:

1.4

См. также:

getFlavorsForNative

public List<DataFlavor> getFlavorsForNative(String nat)

Возвращает список объектов DataFlavor, в которые можно преобразовать указанное нативное представление с помощью подсистемы передачи данных. Список отсортирован от лучшего к худшему соответствию. То есть, первый DataFlavor лучше всего отобразит данные из указанного нативного представления в Java-приложение.

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

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

Определено в:

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

Параметры:

nat - нативное представление, для которого должны быть возвращены соответствующие DataFlavors. Если null указан, все известные подсистеме передачи данных DataFlavors будут возвращены в произвольном порядке.

Возвращает:

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

С:

1.4

См. также:

getNativesForFlavors

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

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

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

Определено в:

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

Параметры:

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

Возвращает:

список соответствий DataFlavors к нативным представлениям

См. также:

getFlavorsForNatives

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

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

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

Определено в:

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

Параметры:

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

Возвращает:

список соответствий нативных представлений к DataFlavors

См. также:

addUnencodedNativeForFlavor

public void addUnencodedNativeForFlavor(DataFlavor flav, String nat)

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

Параметры:

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

nat - нативное значение для соответствия

Исключения:

NullPointerException - если flav или nat имеют null значение

С:

1.4

См. также:

setNativesForFlavor

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

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

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

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

Параметры:

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

natives - нативные значения для соответствий

Исключения:

NullPointerException - если flav или natives имеют null значение или если natives содержит null элементы

С:

1.4

См. также:

addFlavorForUnencodedNative

public void addFlavorForUnencodedNative(String nat, DataFlavor flav)

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

Parameters:

nat - ключ String нативного элемента для отображения

flav - значение DataFlavor для отображения

Throws:

NullPointerException - если nat или flav является null

Since:

1.4

See Also:

setFlavorsForNative

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

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

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

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

Parameters:

nat - ключ String нативного элемента для отображений

flavors - значения DataFlavor для отображений

Throws:

NullPointerException - если nat или flavors является null или если flavors содержит null элементов

Since:

1.4

See Also:

encodeJavaMIMEType

public static String encodeJavaMIMEType(String mimeType)

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

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

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

Parameters:: mimeType - тип MIME для кодирования
Returns:: закодированный String, или null, если mimeType является null

encodeDataFlavor

public static String encodeDataFlavor(DataFlavor flav)

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

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

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

Parameters:: flav - DataFlavor для кодирования
Returns:: закодированный String, или null, если flav является null или имеет тип MIME null

isJavaMIMEType

public static boolean isJavaMIMEType(String str)

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

Parameters:: str - String для проверки
Returns:: true, если String закодирован; false в противном случае

decodeJavaMIMEType

public static String decodeJavaMIMEType(String nat)

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

Parameters:: nat - String для декодирования
Returns:: декодированный тип MIME Java, или null, если nat не является закодированным String нативным элементом

decodeDataFlavor

public static DataFlavor decodeDataFlavor(String nat) throws ClassNotFoundException

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

Parameters:: nat - String для декодирования
Returns:: декодированный DataFlavor, или null, если nat не является закодированным String нативным элементом
Throws:: 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://download.java.net/java/early_access/jdk24/docs/api/java.datatransfer/java/awt/datatransfer/SystemFlavorMap.html