Spec-Zone.ru › OpenJDK 17

Класс 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 для загрузчика классов текущей нити.
List<DataFlavor> getFlavorsForNative(String nat)
Возвращает список List DataFlavor к которым подсистема передачи данных может перевести указанный String нативный объект.
Map<String,DataFlavor> getFlavorsForNatives(String[] natives)
Возвращает список указанных String нативных объектов и их наиболее предпочтительных DataFlavor.
List<String> getNativesForFlavor(DataFlavor flav)
Возвращает список 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 для загрузчика классов текущего потока.
Возвращает:
стандартную 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 из DataFlavors в String нативные представления
См. также:
  • getNativesForFlavor(java.awt.datatransfer.DataFlavor)
  • encodeDataFlavor(java.awt.datatransfer.DataFlavor)

getFlavorsForNatives

public Map<String,DataFlavor> getFlavorsForNatives(String[] natives)
Возвращает Map из указанных String нативных представлений в их наиболее предпочтительные DataFlavor. Каждое значение формата будет таким же, как первое значение формата в списке, возвращаемом getFlavorsForNative для указанного нативного представления.

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

Определено в:
getFlavorsForNatives в интерфейсе FlavorMap
Параметры:
natives - массив Strings, которые будут набором ключей возвращаемого Map. Если null указан, будет возвращена карта всех поддерживаемых String нативных представлений и их наиболее предпочтительных DataFlavor форматов.
Возвращает:
a java.util.Map из String нативных представлений в DataFlavor форматы
См. также:
  • 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 ключи, этот метод установит новые сопоставления для первого из этих элементов и проигнорирует остальные.

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

Parameters:
nat - нативный ключ для сопоставлений
flavors - значения для сопоставлений
Throws:
NullPointerException - если nat или flavors null, или если flavors содержит null элементов
Since:
1.4
See Also:
  • setNativesForFlavor(java.awt.datatransfer.DataFlavor, java.lang.String[])

encodeJavaMIMEType

public static String encodeJavaMIMEType(String mimeType)
Кодирует тип MIME для использования в качестве String нативного ключа. Формат кодированного представления типа MIME зависит от реализации. Единственные ограничения:
  • Кодированное представление является null тогда и только тогда, когда тип MIME String является null
  • Кодированные представления для двух типов MIME, не являющихся null, 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, 2021, 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/17/docs/api/java.datatransfer/java/awt/datatransfer/SystemFlavorMap.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API