Класс 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 для использования в качестве MIME-типа Java.
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 закодированным 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 для ClassLoader текущего потока.

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

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 для указанного нативного представления.

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

Определено в:
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 (и всех DataFlavor равных указанному 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 и всех DataFlavor равных указанному 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 нативного типа и создаёт новые сопоставления для указанных DataFlavor. В отличие от getFlavorsForNative, сопоставления будут установлены только в одном направлении, а нативные типы не нуждаются в кодировании. Для установки двунаправленных сопоставлений также вызовите setNativesForFlavor. Первый DataFlavor в массиве будет представлять сопоставление с наивысшим приоритетом. Последующие DataFlavor будут представлять сопоставления с уменьшающимся приоритетом.

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

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

Параметры:
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 или имеет тип MIME null

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

Spec-Zone .ru
спецификации, руководства, описания, API