Класс 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)` Возвращает `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` нативным значениям.

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

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

Методы

getDefaultFlavorMap

public static FlavorMap getDefaultFlavorMap()

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

getNativesForFlavor

public List<String> getNativesForFlavor(DataFlavor flav)

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

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

Определено в:: getNativesForFlavor в интерфейсе FlavorTable
Параметры:: flav - DataFlavor, соответствующие нативные представления которого требуется вернуть. Если null указан, все нативные представления, известные подсистеме передачи данных, будут возвращены в произвольном порядке.
Возвращает:: a java.util.List java.lang.String объектов, представляющих платформозависимые представления платформозависимых форматов данных
С:: 1.4
См. также:: encodeDataFlavor(java.awt.datatransfer.DataFlavor)

getFlavorsForNative

public List<DataFlavor> getFlavorsForNative(String nat)

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

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

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

Определено в:: getFlavorsForNative в интерфейсе FlavorTable
Параметры:: nat - нативное представление, соответствующие DataFlavors которого необходимо вернуть. Если null указан, все DataFlavors, известные подсистеме передачи данных, будут возвращены в произвольном порядке.
Возвращает:: a java.util.List DataFlavor объектов, в которые можно преобразовать платформозависимые данные в указанном платформозависимом нативном формате
С:: 1.4
См. также:: encodeJavaMIMEType(java.lang.String)

getNativesForFlavors

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

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

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

Определено в:: getNativesForFlavors в интерфейсе FlavorMap
Параметры:: flavors - массив DataFlavors, которые будут набором ключей возвращаемого Map. Если null указан, будет возвращено отображение всех DataFlavors, известных подсистеме передачи данных, к их наиболее предпочтительным String нативным представлениям.
Возвращает:: a java.util.Map DataFlavor к String нативным представлениям
См. также:: getNativesForFlavor(java.awt.datatransfer.DataFlavor), encodeDataFlavor(java.awt.datatransfer.DataFlavor)

getFlavorsForNatives

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

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

Определено в:: getFlavorsForNatives в интерфейсе FlavorMap
Параметры:: natives - массив Strings, которые будут набором ключей возвращаемого Map. Если null указан, будет возвращено отображение всех поддерживаемых String нативных представлений к их наиболее предпочтительным DataFlavors.
Возвращает:: a java.util.Map String нативных представлений к DataFlavors
См. также:: getFlavorsForNative(java.lang.String), encodeJavaMIMEType(java.lang.String)

addUnencodedNativeForFlavor

public void addUnencodedNativeForFlavor(DataFlavor flav,
                                        String nat)

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

Параметры:: flav - ключ DataFlavor для соответствия; nat - значение String нативного представления для соответствия
Исключения:: NullPointerException - если flav или nat null
С:: 1.4
См. также:: addFlavorForUnencodedNative(java.lang.String, java.awt.datatransfer.DataFlavor)

setNativesForFlavor

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

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

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

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

Параметры:: flav - ключ DataFlavor для соответствий; natives - значения String нативных представлений для соответствий
Исключения:: NullPointerException - если flav или natives null или если natives содержит null элементов
С:: 1.4
См. также:: setFlavorsForNative(java.lang.String, java.awt.datatransfer.DataFlavor[])

addFlavorForUnencodedNative

public void addFlavorForUnencodedNative(String nat,
                                        DataFlavor flav)

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

Параметры:: nat - ключ String нативного представления для соответствия; flav - значение DataFlavor формата для соответствия
Исключения:: NullPointerException - если nat или flav null
С:: 1.4
См. также:: addUnencodedNativeForFlavor(java.awt.datatransfer.DataFlavor, java.lang.String)

setFlavorsForNative

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

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

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

Параметры:: nat - String родной ключ для сопоставлений; flavors - DataFlavor значения для сопоставлений
Исключения:: NullPointerException - если nat или flavors null или если flavors содержит null элементы
С тех пор:: 1.4
См. также:: setNativesForFlavor(java.awt.datatransfer.DataFlavor, java.lang.String[])

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:.

Параметры:: mimeType - тип MIME для кодирования
Возвращает:: закодированный 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:.

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

isJavaMIMEType

public static boolean isJavaMIMEType(String str)

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

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

decodeJavaMIMEType

public static String decodeJavaMIMEType(String nat)

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

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

decodeDataFlavor

public static DataFlavor decodeDataFlavor(String nat)
                                   throws ClassNotFoundException

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

Параметры:: nat - String для декодирования
Возвращает:: декодированный DataFlavor, или null если nat не является закодированным String родным ключом
Исключения:: ClassNotFoundException

© 1993, 2020, 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.